Ubuntu中PHP兼容旧版本的解决方案

在Ubuntu系统中处理PHP版本的兼容性问题，常常让运维人员感到头疼。项目运行多年、依赖老旧框架，或是某些商业组件仅支持特定版本，这些情况屡见不鲜。实际上，解决思路并不复杂，核心在于实现多版本共存与环境隔离，让每个旧项目都能找到适配的运行环境。下面详细介绍具体步骤。

1. 添加旧版本PHP的PPA源

Ubuntu官方仓库中的PHP版本更新很快，但几乎不会保留对旧版本的长期支持。幸运的是，社区提供了可靠的第三方PPA源来解决这个问题。Ondřej Surý维护的PPA是目前应用最广泛的，它覆盖了从PHP 5.6开始的大部分历史版本，已成为行业内的标准选择。

sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update

执行以上命令即可一键开启老版本PHP的安装入口。

2. 安装所需的旧版PHP

添加源之后，就可以按需安装任意旧版本了。以PHP 5.6和PHP 7.1为例，务必同时安装CLI和FPM组件：CLI用于命令行脚本执行，FPM则负责与Web服务器协作。

# 安装PHP 5.6及常用扩展
sudo apt install php5.6 php5.6-cli php5.6-fpm php5.6-mysql php5.6-curl php5.6-gd php5.6-mbstring

# 安装PHP 7.1及常用扩展
sudo apt install php7.1 php7.1-cli php7.1-fpm php7.1-mysql php7.1-curl php7.1-gd php7.1-mbstring

这些扩展基本覆盖了旧项目的常见依赖，如果项目需要php5.6-mcrypt这类较老的扩展，还需单独指定安装。

3. 切换PHP CLI版本

安装完成后，可通过update-alternatives工具自由切换命令行默认PHP版本，将其指向你需要的旧版本。

# 将PHP 5.6设为默认版本
sudo update-alternatives --set php /usr/bin/php5.6

# 验证版本切换
php -v

配置完毕后，命令行中的PHP即为旧版本，运行脚本时更加稳定可靠。

4. 切换Web服务器使用的PHP版本

命令行调整完成后，Web服务器的配置才是关键，因为用户实际访问的是网站而非终端。

Apache服务器

Apache的切换操作非常直接，通过a2dismod和a2enmod命令禁用新版PHP模块并启用旧版，然后重启服务即可。

sudo a2dismod php7.1
sudo a2enmod php5.6
sudo systemctl restart apache2

Nginx服务器

Nginx的处理方式有所不同：它不直接集成PHP模块，而是通过PHP-FPM转发请求。你需要修改站点配置中的fastcgi_pass指令，将其指向对应版本的FPM socket。

location ~ .php$ {
    fastcgi_pass unix:/run/php/php5.6-fpm.sock;
    fastcgi_index index.php;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}

修改配置后别忘记重启Nginx：

sudo systemctl restart nginx

5. 使用phpbrew管理多版本

如果觉得系统级别的版本切换不够灵活，可以尝试phpbrew。这是一个用户态工具，允许你在个人目录下安装多个PHP版本，互不干扰，也不会影响全局环境。特别适合需要同时维护多个旧项目的场景。

# 安装phpbrew
curl -L -O https://github.com/phpbrew/phpbrew/raw/master/phpbrew
sudo mv phpbrew /usr/local/bin/phpbrew
chmod +x /usr/local/bin/phpbrew

# 初始化phpbrew
echo '[[ -e ~/.phpbrew/bashrc ]] && source ~/.phpbrew/bashrc' >> ~/.bashrc
source ~/.bashrc

# 安装旧版本PHP（如5.6）
phpbrew install 5.6 +default

# 切换到指定版本
phpbrew switch php-5.6

# 验证当前版本
php -v

6. 测试兼容性

所有配置完成后，务必从多个角度进行验证，确保切换未引发问题。

• 命令行测试：直接运行php -v确认版本，再执行项目脚本（如php artisan --version）检查是否存在语法错误。
• Web测试：创建一个phpinfo.php文件，内容为，通过浏览器访问以确认显示的PHP版本是否正确。
• 自动化测试：如果项目中有单元测试或集成测试，建议完整执行一遍，这是最有效的发现问题的方法。

注意事项

最后需要强调几个关键点。旧版PHP（特别是5.6）官方早已停止安全更新，这意味着一旦发现漏洞将无法获得补丁。如果仅在开发环境或内网使用，风险可控；但如果用于面向公网的生产服务器，安全责任非常重大。此外，部分PHP扩展对新版PHP支持良好，但对旧版本可能不兼容，安装前务必确认清楚。至于版本数量，建议不要贪多，安装过多版本不仅占用资源，还容易引发配置冲突，够用即可。