PHP在Linux上迁移指南

作者：技术拾光时间：2026-07-21 07:53:09浏览：144

迁移PHP应用需先备份网站文件、配置和数据库，再检查目标服务器环境并搭建匹配的PHP及Web服务器。通过scp或rsync迁移文件，导入数据库，调整权限和连接配置，最后进行功能测试与日志排查以确保迁移成功。

迁移PHP应用这事儿，说难不难，说简单也不简单。关键是步骤得捋清楚，别漏了关键环节。下面我把整个过程拆解成几个核心阶段，从准备到收尾，一步步说透。

一、迁移前的准备工作

PHP在Linux上迁移指南

动手之前，先别急着搬。有两件事必须做扎实：备份现有环境和检查目标服务器。别嫌麻烦，这两步做好了，后面能省下大把排错的时间。

1. 备份现有环境

对源服务器上的所有关键数据，得来个“全家桶”式的完整备份。具体包括三大块：

网站文件：用tar命令把Web根目录（比如/var/www/html）打包成一个压缩包。命令示例：sudo tar -czvf php_files_backup.tar.gz /var/www/html。这一步是为了确保文件结构和权限不丢失。
PHP配置文件：/etc/php目录下的所有文件，包括php.ini和各扩展的配置，都得单独复制到备份路径。这些配置细节往往是性能调优的关键。
数据库：通过mysqldump（针对MySQL）或pg_dumpall（针对PostgreSQL），把所有数据库导出一个SQL文件。比如：sudo mysqldump -u root -p --all-databases > all_databases.sql。这是整个备份的核心，数据库丢了，应用就废了。

2. 检查目标服务器环境

接下来，还得检查一下目标服务器的“底子”：

确认目标Linux服务器（比如CentOS、Debian）的操作系统版本，与源服务器兼容。版本差异太大，可能带来依赖兼容性问题。
安装必要的基础软件：Web服务器（Nginx或Apache）、数据库（MySQL）、PHP核心及其扩展。尤其要注意，PHP版本必须与源环境保持一致（比如都是PHP 7.4或8.0）。版本不一致，很可能会导致语法兼容或函数废弃的问题。

二、目标服务器环境搭建

环境搭好了，才能把“家底”搬进去。这一步有两个重点：安装PHP和配置Web服务器。

1. 安装PHP及相关组件

根据目标服务器的包管理器来操作。以Debian/Ubuntu为例，安装PHP及常用扩展的命令很直接：

sudo apt update
sudo apt install php php-cli php-fpm php-mysql php-curl php-gd php-mbstring php-xml php-zip

如果项目需要特定PHP版本（比如PHP 8.1），可以通过添加第三方仓库（如Remi repo）或直接源码编译安装。具体方法取决于你的发行版和版本需求。

2. 配置Web服务器

这里是两种主流Web服务器的配置要点，大家可以按需选择。

如果选Nginx：

创建站点配置文件，比如放在/etc/nginx/sites-a vailable/yourproject。核心配置长这样：

server {
    listen 80;
    server_name yourdomain.com;
    root /var/www/yourproject/public;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php8.1-fpm.sock; # 根据实际PHP版本调整
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }

    location ~ /\.ht {
        deny all;
    }
}

然后启用配置：sudo ln -s /etc/nginx/sites-a vailable/yourproject /etc/nginx/sites-enabled/，最后重启Nginx：sudo systemctl restart nginx。

如果选Apache：

先启用必要的PHP模块：sudo a2enmod proxy_fcgi setenvif。
修改虚拟主机配置，添加PHP处理指令：


    SetHandler "proxy:fcgi://unix:/var/run/php/php8.1-fpm.sock"

重启Apache：sudo systemctl restart apache2。

三、迁移核心数据

环境搭好了，接下来就是把“家当”搬过去。这一步分成两个子任务：网站文件和数据库。

1. 迁移网站文件

使用scp或rsync，将源服务器上备份的网站文件复制到目标服务器的Web根目录（比如/var/www/yourproject）。scp的命令示例：

scp -r user@source_server:/var/www/html/* /var/www/yourproject/

文件复制完成后，必须调整权限。确保Web服务器用户（通常是www-data）对这些文件有读写权限：

sudo chown -R www-data:www-data /var/www/yourproject
sudo chmod -R 755 /var/www/yourproject/storage  # 如果项目有storage目录，需要单独设置

2. 迁移数据库

把之前备份的SQL文件先复制到目标服务器：

scp all_databases.sql user@target_server:/tmp/

然后在目标服务器上导入数据库：

# MySQL导入
mysql -u root -p < /tmp/all_databases.sql

# PostgreSQL导入
psql -U postgres -f /tmp/all_databases.sql

导入完成后，别忘了检查项目的数据库连接配置文件（比如config/database.php）。确保其中的用户名、密码、数据库名与目标服务器上的一致。这里出问题，应用就完全连不上。

四、测试与验证

数据搬完了，别急着关旧服务器。先做两件事验证一下：功能测试和日志排查。

1. 功能测试

通过浏览器直接访问目标服务器的域名或IP，逐项检查：

网站首页能否正常打开。
核心功能是否正常，比如表单提交、数据库交互、文件上传。
查看页面源代码，确认PHP代码已经正确解析，没有暴露原始代码。如果看到标签，说明解析有问题。

2. 日志排查

如果遇到错误，第一时间翻日志：

Web服务器错误日志：Nginx在/var/log/nginx/error.log，Apache在/var/log/apache2/error.log。
PHP-FPM日志：一般在/var/log/php8.1-fpm.log（版本号按实际调整）。

常见问题包括权限不足、配置错误、扩展缺失等。逐条定位、修复即可。

五、收尾工作

验证通过后，就可以做最后的收尾了。三件事要处理：DNS更新、旧环境清理、以及优化与监控。

1. 更新DNS解析

登录域名管理后台，将域名的A记录（或CNAME记录）指向目标服务器的IP地址。DNS生效时间从几分钟到24小时不等，取决于你的域名服务商和TTL设置。建议设置一个较低的TTL值，以加快切换速度。

2. 清理旧环境

确认新环境运行稳定后，就可以删除源服务器上的备份数据了（比如php_files_backup.tar.gz、all_databases.sql）。这些临时文件占用空间，清理后能释放存储。

3. 优化与监控

最后，别忘了给新环境做些“保健”工作：

开启PHP OPcache：修改php.ini，将opcache.enable设为1。这能显著提升代码执行速度，尤其对于大型项目。
配置防火墙：确保防火墙允许HTTP（80端口）和HTTPS（443端口）的流量。
定期备份与监控告警：设置定时备份任务，同时配置监控告警（比如服务器负载、磁盘空间使用情况），确保问题能第一时间被发现。