正确做法是使用 config.platform 设置目标平台或通过 –ignore-platform-req=扩展名 忽略特定扩展检查，避免使用不存在的 allow-extra-packages 配置。
composer 默认会检查扩展依赖是否与当前运行环境匹配，比如某些 php 扩展只支持特定平台（如 ext-zip 在 windows 或 linux 下行为不同）。当你想在非目标平台安装包时（例如在 macOS 上为 Linux 环境构建），可能需要跳过这些平台相关的依赖检查。
使用 platform.config.allow-extra-packages
这不是正确的方法。实际上，Composer 并没有 allow-extra-packages 这个配置项用于跳过平台检查。正确的做法是使用 platform 配置来模拟或忽略平台需求。
通过 config.platform 设置模拟平台
你可以在 composer.json 中手动设置 config.platform，告诉 Composer 你期望的运行环境，这样它就不会因为当前系统缺少某个平台特有的扩展而报错。
例如，你想在 macOS 上安装本应运行在 Linux 的项目，并忽略某些扩展检查：
{ "config": { "platform": { "php": "8.1.0", "ext-some-ext": "1.0" } } }
这样做后，即使你的本地没有 ext-some-ext，Composer 也会认为它已存在。
使用 –ignore-platform-reqs 或 –ignore-platform-req
这是最直接的方式。使用命令行参数跳过平台依赖检查：
- –ignore-platform-reqs：忽略所有平台需求（PHP 版本、扩展等）
- –ignore-platform-req=ext-name：仅忽略指定的扩展检查，更安全
示例：
# 忽略所有平台限制 composer install --ignore-platform-reqs <h1>仅忽略 ext-rar 扩展的检查</h1><p>composer install --ignore-platform-req=ext-rar
推荐使用 --ignore-platform-req=ext-xxx 单独忽略特定扩展，避免跳过 PHP 版本等关键检查。
在 CI/CD 或 docker 构建中合理使用
在生产构建环境中，建议只在必要时使用 --ignore-platform-req，并在 composer.json 中明确声明目标平台：
"config": { "platform": { "php": "8.1.10" } }, "require": { "ext-zip": "*", "ext-pcntl": "*" }
然后运行：
composer install --ignore-platform-req=ext-pcntl
因为 pcntl 通常只在 Linux 下可用，在 macos 或 windows 上可选择性忽略。
基本上就这些。关键是根据场景选择全局忽略还是局部忽略，优先使用 --ignore-platform-req=扩展名 更安全。