@PHP85Migration已被弃用，须改用@PHP8x5Migration；PHPCS、PHP-CS-Fixer、PHPStan三工具配置逻辑不变，仅需确保版本兼容PHP 8.5并启用bleedingEdge.neon等新特性支持。
PHP 8.5 本身不改变代码规范检查工具的配置逻辑，但需注意两点：一是部分旧规则集（如 @PHP85Migration）已被弃用；二是动态属性等新行为会影响静态分析结果。配置核心仍是 PHP_CodeSniffer（PHPCS）、PHP-CS-Fixer 和 PHPStan 这三类工具，它们与 PHP 版本解耦，只需确保工具版本兼容 PHP 8.5 即可。
安装并配置 PHP_CodeSniffer（PHPCS）
PHPCS 负责检测编码风格是否符合 PSR-12 等标准，是 PhpStorm 实时提示的基础：
- 用 Composer 安装（推荐项目级）：
composer require --dev squizlabs/php_codesniffer - 验证安装：
./vendor/bin/phpcs --version，输出应为 3.7.2 或更高（兼容 PHP 8.5） - 在项目根目录创建
phpcs.xml，显式补全文档块规则（PSR12 不含@return检查）：
<?xml version="1.0"?>
<ruleset name="PHP85-Ready">
<rule ref="PSR12"/>
<rule ref="Squiz.Commenting.FunctionComment"/>
<file>src/</file>
</ruleset> - 在 PhpStorm 中：Settings → Languages & Frameworks → PHP → Code Sniffer → 填入路径（如
$ProjectFileDir$/vendor/bin/phpcs），标准选PSR12，并勾选 “Use configuration file” 指向phpcs.xml
启用 PHP-CS-Fixer 做自动修复
它能一键修正格式问题，尤其适合 PHP 8.5 兼容性迁移：
- 安装：
composer require --dev friendsofphp/php-cs-fixer - 创建
.php-cs-fixer.php，使用新版命名规则：
return (new PhpCsFixer\Config())
->setRules([
'@PHP8x5Migration' => true,
'@PSR12' => true,
])
->addFinder(PhpCsFixer\Finder::create()->in('src')); -
不要用
@PHP85Migration—— 它已在 php-cs-fixer v3.54+ 中标记为 DEPRECATED，会触发警告且未来被移除 - 运行修复：
./vendor/bin/php-cs-fixer fix --dry-run（预览）或直接fix
搭配 PHPStan 做类型与兼容性深度分析
PHP 8.5 的严格类型变化（如联合类型增强、动态属性限制）需要 PHPStan 提前捕获：
立即学习“PHP免费学习笔记（深入）”；
- 安装：
composer require --dev phpstan/phpstan - 生成配置：
./vendor/bin/phpstan init-config，编辑phpstan.neon：
parameters:
level: 6
paths:
- src/
includes:
- vendor/phpstan/phpstan/conf/bleedingEdge.neon
（bleedingEdge.neon启用对 PHP 8.5 新特性的支持） - 运行检查：
./vendor/bin/phpstan analyse，关注DynamicPropertyAssignment、ParameterTypeMismatch类错误
验证与调试常见卡点
若配置后无提示或报错不生效，重点检查以下三项：
-
路径是否指向可执行文件：终端中运行
./vendor/bin/phpcs --standard=PSR12 src/Example.php必须有输出，否则 PhpStorm 调用失败 -
规则是否真正启用：PHPCS 默认不加载子 sniff（如 FunctionComment），必须在
phpcs.xml中显式<rule ref="Squiz.Commenting.FunctionComment"/> - IDE Inspection 范围是否设为 Project Files：Settings → Editor → Inspections → PHP → PHP Code Sniffer validation → Scope 改为 Project Files，禁用 “Skip files with errors” 缓存
