phpstan不报语法错误但能暴露跨版本类型契约断裂，必须与php -l共用：前者深查类型兼容性，后者快筛基础语法；phpstan.neon须显式配置phpversion（如70400），否则检测失效。
PHPStan 本身不报语法错误，但它能精准暴露因 PHP 版本升级引发的类型契约断裂——这才是线上崩溃最隐蔽的源头。真正拦不住语法解析失败的，是 php -l；而 PHPStan 拦的是“能跑但会错”的逻辑陷阱，比如把箭头函数返回值当 int 传给只接受 float 的方法，在 PHP 7.4 下看似正常，升到 8.0 后却触发 Fatal error: Uncaught TypeError。
必须搭配 php -l 做第一道快速筛查
php -l 是轻量级语法扫描器，只检查词法和基础语法是否合法，速度快、无依赖，适合放进 CI 流水线开头环节：
- 它能立刻发现 PHP 7.3 环境下使用
fn($x) => $x * 2这类新语法导致的解析失败 - 但对类型不匹配、函数签名变更（如
str_contains()在 8.0+ 才存在）完全无感 - 建议在 CI 中加一行：
find src/ -name "*.php" -exec php -l {} \; || exit 1
PHPStan 要显式配置目标 PHP 版本
默认情况下，PHPStan 按当前运行环境版本推断函数行为。如果你在 PHP 8.2 机器上分析一个要跑在 PHP 7.4 的项目，不设限制就会把 match、联合类型等全当合法，检测彻底失效。
- 在
phpstan.neon的parameters区块中必须写明：phpVersion: 70400 - 数值格式固定为「主版本×10000 + 次版本×100 + 修订号」，例如 PHP 8.1.22 →
80122 - 多版本兼容项目（如支持 7.4–8.2），按最低目标版本设置，否则高版本特性会被跳过检查
别滥用 ignoreErrors，优先走正向适配
框架代码常触发 Call to an undefined method 或 Access to an undefined property，直接加 ignoreErrors 很容易，但等于关掉了告警灯。
- 优先加载框架 stub 文件（如
think-stubs.php）或通过bootstrapFiles注入类型定义 - 只对明确已知、短期无法重构的动态调用加忽略，且每条必须带注释说明原因和修复计划
- 正则匹配要窄：用
'#Call to an undefined method App\Model\User::getProfileData#'，而不是'#undefined#'
配合 PHPCompatibility 做语法层全覆盖
PHPStan 擅长类型与逻辑层，但对废弃函数、新增语法、动态属性赋值等语法级风险覆盖有限。这时候需要 phpcompatibility + PHPCS 补位：
- 安装：
composer require --dev phpcompatibility/php-compatibility - 指定目标版本扫描：
vendor/bin/phpcs --standard=PHPCompatibility --runtime-set testVersion 7.4 src/ - 它能提前标出
mysql_connect()已废弃、??=不支持等硬性兼容问题
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
