宝塔迁移 PHP 项目完整环境重建配置步骤-php教程-PHP中文网

必须严格对齐原环境的PHP版本、扩展、Nginx规则、权限及.env配置，否则90%问题源于隐性配置差异：如PHP 8.2移除mysql_connect、fileinfo缺失致Laravel报错、运行目录未设/public致敏感路径暴露、伪静态未适配框架路由机制、.env未隔离导致安全泄露、MySQL 8.0认证插件不兼容、OPcache残留使新配置失效。

宝塔迁移 php 项目完整环境重建配置步骤

直接迁移 PHP 项目到新服务器时，只复制代码和数据库远远不够——宝塔面板的环境配置（PHP 版本、扩展、Nginx 规则、权限、.env 文件）必须严格对齐原环境，否则 90% 的问题出在「看似一样，实则不同」的隐性配置上。

确认原服务器 PHP 版本与扩展是否完全一致

很多迁移失败是因为新版 PHP 默认禁用某些函数或扩展行为变更。比如 PHP 8.2 中 mysql_connect() 已彻底移除，而老项目若没用 mysqli 或 pdo_mysql 就会白屏；又如 fileinfo 缺失会导致 Laravel 的 Storage::put() 报错。

登录原服务器宝塔 → 软件商店 → 已安装 → 找到对应 PHP 版本 → 点击「设置」→ 「安装扩展」，逐项核对勾选项：必含 fileinfo、pdo_mysql、mbstring、openssl、curl，框架专用扩展如 redis（Laravel/TP6）、gmp（加密类项目）也不能漏
在「禁用函数」页检查是否手动删了 exec、shell_exec 等——若原项目依赖这些（如调用 FFmpeg 或 Composer 命令），新环境必须同步放开
对比 php.ini 关键参数：upload_max_filesize、post_max_size、max_execution_time，尤其上传大文件或导出报表类项目，数值不一致会直接卡死

宝塔新建站点默认把整个项目目录设为根目录，但 Laravel/ThinkPHP/Symfony 等现代框架要求 Web 入口仅暴露 public 子目录，否则 .env、config/、app/ 等敏感路径可能被直接访问。

进入新站点设置 → 「基本」→ 「运行目录」：Laravel 必填 /public，ThinkPHP 6 填 /public 或留空（取决于部署方式），WordPress 可留空
同时检查「网站目录」是否指向正确路径，例如 /www/wwwroot/myapp，而非 /www/wwwroot/myapp/public —— 后者会导致 Nginx 找不到 index.php
若用宝塔「一键部署」创建站点，它可能自动把 public 当作根目录，此时需手动将项目整体移回上级目录，并修正运行目录，否则后续伪静态规则全部失效

伪静态规则不能靠“选模板”，得看框架真实路由机制

宝塔伪静态下拉菜单里的 thinkphp 或 laravel 规则只是通用模板，实际生效依赖 Nginx 是否启用 try_files 和 PATH_INFO 支持。常见错误是规则粘贴了但路由 404，本质是 fastcgi_param SCRIPT_FILENAME 指向错误或未开启 pathinfo。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

Laravel 推荐用 Nginx 原生 try_files 规则（比 PATH_INFO 更稳定）：
```
location / {<br>    try_files $uri $uri/ /index.php?$query_string;<br>}
```
并确保 location ~ \.php$ 块中包含 include fastcgi.conf;
ThinkPHP 6 若用 url 模式（非 pathinfo），伪静态必须匹配其 rewrite 规则，且 PHP 设置中要开启 enable_pathinfo = 1（在 PHP 设置 → 配置修改里搜索并取消注释）
切勿在「伪静态」栏直接粘贴 Apache 的 .htaccess 内容——Nginx 不识别 RewriteRule，会静默忽略导致路由全挂

数据库与 .env 文件的权限和内容必须隔离处理

.env 是迁移中最容易出安全问题的环节：直接从旧服务器复制过来，里面可能含测试数据库密码、Redis 地址、阿里云 AK/SK，一旦被 Nginx 错误暴露，等于交出服务器控制权。

上传后立即检查 .env 文件权限：应为 644（不可执行），且所在目录不能被 Web 服务直接列出（宝塔默认已禁用目录浏览，但仍建议在「网站设置 → 目录保护」中添加 .env 到禁止访问列表）
.env 中的 DB_HOST 必须改为 127.0.0.1（不是 localhost），否则 MySQL 8.0+ 默认走 socket 连接，在宝塔环境下常因 socket 路径不对而连不上
数据库导入后，立刻进 phpMyAdmin 或命令行执行：ALTER USER 'your_user'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password'; —— MySQL 8.0 默认的 caching_sha2_password 插件，PHP 7.4 以下版本原生不支持