Composer 默认以当前运行的 PHP 版本为平台版本筛选依赖，导致无法安装仅兼容低版本的包；需通过 config.platform.php 指定完整版本号并执行 composer update --lock 更新锁文件，或使用 --platform=php:x.x 临时覆盖。
Composer 本身不决定 PHP 版本，它只检测当前运行环境的 PHP 版本，并据此筛选兼容的包版本；所谓“指定 PHP 版本”，本质是控制 composer install 时依赖解析所参考的 PHP 版本约束。
为什么 composer install 装不出低版本包？
当你本地是 PHP 8.2，但项目 composer.json 中声明了 "php": "^7.4"，Composer 默认仍用 8.2 去匹配——这意味着它只会选同时支持 7.4 和 8.2 的包版本（通常是较新的），而不会主动降级去装仅兼容 7.4 的旧版包。
- 根本原因：Composer 的依赖求解器以 当前运行的 PHP 版本 为默认平台版本（platform）
- 表现症状：
composer install成功但运行时报Function not found（如用了str_contains()却在 PHP 7.4 下执行） - 不是 bug，是设计：Composer 假设你“在目标环境中运行”，而非“为其他环境构建”
用 platform 配置伪造 PHP 环境
在 composer.json 的 config 段显式声明 platform，告诉 Composer：“请当我是在这个 PHP 版本下运行”。这会影响所有后续的依赖解析、require 推荐、outdated 检查。
{
"config": {
"platform": {
"php": "7.4.33"
}
}
}
- 必须写完整版本号（如
"7.4.33"），不能写"^7.4"或"7.4"—— 后者会被忽略 - 修改后需运行
composer update --lock重生成composer.lock，否则旧锁文件仍按原平台解析 - 该配置仅影响当前项目，不改变系统 PHP，也不影响其他项目
临时覆盖平台版本（无需改 composer.json）
用 --ignore-platform-req=php 或 --platform=php:8.1 在命令行临时干预，适合 CI 构建或快速验证。
- 禁用检查：
composer install --ignore-platform-req=php（跳过 PHP 版本校验，危险，慎用） - 临时指定：
composer install --platform=php:8.1（Composer 2.2+ 支持，等效于临时设置platform.php） - CI 场景推荐：
composer install --no-interaction --platform=php:7.4.33，避免因本地 PHP 版本波动导致构建不一致 - 注意：
--platform不会写入composer.lock，每次都要带参数
常见陷阱与验证方式
很多人配了 platform 却没生效，往往卡在缓存或锁文件上。
- 执行
composer show php查看当前解析所用的 PHP 平台版本（显示的是platform.php值，不是系统php -v） - 删掉
vendor/和composer.lock后再composer install，否则旧 lock 文件里的包版本可能仍来自高版本平台 - 如果项目用了
ext-*扩展约束（如"ext-gd": "*"），platform里也得一并声明，否则扩展缺失仍会报错 - PHP 8.0+ 的
mixed类型提示、属性提升等语法，在 PHP 7.x 下直接 fatal error，Composer 的平台配置无法规避这类运行时错误——它只管依赖选择，不管代码能否执行
真正关键的不是“怎么配”，而是“配完是否触发了重新解析”；composer.lock 是唯一权威，只要它没更新，所有配置都是空谈。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
