如何用PHPStan一次性检测PHP代码的多版本兼容性？

我正在寻找检测PHP代码与不同PHP版本兼容性的方法，重点关注7.2-8.1版本。起初尝试了phpcs，但效果不理想，于是改用phpstan。phpstan对单个PHP版本的检测效果很好，但每个配置文件似乎只能指定一个PHP版本。我的phpstan.neon文件内容如下：

parameters:
        level: 0
        phpVersion: 70400
        paths:
                - src/project
                - src/library

执行vendor/bin/phpstan -c phpstan.neon可正常运行，但尝试为phpVersion指定多个值时会报错，因为该参数仅支持int|null类型。请问是否有办法通过一次PHPStan运行检测多个PHP版本？是否存在适配多版本的规则集？

PHPStan本身不支持单次运行指定多个PHP版本，因为phpVersion参数的设计就是单值的，用来模拟特定PHP版本的运行环境、语法特性和函数行为。不过可以通过以下方式实现多版本兼容性检测：

• 多配置文件批量执行
  针对每个目标版本（7.2、7.3、7.4、8.0、8.1）创建单独的配置文件，比如phpstan-72.neon、phpstan-73.neon，仅修改其中的phpVersion参数：

  // phpstan-72.neon示例
  parameters:
          level: 0
          phpVersion: 70200
          paths:
                  - src/project
                  - src/library
  

  再编写脚本批量执行检测，比如shell脚本：

  #!/bin/bash
  # 对应7.2、7.3、7.4、8.0、8.1的版本编码
  VERSIONS=("70200" "70300" "70400" "80000" "80100")
  for VER in "${VERSIONS[@]}"; do
      echo "开始检测PHP版本编码: $VER"
      vendor/bin/phpstan analyze -c phpstan-${VER:0:2}.neon
  done
  

  运行这个脚本就能一次性完成所有目标版本的兼容性检测。

• 搭配扩展增强检测能力
  没有官方的多版本专属规则集，但可以安装phpstan/phpstan-deprecation-rules扩展，用来检测跨版本的废弃API调用。安装后在配置文件中启用：

  includes:
          - vendor/phpstan/phpstan-deprecation-rules/rules.neon
  

  该扩展会标记目标PHP版本中已废弃或移除的函数、方法与特性，配合多版本配置运行，能更全面覆盖兼容性问题。

• 辅助工具补充检测
  可以结合roave/backward-compatibility-check这类工具，不过它主要聚焦API的向后兼容性检测，和PHP版本语法/特性兼容性检测互补，适合和PHPStan配合使用。

最直接有效的方案还是针对每个PHP版本单独配置并批量执行PHPStan，这种方式能确保每个版本的检测都准确模拟对应环境的行为。

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