应使用 --ignore-platform-reqs 或更精准的 --ignore-platform-req=ext-xyz 绕过PHP扩展缺失报错；CI中建议配合 config.platform 模拟目标环境，避免lock文件污染和autoload异常。
composer install 报错 “The requested PHP extension xyz is missing” 怎么绕过
这是最常见也最容易误操作的场景：本地开发用 PHP 8.2，但 composer.json 声明了 "ext-xyz": "*"，而 CI 或测试环境没装这个扩展，composer install 直接失败。
真正该用的是 --ignore-platform-reqs，但它不是“忽略所有”，而是跳过对 PHP 版本、扩展、架构等平台约束的校验。别用 --no-scripts 或删 platform 配置来凑合——那会掩盖真实依赖问题。
-
composer install --ignore-platform-reqs仅跳过校验，不改 lock 文件，也不影响 autoloader 生成 - 如果只想忽略某一个扩展（比如
ext-igbinary），用--ignore-platform-req=ext-igbinary更精准 - CI 中慎用全局
--ignore-platform-reqs；建议配合platform配置模拟目标环境，比如在composer.json里加："config": { "platform": { "php": "8.1.0", "ext-gd": "8.1.0" } }
为什么 vendor/autoload.php 加载失败，和 platform 设置有关
很多人以为 --ignore-platform-reqs 只影响安装阶段，其实它间接导致 autoloader 生成异常——尤其当被忽略的扩展是某些包的运行时硬依赖（如 ext-mbstring 被 symfony/polyfill-mbstring 替代，但 polyfill 又被条件加载逻辑绕过）。
根本原因是：Composer 在生成 autoload rules 时，会读取已安装包的 autoload 和 require 字段；如果因平台忽略装了本不该装的版本（比如 PHP 8.2 下装了只兼容 7.4 的 monolog/monolog v1），autoload 就可能漏掉关键文件或触发 fatal error。
- 检查
vendor/composer/autoload_classmap.php是否包含你预期的类路径 - 运行
composer dump-autoload -o强制重生成，比反复install更快定位 autoload 问题 - 若用
classmap或psr-4自动加载，确保对应目录真实存在且权限正常；--ignore-platform-reqs不会修复路径错误
composer create-project 忽略平台限制的正确姿势
create-project 默认严格校验平台，但它的 --ignore-platform-reqs 行为和 install 不完全一致：它会跳过对目标项目 composer.json 中 platform 的检查，但不会跳过对自身依赖（比如 composer/composer）的平台要求。
典型翻车点：用 PHP 8.3 运行 create-project laravel/laravel myapp，而 Laravel 10 的 composer.json 锁死了 "php": "^8.0.2" ——这时加 --ignore-platform-reqs 才真能过，否则报 Your requirements could not be resolved。
- 命令写全：
composer create-project laravel/laravel myapp --ignore-platform-reqs - 如果还要指定版本，把
--ignore-platform-reqs放最后，避免被解析成项目参数：composer create-project laravel/laravel:^10.0 myapp --ignore-platform-reqs - 注意：
--remove-vcs和--no-install可以共存，但--ignore-platform-reqs必须显式带上，它不会继承全局 config
platform 配置写错会导致 lock 文件永久污染
很多人在 composer.json 的 config.platform 里填错 PHP 版本（比如写成 "php": "8.1" 而不是 "php": "8.1.0"），结果 composer update 生成的 composer.lock 会记录基于错误平台选出来的包版本。之后哪怕删掉 platform 配置，lock 文件也不会自动回退——除非手动删 lock 再重装。
更隐蔽的问题是：platform 不仅影响 php，还影响 ext-* 和 lib-*；比如填了 "ext-intl": "1.0.0"，但实际环境是 intl 7.4，某些包的 feature detection 就会失效。
- 查当前生效的 platform 值：运行
composer config platform（显示整个对象）或composer config platform.php - 清空 platform 配置：
composer config --unset config.platform，而不是手动删 JSON 字段后忘记composer update --lock - 临时覆盖 platform 只用于当前命令：
COMPOSER_PLATFORM_CHECK=0 composer install（这个环境变量优先级高于 config）
