应使用 config.platform 在 composer.json 中伪造扩展存在，如 "ext-pcntl": "1"，仅影响依赖解析；--ignore-platform-reqs 会全局跳过所有平台检查，风险高，应改用 --ignore-platform-req=ext-gd 精确忽略。
用 config.platform 声明“扩展已存在”
Composer 不会读取你系统里实际装了什么扩展，它只看 composer.json 里的 require 和当前环境是否匹配。想让它“相信”某个扩展已启用，唯一有效方式是在项目级配置中伪造平台能力——即在 composer.json 的 config.platform 下写明该扩展及其版本。
这个配置不改 PHP 环境，也不加载扩展，纯粹是告诉 Composer：“别查了，就当它在。” 它只影响依赖解析阶段，对运行时无任何作用。
-
config.platform必须放在项目根目录的composer.json中，全局配置（composer config -g）或~/.composer/config.json里的同名字段完全无效 - 版本号填什么不重要，只要非空且格式合法（如
"1"、"8.2.0"、"0.0.0"），Composer 就不再报缺失 - 示例：若需让 Composer 认为
ext-pcntl和ext-redis已安装，加如下配置：
{
"config": {
"platform": {
"ext-pcntl": "1",
"ext-redis": "5.3.7"
}
}
}
改完后执行 composer install 或 composer update，相关扩展检查就会跳过。
为什么不能用 --ignore-platform-reqs 代替？
--ignore-platform-reqs 是全局断路器，不是选择性开关。它会同时跳过 PHP 版本、所有 ext-*、lib-* 甚至架构检查，极易导致装上根本跑不动的包。
比如你只想绕过 ext-gd，却用了 --ignore-platform-reqs，结果 Composer 还放过了 ext-sodium 缺失 —— 而你的代码里有 new SodiumException()，上线直接 fatal error。
- 真正想只跳过某个扩展，必须用
--ignore-platform-req=ext-gd（注意是req，不是reqs） - 拼写必须严格：写成
gd、ext-GD、php-gd都静默失效 - 忽略多个扩展得重复参数：
--ignore-platform-req=ext-gd --ignore-platform-req=ext-mbstring，不能逗号分隔
如何确认伪造生效？
加完 config.platform 后，运行 composer check-platform-reqs。它会列出所有未满足项 —— 如果你伪造的扩展不再出现在列表里，说明配置已起效。
如果仍报错，常见原因包括：
- 错误信息里写的缺失项，其实不是你伪造的那个，而是别的扩展（如
lib-xml）或间接依赖带进来的（比如laravel/octane要求ext-swoole） - 用了
composer update而非install：update 会重新解析整棵树，可能把 lock 文件里原本兼容的版本升级成新版本，而新版本又加了额外扩展要求 - CI 构建中混用了命令行参数和
config.platform，导致行为不一致；建议统一用一种方式，避免叠加干扰
最容易被忽略的一点
无论用 config.platform 还是 --ignore-platform-req，都只是让 Composer 装得下去，不代表代码能跑起来。比如你伪造了 ext-redis，但生产环境没装 Redis 扩展，运行时调用 new Redis() 仍会抛出 Class 'Redis' not found。
上线前必须验证真实环境是否启用了这些扩展，否则问题会拖到服务启动那一刻才暴露，堆栈远不如 Composer 报错清晰。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
