使用 --ignore-platform-reqs 跳过平台限制，或指定 --ignore-platform-req=ext-gd 精准忽略；create-project 时同样适用该参数，但需事后验证兼容性。
composer install 时提示 platform requirements mismatch 怎么办
这是最常见场景：本地 PHP 版本或扩展（如 ext-gd、ext-mbstring）不满足 composer.json 中 config.platform 或依赖包的 require 声明，导致安装中断。
本质不是“跳过检查”，而是让 Composer 忽略当前运行环境与目标平台的不匹配——适用于你明确知道环境差异不影响实际运行（比如本地开发用 PHP 8.3，但部署环境是 PHP 8.1，而项目确实兼容）。
- 加
--ignore-platform-reqs参数：跳过所有平台限制（PHP 版本、扩展、INI 设置），最粗暴有效 - 加
--ignore-platform-req=ext-gd：只忽略特定扩展，更安全，适合个别缺失扩展但确定可用的情况 - 不推荐长期在 CI/CD 或部署脚本中使用
--ignore-platform-reqs，它会掩盖真实兼容性风险
composer create-project 被平台限制卡住怎么办
新建项目时（尤其用 Laravel、Symfony 等模板），create-project 默认也会校验平台要求。如果本地 PHP 版本低于模板要求的最低版本，命令直接失败。
这时不能靠修改 composer.json（还没生成），必须在命令行显式绕过：
- 执行
composer create-project laravel/laravel myapp --ignore-platform-reqs - 生成后建议立刻检查
composer.json中的require.php和扩展依赖，确认是否真能跑通 - 若项目含
config.platform，它优先级高于全局环境，--ignore-platform-reqs同样生效
为什么 --ignore-platform-reqs 有时没用
不是参数失效，而是你遇到的其实不是平台限制问题。常见混淆点：
- 错误信息含
Root composer.json requires...+ 版本冲突 → 这是依赖版本无法解析，和平台无关，需用composer why-not vendor/package:version查原因 - 报错是
Could not parse version constraint→ 配置语法错误，不是平台问题 - 用了
composer update --with-all-dependencies却仍被拦 → 某些旧版 Composer（--ignore-platform-reqs 支持不一致，升级到composer self-update最新版再试
CI 环境里怎么安全地绕过平台检查
CI 流水线（如 GitHub Actions、GitLab CI）常因基础镜像 PHP 版本低或缺扩展报错。这里的关键是：别无脑加 --ignore-platform-reqs，先确认是否真有必要。
- 优先用匹配的 PHP 镜像，例如 Laravel 11 要求 PHP 8.2+，就选
php:8.2-cli镜像 - 确需忽略时，在
composer install步骤加--ignore-platform-reqs，但务必同时加--no-interaction --no-progress避免意外交互中断 - 如果只是缺扩展（如
ext-redis），CI 中装扩展比忽略更可靠：docker-php-ext-install redis
真正容易被忽略的是：有些包的平台限制藏在 require-dev 里，而 composer install 默认不装 dev 依赖；但如果你开了 --with-all-dependencies 或 COMPOSER_DEV=true，那些 dev 里的平台约束就会突然生效。
