如何批量检查代码中不兼容 PHP 8 的语法特性？

使用 PHPCompatibility 工具配合 phpcs 命令可在 5 分钟内扫描完 10 万行代码，准确识别超过 50 个专用嗅探器覆盖的不兼容项，包括 each()、create_function() 等已移除函数。

原因分析

PHP 8 将过去"容忍"的行为变成了"拒绝"，这是升级后出现大量报错的根本原因。例如 strlen(null)、count(null)、array_key_exists(null, $arr) 这类调用，在 PHP 7.x 里可能只警告或返回默认值，PHP 8 直接报错中断。根据 2026 年 4 月 4 日的技术资料，PHP 8.0 把 assert() 字符串参数默认开启 assert.exception = 1，assert('is_int($x)') 会尝试执行字符串并抛异常。此外，each() 函数已被彻底移除，create_function() 也已移除，mb_*() 函数在 PHP 8 强制要求显式传$encoding 参数，否则警告。

解决方案

步骤一：使用 php -l 批量语法检查

最直接的批量检查方式是结合 find 与 xargs 命令。基础命令组合为：find . -name "*.php" -print0 | xargs -0 -n 1 php -l。该命令从当前目录开始查找所有以.php 结尾的文件，-print0 用 null 字符作为分隔符输出文件名，可正确处理文件名中包含空格或特殊字符的情况。为提升效率可添加-not -path "./vendor/"排除第三方库，结合grep "parse error"过滤输出仅显示错误。根据 2025 年 8 月 15 日的技术指南，此方法能有效提前发现语法错误，避免运行时崩溃。

步骤二：部署 PHPCompatibility 静态分析工具

PHPCompatibility 是专门针对 PHP 代码进行兼容性检查的 Composer 库，支持从 PHP 5.0 到最新 PHP 版本的兼容性检查，覆盖二十多年来的 PHP 语言变化。项目包含超过 50 个专用嗅探器 (Sniffs)，覆盖类与对象特性、函数声明与使用、语法变化、变量处理等层面。安装命令为：composer config allow-plugins.dealerdirect/phpcodesniffer-composer-installer true后执行composer require --dev phpcompatibility/php-compatibility:"^10.0.0@dev"。运行检查命令：phpcs --standard=PHPCompatibility --runtime-set testVersion 8.0 your-project-folder/。根据 2026 年 3 月 22 日的资料，该工具能检测已移除的函数和特性 (如 mysql_*函数族)、识别新版本引入的语法变化、发现废弃特性的使用 (如 each() 函数)、验证类型声明和返回值声明的兼容性。

步骤三：使用 PHPStan 进行深度类型检查

PHPStan 可进行更深层的类型错误检测。安装命令：composer require --dev phpstan/phpstan。执行兼容性扫描：./vendor/bin/phpstan analyse src/ --level=8。根据 2025 年 12 月 15 日的 CSDN 博客，该命令会输出类型错误、弃用函数调用及不推荐使用的语法结构。对于 PHP 8.7 环境，推荐使用级别 9：vendor/bin/phpstan analyse --level=9 src/。

步骤四：检查 Composer 依赖兼容性

通过 Composer 验证所有依赖包是否支持目标 PHP 版本。执行命令：composer check-platform-reqs查看有没有包卡在 php 版本约束。对于 PHP 8.6 验证：composer validate后执行composer check-platform-reqs php:8.6。根据 2025 年 12 月 15 日的资料，若发现不兼容的包，需查阅其官方文档或切换至维护分支。

注意事项

根据多个技术论坛和博客的真实反馈，升级过程中有以下常见陷阱：第一，动态属性创建在 PHP 8.5 中将触发 Error 异常，错误信息为"Fatal error: Cannot create dynamic property User::$name"，需在类上添加#[AllowDynamicProperties]属性标记或显式声明属性。第二，构造函数中未声明类型的参数，如果类里有public function __construct($id)而后续又用了$this->id，PHP 8 会报 Undefined property，要么加属性声明public int $id，要么用属性提升public function __construct(private int $id)。第三，第三方扩展最容易翻车，框架和扩展不升级，光改自己代码也没用，需确认 xdebug、mysqli 等扩展模块正常加载。第四，PHP 8.7 的 JIT 优化虽能提升执行速度约 15%-20%，但需通过php --ri opcache查看是否启用 JIT 及 OPcache 配置。第五，命名参数混用在 PHP 8 被禁止，可用grep -r ":[a-zA-Z]" app/ --include="*.php"全局搜高危模式找类似foo("x", bar: true)的写法。

参考来源

来源：CSDN 博客 - PHP 8.6 升级必看:5 个关键兼容性检测步骤，避免生产环境崩溃 (2025 年 12 月 15 日)

来源：GitCode - PHPCompatibility 项目地址及兼容性检查终极指南 (2026 年 3 月 22 日)

来源：CSDN 博客 - PHP 8.5 迁移必备技能：自动化检测与修复兼容性问题的 3 种方法 (2025 年 12 月 7 日)

来源：技术博客 - PHP 命令如何批量检查目录下 PHP 脚本的语法 (2025 年 8 月 15 日)