PHP项目迁移必备备份内容详解

PHP项目迁移远不止简单复制代码，稍有疏忽就会触发Fatal error、中文乱码、502网关错误或静态资源404等线上事故；本文直击迁移核心痛点——从PHP版本与扩展精准比对、带事务与utf8mb4编码的安全数据库导出、.env与storage/uploads等敏感文件的权限级同步，到Web服务器伪静态配置、OPcache清理及环境变量校验，提供一套开箱即用的避坑清单，帮你把凌晨三点的救火变成一次平稳上线。

备份前先确认 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。

• 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 缓存这三处最容易在凌晨上线时突然报错，动手前花五分钟扫一遍，比重启三次服务省时间。

今天关于《PHP项目迁移必备备份内容详解》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！