迁移前需核对PHP版本与扩展、MySQL字符集、Web服务器配置及敏感文件权限。PHP缺扩展导致Fatal error;mysqldump须带--single-transaction和--default-character-set=utf8mb4;.env、storage/、uploads/需重配或同步;Nginx/Apache伪静态与资源路径须匹配新环境。

备份前先确认 PHP 版本和扩展是否一致
直接拷贝代码跑不起来,八成是 php -v 或 php -m 对不上。A 服务器用的是 PHP 7.4 + gd、mbstring、pdo_mysql,B 服务器缺一个扩展,require 就报 Fatal error: Uncaught Error: Call to undefined function mb_strlen()。
- 在 A 服务器执行:
php -v、php -m | grep -E "(gd|mbstring|pdo|curl|openssl|json)" - 在 B 服务器执行同样命令,逐项比对;差异项用
apt install php-mbstring(Debian/Ubuntu)或yum install php-mbstring(CentOS)补全 - 注意:PHP-FPM 配置(如
www.conf中的user、listen、pm设置)也要同步,否则 502 错误高发
数据库导出必须带字符集和创建语句
用 mysqldump 直接裸导,迁过去发现中文变问号、表结构丢掉 ENGINE=InnoDB DEFAULT CHARSET=utf8mb4,是因为没锁表也没指定编码。
- 安全导出命令:
mysqldump --single-transaction --routines --triggers --set-gtid-purged=OFF --default-character-set=utf8mb4 -u root -p database_name > backup.sql - 导入前先确认 B 服务器 MySQL 的
character_set_server和collation_server是utf8mb4,否则建库时加DEFAULT CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci - 如果用了 Laravel 的
migrations表,别漏掉;有自定义函数或存储过程的,--routines参数不能省
Web 根目录外的敏感文件必须单独处理
vendor/ 可以重装,但 .env、storage/ 下的 session/logs、public/uploads/ 这些不会进 Git,一删就丢数据。
-
.env文件:绝不能从 A 直接复制到 B —— 数据库密码、APP_KEY、第三方密钥都得按 B 环境重配;先用php artisan key:generate(Laravel)或wp config create(WordPress)生成新密钥 -
storage/和public/uploads/:用rsync -avz --progress /path/to/storage/ user@B:/path/to/storage/同步,注意权限 —— Web 用户(如www-data)必须有写权限,chmod -R 755 storage/不够,得chown -R www-data:www-data storage/ - 检查
opcache.enable和realpath_cache_size是否开启,线上建议开,但迁移后首次访问要清一次 opcache(phpctl reload或调用opcache_reset())
上线前必须验证路由和静态资源路径
Nginx/Apache 配置稍有不同,https://b.example.com/admin 404,大概率是伪静态规则没跟上,或者 public/ 没设成 root。
立即学习“PHP免费学习笔记(深入)”;
- Laravel:Nginx 配置中
root必须指向/var/www/html/public,不是项目根目录;重写规则用try_files $uri $uri/ /index.php?$query_string; - ThinkPHP:Apache 要确保
.htaccess生效,且AllowOverride All已启用;Nginx 则需手动配置 PATH_INFO 支持 - 静态资源(CSS/JS)404?检查
ASSET_URL或APP_URL是否写死为 A 服务器域名;前端构建产物里的绝对路径也得重新npm run build -- --base=/
环境变量、文件权限、OPcache 缓存这三处最容易在凌晨上线时突然报错,动手前花五分钟扫一遍,比重启三次服务省时间。











