如何在Composer.json中定义复杂的PHP版本约束（如 >=7.2

Composer 的 PHP 版本约束需在 require 中显式声明，如 “php”: “>=7.2″；config.platform.php 用于模拟部署环境，其值须满足 require.php 约束，否则报错；依赖版本锁定以 composer.lock 为准，不执行 update 不会自动升级。

Composer.json 中 PHP 版本约束的写法

Composer 不会自动检测你本地的 PHP 版本，它只在 composer install 或 composer update 时检查 platform 配置或当前运行环境是否满足 config.platform.php 或根级 require.php 的约束。你要控制依赖安装时的 PHP 兼容性，必须显式写进 require 字段。

常见错误是把版本号写成字符串（如 "php": ">=7.2"）但漏掉点号，或误用波浪号（~7.2）——它等价于 ^7.2.0，只匹配补丁级更新，不适用于 PHP 主版本约束。

• ">=7.2" ✅ 匹配 7.2.0 及以上所有版本（含 8.0、8.1…）
• "^7.2" ✅ 等价于 ">=7.2.0 ，推荐用于明确限定主次版本范围
• "~7.2" ⚠️ 实际等价于 ">=7.2.0 ，太窄，一般不用作 PHP 约束
• ">=7.2 ✅ 最清晰的区间写法，语义明确
• "7.2.*" ❌ 不合法，Composer 不支持通配符语法

如何让 Composer 忽略本地 PHP 版本强制使用平台配置

当你在 PHP 8.2 环境下想测试包是否兼容 PHP 7.4，不能靠改系统 PHP，而应通过 config.platform.php 告诉 Composer：“假装我只装了 7.4”。否则 composer install 可能拉取仅兼容 8.x 的依赖版本。

这个配置会影响所有依赖的版本选择逻辑，不只是你自己的代码。

立即学习“PHP免费学习笔记（深入）”；

{     "require": {         "php": ">=7.4"     },     "config": {         "platform": {             "php": "7.4.33"         }     } }

注意：config.platform.php 的值必须满足 require.php 的约束，否则会报错 Your requirements could not be resolved。

多 PHP 版本兼容时 require-dev 的陷阱

开发依赖（如 phpunit/phpunit）经常有更激进的 PHP 要求。如果你的项目要支持 PHP 7.2–8.2，但 phpunit:^9 要求 php: >=7.3，而 phpunit:^10 要求 php: >=8.1，就不能只写一个 require-dev。

解决方法不是降级 PHPUnit，而是用 config.platform.php 锁定构建环境，并在 CI 中分版本测试。

• CI 脚本中先设 COMPOSER_PLATFORM_CHECK=0 防止本地 PHP 干扰
• 每个 PHP 版本跑一次 composer install --no-interaction
• 不要在 require-dev 里写 "phpunit/phpunit": "^9 || ^10" —— Composer 不支持 OR 逻辑

为什么 composer show -p 显示的 PHP 版本和 php -v 不一致

composer show -p 显示的是 config.platform.php 值（如果设置了），否则才是当前运行 PHP 的版本。这是 Composer 模拟目标部署环境的方式，不是 bug。

如果你没设 platform.php，但输出仍是旧版本，大概率是 Composer 缓存了旧的 lock 文件或平台信息。执行 composer clear-cache 后重试，或删掉 composer.lock 再 composer install。

真正容易被忽略的是：即使 composer.json 里写了 "php": ">=8.0"，只要没运行 composer update，lock 文件里仍可能保留 PHP 7.x 兼容的老版本依赖 —— 约束只在解析依赖图时起作用，不自动刷新已锁死的版本。