--ignore-platform-reqs 是 Composer 的一个参数，用于忽略 PHP 版本和扩展依赖检查，强制安装包；适用于环境差异或临时调试，但可能导致运行时错误，建议仅应急使用并优先通过 config.platform 配置模拟目标环境。
在使用 Composer 安装或更新 PHP 包时，有时会遇到因 PHP 版本或其他扩展依赖不满足而无法安装的情况。此时可以使用 --ignore-platform-reqs 参数临时忽略平台依赖检查，强制进行安装。
什么是 --ignore-platform-reqs
该选项告诉 Composer 忽略当前系统中 PHP 版本、PHP 扩展（如 ext-gd、ext-curl）等平台级依赖的限制，仅根据包本身的版本约束来安装依赖，而不验证这些依赖是否真的能在当前环境中运行。
注意：这可能会导致安装后运行时报错，因为缺少必要的扩展或 PHP 版本过低，需谨慎使用。如何使用 --ignore-platform-reqs
在执行 composer require、install 或 update 命令时添加该参数：
-
安装依赖时忽略平台要求：
composer install --ignore-platform-reqs -
新增一个包并忽略平台检查：
composer require vendor/package --ignore-platform-reqs -
更新所有依赖忽略平台限制：
composer update --ignore-platform-reqs
适用场景与风险
常见于以下情况：
- 开发环境和生产环境 PHP 配置不同，测试兼容性时临时跳过检查
- 某些包声明了严格的平台依赖，但你确认实际功能可用
- CI/CD 流水线中为了快速构建镜像绕过版本限制
潜在问题包括：
- 安装的包可能在运行时报“Class not found”或“undefined function”，因为所需扩展未启用
- 代码在本地能跑，部署到生产环境出错
- 后续 composer update 可能失败或行为异常
替代方案建议
更安全的做法是调整 platform 配置来模拟目标环境，而不是完全忽略：
"config": {
"platform": {
"php": "8.1.0",
"ext-gd": "enabled"
}
}
这样 Composer 会基于指定的 PHP 版本和扩展进行依赖解析，无需关闭检查机制。
基本上就这些。--ignore-platform-reqs 是个应急工具，适合短期调试，不适合长期用于正式项目依赖管理。
