PHP版本兼容性排查：用shivammathur/setup-php动作快速搭建测试环境-php教程-PHP中文网

最高效方式是用shivammathur/setup-php搭建多版本测试环境，它自动识别.php-version、composer.json platform或composer.lock中的php版本，配合matrix策略并行验证7.4至8.5，并通过composer platform配置锁定依赖解析，再结合phpcompatibility静态扫描精准定位语法级不兼容问题。

php版本兼容性排查：用shivammathur/setup-php动作快速搭建测试环境

直接用 shivammathur/setup-php 搭建多版本测试环境，是排查 PHP 兼容性最高效的方式。它不依赖本地配置，也不需要手动维护 Docker 镜像，几行 YAML 就能跑通从 PHP 7.4 到 8.5 的完整验证链。

自动识别项目所需 PHP 版本

不用硬写版本号，setup-php 能主动读取项目配置：

优先检查根目录下的 .php-version 文件（内容如 8.2）
fallback 到 composer.json 中的 config.platform.php 值
再 fallback 到 composer.lock 的 platform-overrides.php

这样你改一个配置，CI 就自动跟着切版本，避免人为写错或遗漏。

矩阵式并行验证多个 PHP 版本

在 GitHub Actions 中用 strategy.matrix 一次性覆盖主流环境：

jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        php-version: ['7.4', '8.0', '8.2', '8.5']
    steps:
      - uses: actions/checkout@v4
      - name: Setup PHP
        uses: shivammathur/setup-php@v2
        with:
          php-version: ${{ matrix.php-version }}
          extensions: mbstring, intl, pdo_sqlite
          coverage: none
      - run: composer install --no-interaction
      - run: vendor/bin/phpunit

每个版本独立运行，失败时能准确定位是哪个 PHP 版本下出问题，而不是笼统说“兼容性不好”。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

配合 Composer platform 锁定依赖解析逻辑

仅切换 PHP 运行时还不够——Composer 安装依赖时也得按目标版本选包。在 composer.json 加上：

"config": {
  "platform": {
    "php": "8.1"
  }
}

这样即使你在 PHP 8.5 环境里执行 composer install，它也会按 PHP 8.1 的能力去选包，提前暴露 ext-gmp 或 ReturnTypeWillChange 这类高版本才支持的依赖项。

快速定位语法/函数级不兼容点

如果某版本报错，别急着改代码，先加两步诊断：

在 setup-php 步骤后加 run: php -v，确认实际加载的是不是你预期的版本
加 run: php -m | grep -E 'xdebug|pcov|opcache'，看关键扩展是否真启用
对报错文件，用 PHPCompatibility 扫描：vendor/bin/phpcs --standard=PHPCompatibility --runtime-set testVersion 8.0 src/

这类静态检查能在 CI 失败前就标出 array_key_first()、str_contains() 等 PHP 8+ 函数的使用位置。