composer 通过 "platform" 配置模拟目标 php 版本以控制依赖解析，需在 config.platform 中精确指定如 "php": "8.0.30"，配合 require.php 版本约束实现兼容性保障。
composer.json 里用 "platform" 模拟目标 PHP 版本
Composer 本身不提供“禁止安装”的硬性拦截，但能通过 "platform" 配置让依赖解析器「假装」运行在指定 PHP 版本下，从而跳过那些声明了高版本要求的包。这本质是欺骗 composer install 的依赖求解器，让它按你设定的环境去匹配兼容版本。
常见错误现象：本地 PHP 是 8.2，但项目必须跑在 8.0 环境，结果 composer install 装了只支持 8.1+ 的 monolog/monolog v3，上线直接报 ParseError。
- 在
composer.json根级加"config"块，嵌套"platform" -
"platform"只影响依赖解析，不改变实际运行环境 - 必须写全主次版本，比如
"php": "8.0.30"或至少"php": "8.0"；写"php": "^8.0"无效 - 如果同时约束扩展（如
ext-gd），也得一并写进"platform"
{
"config": {
"platform": {
"php": "8.0.30",
"ext-gd": "8.0.30"
}
}
}
用 "require" 中的 php 字段做最低版本兜底
"require": {"php": ">=8.0.0 这类写法不是用来“限制安装”，而是向 Composer 表明：本项目代码依赖这个范围的 PHP 特性。它会影响 packagist.org 上的包可安装性判断，但对已 lock 的项目无强制作用 —— 换句话说，<code>composer update 会尊重它，composer install 不会重新校验。
使用场景：团队协作中防止有人用高版本 PHP 执行 composer update 锁入不兼容包。
立即学习“PHP免费学习笔记（深入）”；
- 写法必须严格，
"php": "8.0.*"会被当作模糊通配，不如"php": ">=8.0.0 明确 - 和
"platform"配合最稳："require"定义项目能力边界，"platform"控制依赖选择空间 - 注意：这个字段不阻止低版本 PHP 运行
composer install，只是让 packagist 在搜索时过滤掉不匹配的包版本
CI/CD 中用 composer config platform.php 动态覆盖
本地开发用高版本 PHP，但 CI 流水线要验证 8.0 兼容性？硬编码 "platform" 到 composer.json 会污染开发体验。这时候该用命令行临时覆盖。
错误做法：在 CI 脚本里改 composer.json 再恢复 —— 容易出错、难维护。
- CI 启动时执行：
composer config platform.php 8.0.30 - 该命令会写入
composer.json的"config"→"platform"，但只在当前目录生效（不影响 Git） - 搭配
--no-plugins更安全，避免某些插件绕过平台约束 - 执行完记得
composer install --no-dev，否则 dev 依赖可能仍拉取高版本
为什么 composer prohibits 查不到 PHP 版本冲突？
composer prohibits vendor/package 能查出哪个依赖导致某包无法安装，但它不会把 php 当作一个普通包来分析 —— 因为 PHP 是平台环境，不是 Composer 管理的依赖项。所以当你看到 Your requirements could not be resolved 却查不到具体谁“禁止”了某个包，大概率是 php 版本约束和 "platform" 不一致导致的隐式冲突。
容易踩的坑：删掉 "platform" 后跑 composer prohibits，结果一切正常，误以为问题解决了；其实只是依赖解析器又回到了真实 PHP 版本，掩盖了部署环境的真实约束。
- 排查时先确认
composer config platform.php输出是否符合预期 - 再用
composer show --platform看当前解析使用的平台信息 - 最后对比
composer why-not php:8.0（需 Composer 2.5+）看哪些包明确要求更高版本
真正麻烦的从来不是设个版本号，而是当多个包各自声明不同 PHP 范围、又没发布适配版本时，platform 只能帮你筛，不能帮你修 —— 那时候就得手动 pin 版本或提 PR 了。
