如何配置PHP_CodeSniffer聚焦PHP 8.3迁移的关键错误？

1. 换用专门的兼容性检查规则集 #

放弃PSR12，改用PHPCompatibility——这是专门针对不同PHP版本兼容性问题的规则集，完全不包含格式、可读性相关规则，直接聚焦会导致运行崩溃的核心问题（比如废弃/移除的函数、语法变更、类型错误等）。

首先安装依赖：

composer require --dev squizlabs/php_codesniffer phpcompatibility/php-compatibility

2. 执行精准的兼容性检查命令 #

使用以下命令直接扫描PHP 5.6到8.3的兼容性问题，同时生成分组汇总报告：

/root/vendor/bin/phpcs /path/to/your/code \
  --standard=PHPCompatibility \
  --runtime-set testVersion 5.6-8.3 \
  --error-severity=1 \
  --warning-severity=0 \
  --report=grouped > phpcs_compatibility_report.txt

参数说明：

• --standard=PHPCompatibility：指定使用兼容性专属规则集
• --runtime-set testVersion 5.6-8.3：明确检查从5.6升级到8.3的版本差异
• --report=grouped：按错误类型自动分组汇总，去重跨文件的重复错误，清晰展示每个错误类型对应的所有受影响文件

3. 自定义规则集（可选） #

如果需要进一步排除某些非致命的兼容性警告（比如仅标记废弃但仍可临时运行的函数），可以创建自定义规则集文件phpcs-compatibility.xml：

<?xml version="1.0"?>
<ruleset name="PHP 8.3 Migration">
  <description>仅检查PHP 5.6到8.3的致命兼容性错误</description>
  <rule ref="PHPCompatibility"/>
  <!-- 排除非致命的废弃函数警告，按需添加其他排除规则 -->
  <exclude name="PHPCompatibility.FunctionUse.RemovedFunctions"/>
</ruleset>

然后用自定义规则集运行：

/root/vendor/bin/phpcs /path/to/your/code --standard=./phpcs-compatibility.xml --runtime-set testVersion 5.6-8.3 --report=grouped > phpcs_custom_report.txt

4. 轻量自动化汇总 #

如果需要更简洁的结果，可以结合命令行工具做快速去重和筛选：

/root/vendor/bin/phpcs /path/to/your/code --standard=PHPCompatibility --runtime-set testVersion 5.6-8.3 --error-severity=1 --warning-severity=0 --report=csv | grep -v "Warning" | sort -u > phpcs_simple_summary.csv

该命令会生成去重后的CSV格式报告，仅保留核心错误类型及对应文件。

你之前的命令无效的原因 #

你使用的PSR12标准包含大量格式、可读性规则（比如制表符/空格、代码缩进等），这些规则的错误等级普遍为1，所以即使设置--error-severity=1也会被纳入结果。切换到PHPCompatibility规则集就能彻底避开这类非关键问题。

内容的提问来源于stack exchange，提问作者developer