应使用 config.platform 声明式模拟缺失的 php 版本和扩展，而非禁用检查；需在 composer.json 中精确配置 php 和 ext-{name} 版本，删除 vendor/ 和 composer.lock 后重新 install。
composer install 时提示 platform-check 失败怎么办
直接禁用 platform-check 不是推荐做法，但如果你明确知道环境兼容、只是 PHP 或扩展版本不被 Composer 默认策略接受，可以用 config.platform 做“声明式绕过”。它不是关闭检查，而是告诉 Composer：“我承诺这些平台依赖在运行时存在”。
常见错误现象：Your requirements could not be resolved to an installable set of packages. 后跟一堆 platform-check 相关提示，比如 The requested PHP extension ext-redis is missing from your system，但其实你确认 redis 扩展已启用（只是没被 Composer 自动发现）。
- 使用场景：CI/CD 构建镜像中 PHP 版本与本地开发不一致；Docker 容器里扩展路径特殊导致
php -m检测失败；共享主机上无法安装某些扩展但实际由 web server 提供 - 不要用
--ignore-platform-reqs临时跳过——它绕过所有检查，包括真正危险的不兼容（如 PHP 8.3 装只支持 PHP 7.4 的包） -
config.platform是更安全的替代：你只“模拟”缺失的平台信息，其他依赖约束照常生效
怎么设置 config.platform 禁用特定平台检查
在项目根目录的 composer.json 中添加或修改 config.platform 字段，列出你要“假装存在”的 PHP 版本和扩展。
示例：你用 PHP 8.2，但 Composer 报错说缺 ext-igbinary 和 ext-redis，而你知道它们已加载：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
{
"config": {
"platform": {
"php": "8.2.10",
"ext-igbinary": "3.2.13",
"ext-redis": "5.3.7"
}
}
}
-
php字段必须写全版本号（如"8.2.10"），不能写"^8.2"或"8.2"，否则无效 - 扩展名格式严格为
ext-{name}，版本号填你php -i | grep -A1 'redis version'实际看到的（或留空字符串""表示“存在但不校验版本”） - 设完后要删掉
vendor/和composer.lock，再跑composer install，否则 lock 文件仍含旧平台约束
config.platform 和 --ignore-platform-reqs 的关键区别
两者效果表面相似，但机制和风险完全不同。
-
--ignore-platform-reqs是命令行开关，跳过所有平台相关检查（PHP 版本、扩展、INI 设置），适合调试，**绝不该提交到 CI 脚本或长期使用** -
config.platform是声明式配置，只覆盖你明确列出的项，其余平台约束（比如包要求"ext-json": "*"）依然生效 - 性能影响几乎为零；兼容性上，
config.platform自 Composer 1.0 起就支持，无版本顾虑 - 容易踩的坑：把
config.platform.php设成低于你实际 PHP 版本（如设成"7.4"却用8.2运行），会导致装错兼容性更低的旧版包
为什么 composer update 不受 config.platform 影响？
因为 config.platform 只在 install 和 require 时参与依赖解析，update 默认忽略它——这是设计行为，不是 bug。
如果你执行 composer update 后又遇到 platform-check 报错，说明 lock 文件里记录的包版本依赖了你当前未声明的平台能力。
- 解决方法：先删
composer.lock，再跑composer install，让 Composer 基于新config.platform重新解析整个依赖图 - 或者用
composer update --with-all-dependencies+config.platform配合，但不如重装干净 - 别试图在
composer.json里加"config":{"platform-check": false}—— 这个配置项根本不存在
真正麻烦的从来不是怎么关检查，而是搞清哪部分平台信息是 Composer 没识别到、哪部分是你确实漏装了。多看 php -m 和 php --ri redis 输出，比硬关检查管用得多。
