同一源码多版本PHP输出不同，废弃函数替换指南

PHP 8.0+ 升级常因废弃函数和隐蔽行为变更导致“看似正常却逻辑崩坏”——比如 `date()` 中部分格式符悄然被弃用、`mcrypt_*` 函数报错前毫无预警、`str_replace('', 'x', 'abc')` 在 PHP 8.0 后输出突变，甚至 `function_exists('get_magic_quotes_gpc')` 直接返回 `false` 而非警告。本文直击迁移痛点，提供可落地的三步法：用 `-d error_reporting=E_ALL` 和 PHPStan 精准定位废弃调用（而非盲目 grep），对照版本变更日志而非泛泛的官方指南确认替代方案（如 `openssl_encrypt()` 还是 `sodium_crypto_secretbox()`），并重点验证非废弃但行为突变的函数（如 `str_replace` 空字符串处理）及扩展启用状态——因为函数是否存在、行为是否一致，远比 `if (version_compare(PHP_VERSION, '8.0', '>='))` 这类脆弱的版本判断更可靠。

PHP 8.0+ 报 Deprecated: Function xxx is deprecated 怎么办

直接查 PHP 官方迁移指南不现实，多数人卡在“不知道哪个函数废了、替换成啥、旧代码还能不能跑”。核心动作就三步：定位废弃点、确认替代方案、验证行为一致性。

常见错误现象：date() 在 PHP 8.2+ 里仍可用但部分格式符（如 z）已标记为废弃；mysql_connect() 这类彻底移除的函数反而早就不报 Deprecated，而是直接 Fatal error —— 别被警告级别误导，得看 PHP 版本变更日志里“Deprecated in X.Y”那栏。

• 用 php -l 检查语法没问题，但运行时加 -d error_reporting=E_ALL 才能捕获所有弃用警告
• 搜索项目里所有 function_exists() 调用，它们常用来兜底旧函数，现在可能变成“永远走不到的死分支”
• 注意 get_magic_quotes_gpc() 这种 PHP 5.4 废弃、5.6 移除的函数，升级到 8.x 后连 function_exists() 都返回 false，不是报错而是逻辑崩坏

用 phpstan 或 psalm 扫描废弃函数调用

手动 grep 函数名漏得厉害，比如 create_function() 可能藏在字符串拼接里。静态分析工具能识别实际执行路径上的废弃调用，比单纯搜名字靠谱。

使用场景：CI 流程里加一道检查，或本地开发时快速过一遍老模块。别指望它覆盖 100%，但能揪出 80% 的显性问题。

• composer require --dev phpstan/phpstan，然后跑 vendor/bin/phpstan analyse --level=8 src/
• 对 mcrypt_* 系列函数，phpstan 会标出“Call to deprecated function mcrypt_encrypt()”，但不会告诉你该换 openssl_encrypt() 还是 sodium_crypto_secretbox() —— 得自己查文档定方案
• 注意兼容性：PHPStan 默认按当前 PHP 版本检查，如果目标是迁移到 PHP 8.3，得加 --php-version=8.3 参数，否则它可能放过某些 8.3 才废弃的函数

str_replace() 和 str_ireplace() 在 PHP 8.0+ 的行为差异

这不是废弃函数，但输出不同——PHP 8.0 把空字符串作为搜索项时的行为改了，str_replace('', 'x', 'abc') 以前返回 'xaxbxcx'，现在返回原串 'abc'。很多模板引擎或路由匹配逻辑因此失效。

参数差异关键在第三个参数：str_replace() 第二个参数（替换值）可以是数组，但第一个参数（搜索项）如果是数组，长度必须和第二个一致，否则 PHP 8.0+ 会发 Warning: str_replace(): Empty array passed，而旧版静默忽略。

• 检查所有传入变量做搜索项的地方，加 if ($search === '') { /* 特殊处理 */ }，别依赖默认行为
• str_ireplace() 同样受影响，大小写不敏感版不是“安全替代”，只是多了一层转换开销
• 性能影响不大，但逻辑断裂风险高：比如用空字符串切分 URL 路径再拼接，PHP 7.4 正常，8.0+ 就丢段

用 phpversion() + 条件判断硬扛多版本兼容？别这么做

写 if (version_compare(PHP_VERSION, '8.0', '>=')) { ... } else { ... } 看似稳妥，实则埋雷。PHP 版本号不是线性演进，8.1 废弃的函数在 8.0 里可能还没标废弃，但你提前切了分支，结果 8.0 下反而调用失败。

真正要盯的是函数是否存在且行为稳定，而不是版本号本身。比如 json_encode() 的 JSON_INVALID_UTF8_IGNORE 标志，PHP 7.2 加入，但 7.2–7.3 实现有 bug，8.0 才修好 —— 光看版本判断会误判。

• 优先用 function_exists() + defined() 组合，比如检查 mb_str_split() 存在再用，不存在就 fallback 到 preg_split()
• 避免在全局作用域写大段版本判断，把兼容逻辑封装进独立函数，比如 safe_json_encode()，内部处理不同版本的标志位支持
• 最容易被忽略的一点：扩展是否启用比 PHP 版本更重要。ext-gd 在 PHP 8.0 默认启用，但某些 Docker 镜像里它压根没装，function_exists('imagecreate') === false 是常态，得单独处理

今天关于《同一源码多版本PHP输出不同，废弃函数替换指南》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！