如何让 Composer 忽略对 ext-pcntl 等特定平台扩展的检查？

Composer 提供三种跳过 PHP 扩展检查的方法：一、在 composer.json 的 config.platform 中伪造扩展版本；二、用 --ignore-platform-req 或 --ignore-platform-reqs 参数临时忽略；三、通过 composer depends 定位并移除 require-dev 中的伪依赖。

Composer 默认会检查项目所需 PHP 扩展是否已启用，比如 ext-pcntl、ext-posix 等——这些在 Windows 或某些容器环境中不可用或不必要。若你确定项目运行时并不实际依赖它们（例如仅用于开发工具的可选功能），可通过配置跳过这类平台相关扩展的检查。

方法一：使用 platform 配置伪造扩展存在

在 composer.json 的 config 段中设置 platform，告诉 Composer “这些扩展已安装”，从而绕过真实环境检测：

• 编辑 composer.json
• 添加或修改 config 块：

Composer 会把它们当作已启用的扩展处理，不再报错。注意版本号可任意填写（如 "0" 或 "1.0.0"），只要格式合法即可，它不校验真实性。

方法二：临时禁用平台检查（适合 CI/部署）

运行 composer install 或 update 时加 --ignore-platform-req 参数：

• 忽略单个扩展：--ignore-platform-req=ext-pcntl
• 忽略全部扩展：--ignore-platform-req=ext-*
• 忽略所有平台要求（含 PHP 版本）：--ignore-platform-reqs

推荐在 Docker 构建或 CI 脚本中使用，避免污染本地 composer.json。例如：

标签： composer 平台扩展 php laravel js json docker windows 工具 win