必须用--ignore-platform-req=ext-redis精准跳过单个扩展检查，前缀ext-和大小写须严格匹配composer.json中声明的键名，不可省略或误写为redis、Ext-Redis等。
怎么用 --ignore-platform-req=ext-xxx 精准跳过单个扩展检查
想跳过某个扩展（比如 ext-redis）的安装前校验，必须用 --ignore-platform-req=ext-redis，不能省略 ext- 前缀，也不能写成 redis 或 Ext-Redis——大小写和前缀都严格匹配 composer.json 中 require 里声明的键名。
常见错误现象：Required platform extensions missing: redis，但加了参数仍失败，大概率是因为：
- 报错实际是
ext-swoole缺失，而你只忽略了ext-redis -
composer.json没写ext-redis，但某个依赖（如laravel/octane）间接要求了它，得用composer depends ext-redis定位源头 - 用了
composer update而非composer install—— 前者会重新解析整棵树，更容易触发未忽略的间接依赖
为什么不要用 --ignore-platform-reqs 全局关检查
--ignore-platform-reqs 会一并跳过所有平台项：PHP 版本、ext-gd、ext-mbstring、lib-curl 等。它不是“选择性绕过”，而是直接关闭整套校验机制。
后果很实在：
- CI 构建成功，但上线后第一次调用
new Redis()就Fatal error: Class 'Redis' not found -
composer update --ignore-platform-reqs可能把依赖升级到真不兼容的版本（比如把只支持 PHP 8.2 的包装进 PHP 7.4 环境） - 掩盖真实环境问题，等运行时暴露，堆栈远不如 Composer 安装时报错清晰
真正需要的是控制粒度：只放行你知道能接受风险的项，其余照常校验。
如何用 config.platform 在项目内伪造扩展存在
如果频繁在 CI 或 Docker 构建中跳过同一组扩展，与其每次敲长命令，不如在项目根目录的 composer.json 的 "config" 段里加 "platform"：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"config": {
"platform": {
"ext-redis": "5.3.7",
"ext-gd": "8.1.0"
}
}
}
这个配置的效果是告诉 Composer：“这些扩展已安装”，版本号填什么都行（甚至填 "1" 也有效），但它不会让 PHP 真加载扩展，纯属骗过依赖解析器。
注意：
- 只影响当前项目，不污染全局或其他项目
-
composer install和composer update都自动生效 - 上线前必须确认生产环境真实启用了这些扩展，否则服务启动时才爆错
CI/CD 脚本里该选命令行参数还是改 composer.json
Docker 构建或 GitHub Actions 中，优先用命令行参数临时绕过，而不是往 composer.json 里硬塞 platform 配置——后者容易污染开发环境，且把兼容性兜底责任从工具移交到人。
推荐写法：
composer install --no-interaction --prefer-dist --ignore-platform-req=ext-pcntl --ignore-platform-req=ext-posix
再叠加 --no-scripts 很关键：防止 post-install-cmd 因调用 pcntl_fork() 等缺失函数而崩溃。
最容易被忽略的一点：--ignore-platform-req=ext-xxx 只解决安装卡住的问题，不等于项目能跑。它不装扩展，也不改 PHP 配置，只是让 Composer 别拦着你继续往下走。
