服务器环境升级本是一件好事，性能提升、安全补丁、生命周期延长都是实实在在的好处。但不少团队在把 PHP 从 5.x 升级到 7.x 甚至 8.x 之后，第一件事就是接到一堆报错工单：页面白屏、数据库连不上、函数未定义。这是因为 PHP 从 5 到 8 的每次大版本升级，都伴随着函数移除、行为变更和配置调整。本文就来系统梳理如何让旧版 PHP 程序在升级后的环境中兼容运行。
先弄清楚：升级后旧程序到底坏了什么
排查兼容性问题的第一步，是打开错误显示，把具体报错看清楚。很多旧项目在 php.ini 中关闭了错误输出，导致页面白屏却找不到原因。临时开启错误显示后再访问页面，通常能看到类似 Call to undefined function mysql_connect()、Fatal error: Cannot use tmp... 之类的提示，这些信息直接指向了具体的破坏性变更。
PHP 各大版本的主要破坏性变更集中在几个方向。PHP 7.0 移除了 mysql 系列函数，全部改用 mysqli 或 PDO；PHP 7.x 废弃了 create_function、each 等函数；PHP 8.0 则带来了更严格的类型检查，未定义变量、字符串偏移、隐式浮点数转整数的行为都有变化，同时移除了 each、create_function，并把许多警告升级为 Error 异常。PHP 8.1 之后甚至废弃了动态属性，老框架如果没有适配版本，直接就会崩。
常见报错与对应原因可以整理成一张速查表：
| 报错信息 | 出现版本 | 原因 |
|---|---|---|
| Call to undefined function mysql_connect() | PHP 7.0+ | mysql 扩展被移除 |
| Call to undefined function each() | PHP 8.0+ | each 函数被移除 |
| Creation of dynamic property ... is deprecated | PHP 8.2+ | 动态属性被废弃 |
| Uncaught TypeError: Unsupported operand types | PHP 8.0+ | 算术运算类型检查变严格 |
对照这张表，大部分白屏问题都能快速定位。定位清楚之后，再决定走哪条兼容路线。
方案一：修改配置与代码做最小化兼容改造
如果程序本身年代不算太久远，只是用了少量被移除的特性，最经济的做法是针对性修改。先在 php.ini 中调整几个关键参数：error_reporting 建议设置为 E_ALL & ~E_DEPRECATED & ~E_NOTICE，先把废弃警告压下去保证程序能跑；short_open_tag 设为 On 兼容使用短标签的老模板；如果程序依赖魔法引号相关的老逻辑，则需要在入口处做兼容处理。
数据库层面，mysql 系列函数可以用一个兼容层顶替。写一个函数映射文件，在程序入口统一引入：
<?php
// mysql_compat.php - mysql 扩展兼容层
if (!function_exists('mysql_connect')) {
function mysql_connect($host, $user, $pass) {
return mysqli_connect($host, $user, $pass);
}
function mysql_select_db($db, $link = null) {
return mysqli_select_db($link ?: mysqli_init(), $db);
}
function mysql_query($sql, $link = null) {
return mysqli_query($link, $sql);
}
function mysql_fetch_assoc($result) {
return mysqli_fetch_assoc($result);
}
function mysql_error($link = null) {
return mysqli_error($link);
}
function mysql_close($link = null) {
return mysqli_close($link);
}
}同理，each 函数也可以自己实现一份：function each(&$arr) { $key = key($arr); $val = current($arr); if ($val === false && $key === null) return false; next($arr); return array(1 => $val, 'value' => $val, 0 => $key, 'key' => $key); }，不过从 PHP 8 起函数名不能再与内置函数冲突，这类兼容函数需要注册到 autoload 或者用命名空间技巧引入，实际操作中更推荐直接改调用点。
这种最小化改造的优点是改动小、上线快，适合明确知道报错点在哪的项目。缺点是治标不治本，遇到依赖庞大老框架（如 Zend Framework 1、老版 ThinkPHP）的项目，兼容函数根本铺不完，这时就要考虑下面的方案。
方案二：新旧版本共存，让旧程序跑在自己的环境里
当程序实在改不动，比如源码加密、缺少维护人员、或者改动成本远超收益，最稳妥的思路是让旧程序继续使用旧版本 PHP，新项目用新版本，两者在同一台服务器上共存。这比在代码里打补丁要可靠得多。
Nginx 配合 php-fpm 实现多版本共存是最常见的做法。分别安装两个版本的 PHP-FPM，让它们监听不同端口，例如 PHP 5.6 监听 9000，PHP 8.2 监听 9001，然后在 Nginx 中按站点指定：
server {
listen 80;
server_name old-app.bbccb.com;
root /var/www/old-app;
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000; # 旧项目走 PHP 5.6
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
}
server {
listen 80;
server_name new-app.bbccb.com;
root /var/www/new-app;
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9001; # 新项目走 PHP 8.2
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
}如果用的是 Apache，可以借助 mod_proxy_fcgi 或者通过 SetHandler "proxy:unix:/run/php/php56-fpm.sock|fcgi://localhost" 的方式为不同虚拟主机指定不同的 PHP 版本。宝塔、LNMP 一键包这类面板也提供了按站点切换 PHP 版本的功能，操作上更省心。
多版本共存的额外好处是可以平滑迁移：先把旧项目原样跑在旧版本上保证业务不中断，再安排时间逐模块改造代码、在新版本环境里测试，测试通过后切流量的 FPM 指向即可完成升级。需要注意的是，旧版本 PHP 官方早已停止安全维护，共存只是缓冲手段，不能作为长期方案，务必在内网隔离或加上访问白名单降低风险。
方案三：善用迁移工具，把人工排查交给自动化
手工排查几百个文件的兼容性问题效率很低，这时可以借助工具。PHP 官方提供的命令行工具 php-to-php 或者社区广泛使用的 rector 是两个代表。rector 通过抽象语法树分析代码，可以自动把 mysql 函数调用改写为 mysqli，把 create_function 改成匿名函数，覆盖了大部分机械性的兼容改造。
rector 的典型配置如下：
services:
Rector\Php54\Rector\FuncCall\RemoveReferenceFromCallRector: ~
Rector\Php70\Rector\FuncCall\RenameMysqlFunctionsToMysqliRector: ~
Rector\Php73\Rector\FuncCall\StringifyStrNeedlesRector: ~
Rector\Php80\Rector\FunctionLike\UnionTypesRector: ~执行 vendor/bin/rector process src --dry-run 先做预览，确认改动无误后去掉 --dry-run 正式执行。自动改写之后务必跑一遍完整测试，尤其是涉及弱类型比较和字符串转数字的地方，PHP 8 的行为与旧版差异最大，工具无法保证业务逻辑层面的等价性。
除了静态改写工具，也可以用 PHPStan 或 Psalm 做静态分析，提前发现潜在的类型错误和不兼容写法。工具链的组合思路是：静态分析找问题、rector 自动改、人工复核关键业务、测试环境回归验证。这套流程跑下来，绝大多数项目的迁移风险都能控制在可接受范围内。
总结一下，升级环境后让旧程序兼容运行有三条路：小问题就改配置加兼容函数，改不动的就多版本共存争取时间，长期方案则是用工具辅助完成真正的代码迁移。无论走哪条路，都建议先在测试环境完整验证，并保留旧环境的快速回退能力，业务不中断才是兼容工作的底线。