应统一PHP环境或调整composer.json中的PHP版本约束，而非降级Composer；优先检查php -v与require.php/platform.php是否匹配，必要时用composer config platform.php指定目标版本。
composer install 报错 “Your PHP version X.Y.Z does not satisfy that requirement” 怎么办
这不是 Composer 本身的问题，而是 composer.json 里声明的 php 平台版本约束和当前运行环境不一致。Composer 会严格校验 "platform": {"php": "X.Y.Z"} 或 "require": {"php": "^8.1"} 这类字段。
常见错误现象：
– 执行 composer install 或 composer update 时直接中断，提示类似 Your PHP version 7.4.33 does not satisfy that requirement
– 即使本地 PHP 版本够新，但 Docker 容器或 CI 环境中用的是旧版，也会触发
- 先确认真实 PHP 版本：
php -v，注意 CLI 和 Web SAPI 可能不同，Composer 默认走 CLI - 检查
composer.json中的require.php和config.platform.php字段，后者优先级更高 - 临时绕过校验（仅限开发/调试）：
composer install --ignore-platform-req=php；但不要提交到生产流程 - 长期方案是统一环境：升级 PHP 或降级项目依赖要求，而非“骗过”Composer
想降级 Composer 本身（比如从 v2 退回 v1），但 composer self-update --1 失败
v2 是 2020 年底起的默认版本，v1 已停止维护。官方不再支持通过 self-update 回退，强行执行会报错 Could not fetch https://getcomposer.org/versions 或提示 no stable version
- 最稳妥方式：手动下载指定版本 Phar：
curl -sS https://getcomposer.org/installer | php -- --version=1.10.22（替换为你需要的 v1.x 最后一个 tag） - 验证是否生效：
php composer.phar --version，注意别覆盖系统级composer命令，建议重命名或用alias - v1 不支持
platform-check、composer.lock格式也不同，混用会导致composer install出错或依赖解析异常 - CI 中若需固定 Composer 版本，推荐用
COMPOSER_VERSION=1.10.22 curl -sS https://getcomposer.org/installer | php，避免依赖全局安装状态
为什么降级 Composer 不能解决 PHP 版本不匹配问题
很多人误以为“换旧版 Composer 就能装旧版包”，其实 Composer 版本只影响依赖解析逻辑和 lock 文件格式，不改变对 PHP 运行环境的校验行为。v1 和 v2 都会读取 require.php 并比对当前 PHP_VERSION
立即学习“PHP免费学习笔记（深入）”；
- v1 的校验更宽松（比如忽略
platform.php），但这属于 bug 行为，不是设计意图 - 真正起作用的是
config.platform.php—— 它可伪造平台环境，让 Composer 认为“当前 PHP 是 8.1”，即使实际是 7.4 - 但伪造有风险：如果依赖里用了 PHP 8.1 特性（如枚举、
match表达式），运行时直接 fatal error，Composer 不会帮你检测这个 - 所以与其降级 Composer，不如明确声明目标平台：
composer config platform.php 7.4.33，然后跑composer update --lock
CI/CD 中 PHP 版本和 Composer 行为不一致的典型坑
GitHub Actions、GitLab CI 常用 setup-php 或 php-build 动态切换 PHP 版本，但 Composer 缓存、全局配置、甚至 composer.lock 里的 PHP 约束可能残留旧值
- 每次 job 开头加
composer clear-cache，否则可能复用上一次的 vendor 解析结果 - 禁用平台检查仅限单次命令：
composer install --no-scripts --ignore-platform-reqs，但要清楚后果 - 如果项目必须支持多 PHP 版本，
composer.json中的require.php应写成范围（如^7.4 || ^8.0），而不是硬写^8.1 -
composer.lock里记录了依赖对应的 PHP 兼容性快照，换 PHP 版本后最好重新composer update --lock，而不是直接install
最常被忽略的一点：很多团队把 platform.php 写死在 composer.json 里，却没同步更新 CI 脚本中的 PHP 安装版本，导致本地能过、CI 必挂。环境一致性不是靠降级工具来凑，而是靠显式声明 + 自动化校验。
