Composer install不报错不代表兼容PHP 7.4，因其仅按当前php -v版本校验约束；若在PHP 8.2下安装，即使项目需部署到7.4，也会成功生成vendor，但运行时因match等新语法触发ParseError。
Composer 本身不会自动检测旧版 PHP 兼容性，它只按当前运行的 PHP 版本做约束检查；想验证旧版兼容性，必须手动“骗过” Composer，让它按目标旧版本解析依赖。
为什么 composer install 不报错不代表兼容 PHP 7.4
Composer 默认用 php -v 返回的当前版本校验 "php": "^8.1" 这类约束。如果你在 PHP 8.2 下执行 composer install，它根本不会检查 PHP 7.4 是否能跑——哪怕你项目要部署到 7.4 环境，它也照装不误。
常见错误现象：composer install 成功、vendor/autoload.php 生成了，但一放到 PHP 7.4 服务器上就报 ParseError: syntax error, unexpected token "match" 或 Class not found。
- 根本原因：Composer 的平台检查只发生在 install/update 阶段，且只基于当前运行时 PHP 版本
-
config.platform是唯一能“预设目标环境”的机制，但它必须显式配置，不会自动触发 - 不配
platform，就等于告诉 Composer：“我只管现在能装上，不管以后能不能跑”
用 config.platform 模拟 PHP 7.4 环境
在 composer.json 的 config 节点下添加 platform 声明，强制 Composer 按指定旧版本选包：
立即学习“PHP免费学习笔记（深入）”；
{
"config": {
"platform": {
"php": "7.4.33"
}
}
}
然后执行：
-
composer clear-cache—— 清掉旧平台缓存，否则可能沿用 PHP 8.2 的解析结果 -
rm -rf vendor composer.lock—— 彻底重来，避免 lock 文件残留高版本包 -
composer install --no-scripts—— 先确保依赖图能闭合，跳过可能因 PHP 版本不兼容而失败的脚本
如果这步失败，报错如 Your requirements could not be resolved...，说明至少有一个直接或间接依赖已不支持 PHP 7.4（比如某包 require "php": "^8.0"），就得降级那个包，或找替代方案。
如何确认某个包是否真支持 PHP 7.4
别只看 composer.json 里的 "php": "^7.2" —— 很多包声明宽松，实际代码用了 8.0+ 特性。验证方式分两层：
- 查元数据：
composer show vendor/package 2.9.0，看输出里requires php行是否包含7.4，同时注意ext-*扩展要求（如ext-gd在 7.4 中默认启用，但某些旧包可能误写成ext-gd >= 8.0） - 查真实兼容性：
composer show --all vendor/package | grep -E '^[0-9]+\.[0-9]+\.[0-9]+$'列出所有稳定版，再逐个composer show vendor/package X.Y.Z看其requires字段 - 关键陷阱：有些包用两位版本号（如
laravel/framework:9.x），grep正则会漏，得手动翻composer show --all输出，找带7.4的requires php行
CI/CD 中批量验证多个旧 PHP 版本
本地验证完还不够，得让 CI 自动跑不同 PHP 版本。GitHub Actions 示例：
jobs:
test-compat:
strategy:
matrix:
php-version: ['7.4', '8.0', '8.1']
steps:
- uses: actions/checkout@v3
- name: Setup PHP
uses: shivammathur/setup-php@v2
with:
php-version: ${{ matrix.php-version }}
- name: Set platform for PHP ${{ matrix.php-version }}
run: |
composer config platform.php ${{ matrix.php-version }}.0
- name: Install deps
run: composer install --no-interaction --no-progress
- name: Check autoload
run: php -r "require 'vendor/autoload.php';"
重点是 composer config platform.php 这行 —— 它动态覆盖 composer.json，比硬编码更灵活；每次换版本都重设，避免残留。
真正容易被忽略的是：platform 配置后，composer install 成功只代表“依赖能装上”，不代表“代码能跑”。你还得在对应 PHP 版本下实际执行 php -l 扫语法、跑单元测试、甚至测路由入口，否则 match、#[Attribute] 这类语法错误全得等上线才暴露。
