PHP 8.0+ 废弃函数问题需三步解决：定位废弃点（用-d error_reporting=E_ALL运行时捕获、PHPStan扫描）、确认替代方案（查版本日志而非仅官方指南）、验证行为一致性（注意str_replace()等非废弃但行为变更的函数及扩展启用状态）。
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% 的显性问题。
立即学习“PHP免费学习笔记（深入）”；
-
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是常态，得单独处理
