应优先确认是否真需忽略平台要求：若因锁文件过期导致PHP版本冲突，运行composer update --lock；若仅缺非必需扩展（如ext-redis），再用--ignore-platform-reqs=ext-name临时跳过。
composer install 时提示 platform requirements mismatch 怎么办
这是最常见触发忽略平台检查的场景：本地 PHP 版本或扩展（如 ext-mbstring）和 composer.json 中声明的 platform 或依赖包要求不匹配，导致安装中断。
别急着加全局忽略参数——先确认是不是真要绕过。比如你用 PHP 8.3，但 composer.lock 里某包锁定了只支持到 8.2，那可能是锁文件过期，composer update --lock 更安全；但如果只是开发环境缺某个扩展（如没装 ext-redis），而你确定运行时不依赖它，才考虑临时跳过。
- 优先尝试
composer install --ignore-platform-reqs（仅本次生效，不写入配置） - 避免用
--ignore-platform-reqs配合composer update，否则可能装上根本不兼容的版本 - 若需长期忽略某一项（比如始终不校验
php版本），在composer.json里加："config": { "platform": { "php": "8.0.0" } }——这相当于“假装”自己是 8.0，比全局忽略更精准
composer create-project 跳过 ext-* 检查的实操要点
用 create-project 拉框架（如 Laravel、Symfony）时，常因缺少扩展（ext-zip、ext-pdo）直接失败。这些扩展通常只在运行时需要，而 create-project 只是解压+安装依赖，没必要硬拦。
关键区别在于：不是所有 platform 项都该被忽略。php 版本错可能引发后续运行崩溃，但缺 ext-gd 只影响图片处理功能，风险可控。
- 只忽略具体缺失的扩展：例如
composer create-project laravel/laravel --ignore-platform-reqs=ext-gd,ext-mbstring -
--ignore-platform-reqs后不带值 = 忽略全部；带逗号分隔列表 = 只忽略列出的项 - 注意拼写：必须和
php -m输出的扩展名一致，比如是ext-curl，不是curl或php-curl
为什么 vendor/bin/xxx 执行报错还跟 platform ignore 有关
有些命令行工具（如 phpunit、larastan）本身是依赖包里的可执行文件，它们的 require 里可能写了 "php": "^8.1"。即使你项目能装上，运行时仍可能因 PHP 版本不满足被拒绝执行——这不是 Composer 安装阶段的问题，而是这些工具启动时自己做的校验。
这时候 --ignore-platform-reqs 已经没用了，得看工具自身是否提供跳过方式（比如 phpunit --no-configuration 不加载某些检查），或者降级工具版本（改 composer.json 的 require-dev 版本约束）。
- 运行时报
PHP Version requirement mismatch，大概率是工具自检，不是 Composer 问题 - 用
composer show vendor/tool-name查看其require字段，确认是否真有冲突 - 不要为了跑通命令就盲目降级 PHP，先查文档看该工具最低支持版本
CI 环境里忽略 platform 的隐藏风险
GitHub Actions 或 GitLab CI 里加 --ignore-platform-reqs 很常见，但容易掩盖真实环境差异。比如本地 PHP 8.2 + ext-xml，CI 用 8.1 且没装 ext-xml，靠忽略参数强行通过，结果部署后 XML 解析直接报错。
真正健壮的做法是让 CI 环境尽量贴近生产，而不是靠忽略来“糊弄”安装流程。
- GitHub Actions 中用
shivammathur/setup-php显式指定版本和扩展：with: php-version: '8.2' extensions: mbstring, xml, curl
- 如果必须忽略，请限定范围：只在
composer install阶段用，绝不用于composer update或生成新 lock 文件 - CI 日志里搜
ignored platform requirements，一旦出现，说明环境配置有缺口，该补而不是惯着
实际项目里，最麻烦的不是怎么忽略，而是忽略之后没人再回头核对：那个被跳过的 ext-imagick 到底有没有在生产环境装上？有没有人记得上线前验证图片缩略图功能？这种事一漏，就是凌晨三点的告警。
