使用 composer install --platform=php:X.Y.Z --platform=ext-xxx:V 可强制 Composer 按目标环境能力解析依赖，绕过本地扩展版本检查；该参数在 install/update 阶段均生效且优先级最高，优于 composer.json 中的 platform 配置。
composer install 时如何指定 PHP 版本以绕过扩展版本检查
Composer 默认读取当前运行环境的 PHP_VERSION 和已加载扩展（如 ext-mbstring、ext-xml）版本，若项目 composer.json 中声明了不兼容的扩展约束（例如 "ext-zip": "^1.2"），而本地 PHP 是 8.3 自带 zip 1.15，则可能报错：Your requirements could not be resolved to an installable set of packages.。这不是要“伪装”PHP 版本，而是让 Composer 在解析依赖时，按目标部署环境（而非当前开发机）的能力做判断。
核心方法是通过 --platform 参数覆盖平台包信息：
-
--platform=php:8.1.20：强制 Composer 认为运行环境是 PHP 8.1.20（影响php自身约束及所有ext-*的隐式兼容性） -
--platform=ext-mbstring:1.2.3：单独指定某个扩展版本，优先级高于--platform=php:推导出的默认值 - 多个
--platform可重复使用，例如：composer install --platform=php:8.2.10 --platform=ext-pdo:8.2.10 --platform=ext-curl:8.2.10
为什么不能只改 composer.json 的 platform 配置
composer.json 中的 "platform" 字段（位于 "config" 下）仅在 composer update 时生效，且只影响根项目的平台包声明，不控制 install 阶段对 lock 文件中已锁定依赖的校验逻辑。也就是说，如果你用高版本 PHP 生成了 composer.lock，再在低版本环境 composer install，即使配置了 "platform"，仍会因实际扩展缺失或版本低而失败。
真正起效的是命令行参数：--platform 会在 install 和 update 两个阶段都强制覆盖运行时平台信息，且优先级最高。
立即学习“PHP免费学习笔记（深入）”；
常见错误：--platform 写错格式或漏掉 ext- 前缀
以下写法全部无效：
-
--platform=mbstring:1.2（缺ext-前缀 → Composer 不识别为扩展） -
--platform=php_version=8.1（等号赋值语法错误，必须用冒号） -
--platform="php:8.1"（引号在 shell 中可能导致空格截断，除非含空格否则不建议加） -
--platform=php:8.1 --platform=ext-mbstring（没写扩展版本 → 被视为“存在但版本未知”，仍可能触发严格约束失败）
正确示例（适配 Laravel 10 要求 ext-mbstring >=8.1，但 CI 环境 PHP 是 8.0.30 + 手动编译的 mbstring 1.4.2）：
composer install --platform=php:8.1.0 --platform=ext-mbstring:1.4.2 --platform=ext-xml:8.0.30
CI/CD 中安全使用 --platform 的注意事项
在 GitHub Actions、GitLab CI 等场景下，--platform 是必要手段，但需注意：
- 它只影响 Composer 的依赖解析与校验，**不改变实际 PHP 运行行为** —— 如果代码调用了 PHP 8.2 新增的函数，即使
--platform=php:8.2，运行时仍会 fatal error - 不要用
--platform掩盖真实兼容性问题；应优先升级目标环境 PHP 或降级依赖包 - 若项目使用
composer require --dev phpunit/phpunit等动态操作，记得同样带上--platform，否则临时安装可能失败 - Docker 构建中，建议把
--platform写进composer install命令，而不是依赖基础镜像的 PHP 版本“恰好匹配”
最易被忽略的一点：某些私有仓库或 Satis 镜像会缓存平台包元数据，若长期使用固定 --platform 参数但未清理 vendor 和 lock，可能因缓存导致旧约束残留 —— 遇到诡异冲突时，先试 composer clear-cache && rm -rf vendor composer.lock 再重装。
