应使用--ignore-platform-req=php精准跳过PHP版本检查，它仅绕过"php": "^8.1"类声明，不干扰ext-*扩展校验，多个平台项可叠加如--ignore-platform-req=php --ignore-platform-req=ext-gd。
composer install 报错 “PHP version does not satisfy that requirement” 怎么办
这不是 Composer 本身出错，而是它在严格校验你 composer.json 里写的 "php": "^8.2" 和当前 CLI 实际运行的 PHP 版本是否匹配。报错时别急着改配置，先确认真实环境：
- 运行
php -v，看输出是不是你预期的版本（注意：不是 Apache 或 Nginx 里的 PHP，是终端里执行命令用的那个） - 运行
which php，再执行ls -l $(which php)，确认符号链接最终指向的可执行文件没被删或失效 - 检查
composer.json根级require块，找到类似"php": "^8.2"的行——这就是冲突源头
config.platform.php 是“假装有高版本”，不是“让低版本变高版本”
"config": { "platform": { "php": "8.2.0" } } 这个配置只在 composer install 或 update 阶段起作用，它骗的是依赖解析器，不是 PHP 解释器本身。
- 适用场景：你在 PHP 8.1 环境里，但目标部署机是 PHP 8.2，你想提前生成兼容 8.2 的
vendor/和composer.lock - 不适用场景：本地是 PHP 7.4，加了
"php": "8.2.0"后composer install成功了，但一跑就报ParseError: syntax error, unexpected token "enum"——因为enum在 7.4 根本不存在 - 风险点：这个配置不会被子项目继承，每个项目都要单独加；且它对 runtime 完全无影响，只是绕过安装时的约束检查
该用 --ignore-platform-req=php，而不是 --ignore-platform-reqs
--ignore-platform-reqs 是把所有平台检查全关掉，包括 ext-mbstring、ext-xml、ext-gd 等扩展，容易装完就崩；而 --ignore-platform-req=php 只跳过 PHP 版本一项，精准可控。
- 临时调试用：
composer install --ignore-platform-req=php - 如果还缺扩展，再加一个：
composer install --ignore-platform-req=php --ignore-platform-req=ext-gd - CI 或线上环境禁用
--ignore-platform-reqs：它会掩盖真实缺失扩展的问题，导致上线后静默失败
镜像源可能偷偷过滤了 PHP 版本不兼容的包
阿里云镜像本身不校验 PHP 版本，但某些企业私有镜像（如 Nexus、Artifactory）启用了 platform-check 策略，会主动剔除元数据中声明不兼容当前请求 PHP 版本的包版本。
立即学习“PHP免费学习笔记（深入）”；
- 验证方式：执行
composer install -vvv --no-progress，观察日志里请求的 URL 是不是仍指向packagist.org或某个私有地址 - 临时切回官方源测试：
composer config -g repo.packagist https://packagist.org，再composer clear-cache - 如果切回后能装，说明是镜像策略问题，得联系运维关掉
php-version-filter类设置，而不是硬调本地 PHP
最易被忽略的一点：Composer 解析依赖用的是 php -v 显示的版本，但你的应用实际运行时，可能由另一个 PHP（比如 Web SAPI 或 Docker 容器里指定的）加载代码——这两者不一致，才是多数“装得上、跑不了”的根本原因。
