使用 --ignore-platform-reqs 可让 Composer 忽略 PHP 版本或扩展等平台依赖检查，强制安装依赖，适用于开发或 CI/CD 环境中临时绕过限制，但可能引发运行时错误，建议仅在非生产环境使用，并确保目标环境满足实际依赖。

在使用 Composer 安装或更新 PHP 依赖时，有时会遇到因 PHP 版本或扩展缺失导致的平台需求冲突。这时可以使用 --ignore-platform-reqs 参数跳过这些检查，强制进行安装。

什么是 --ignore-platform-reqs

该选项告诉 Composer 忽略当前环境的平台依赖（如 PHP 版本、PHP 扩展等），不验证它们是否存在或是否符合要求。Composer 只根据 composer.json 中的逻辑依赖关系来解析和安装包。

适合在以下情况使用：

• 开发环境中缺少某些扩展，但生产环境已具备
• 临时测试某个包，即使当前 PHP 版本略低
• CI/CD 环境中需要绕过特定限制

如何使用 --ignore-platform-reqs

在常用 Composer 命令后添加该参数即可：

例如，你的项目要求 PHP 8.1，但当前环境是 PHP 8.0，加上这个参数后 Composer 将不会报错“Your PHP version (8.0.0) is not compatible”。

注意事项与风险

虽然这个选项很实用，但需谨慎使用：

• 忽略平台要求可能导致安装的包在运行时报错或功能异常
• 某些扩展（如 ext-mbstring、ext-pdo）缺失会导致应用崩溃
• 建议仅用于开发或构建阶段，不要在生产部署中依赖此方式
• 更好的做法是通过 config.platform 模拟目标环境，而不是完全忽略检查

如果只想忽略特定扩展而非全部平台要求，可使用 --ignore-platform-req=ext-name，例如：

基本上就这些。用好这个参数能解决不少兼容性问题，但也别滥用，确保最终运行环境满足实际依赖。