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 块：

```json
{
"config": {
"platform": {
"ext-pcntl": "8.2.0",
"ext-posix": "8.2.0"
}
}
}```

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

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

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

Docker Image Puller

使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。

下载

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

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

```bash
composer install --no-interaction --ignore-platform-req=ext-pcntl --ignore-platform-req=ext-posix```

方法三：移除或调整 require-dev 中的“伪依赖”

有时 ext-pcntl 是由某个开发依赖（如 symfony/console 或调试工具）间接声明的。检查 composer.json 的 require-dev，确认是否真需要该扩展：

• 运行 composer show --platform 查看当前平台支持的扩展
• 运行 composer depends ext-pcntl（需 Composer 2.5+）定位谁在要求它
• 若只是可选能力，考虑升级到不强制依赖它的版本，或用 replace 声明替代

例如，某些旧版 Laravel Dusk 或 Queue 监控工具会硬依赖 ext-pcntl，升级后可能已改为运行时检测。

基本上就这些。优先用 platform 配置保持可重现性；CI 场景用 --ignore-platform-req 更灵活；长期来看，清理不必要的扩展依赖最干净。