全局配置 ignore-platform-reqs 无效？别配错位置
Composer 没有真正意义上的「全局 ignore-platform-reqs」开关。所谓“全局配置”，实际是指在用户级配置文件中设置 platform-check 为 false，从而绕过平台依赖检查——但这个行为仅对 composer install 和 composer update 生效，且必须配合 --ignore-platform-reqs 命令行参数或显式启用，否则不触发。
-
composer config -g platform-check false是最接近“全局生效”的操作，它写入~/.composer/config.json - 该设置不会让
composer install自动跳过检查，仍需加--ignore-platform-reqs - 若项目
composer.json中已声明"platform"字段，它会覆盖全局设置 - CI/CD 环境中建议用环境变量
COMPOSER_IGNORE_PLATFORM_REQS=1替代配置，更可控
composer.json 里怎么写才能跳过特定扩展依赖
比起全局忽略，更安全的做法是在项目级精准控制：用 platform 字段“伪造”已安装的扩展或 PHP 版本，让 Composer 认为环境满足要求。
{
"config": {
"platform": {
"php": "8.2.0",
"ext-gd": "8.2.0",
"ext-mbstring": "8.2.0"
}
}
}
-
platform下列出的扩展名必须和composer show --platform输出一致（如ext-curl，不是curl） - PHP 版本填你目标运行环境的版本，不是本地开发机的版本
- 该配置只影响当前项目，不会干扰其他项目，适合多项目混用不同 PHP 扩展组合的场景
- 注意：伪造未真实安装的扩展，运行时仍会报
Class not found或Call to undefined function
为什么 --ignore-platform-reqs 在 CI 上突然失效了
常见原因是 Composer 版本升级后默认行为收紧。从 Composer 2.2 开始，--ignore-platform-reqs 不再跳过 ext-* 类扩展检查，除非同时指定 --ignore-platform-reqs=ext（2.5+）或使用 COMPOSER_IGNORE_PLATFORM_REQS=1 环境变量。
- GitHub Actions 中推荐写法：
COMPOSER_IGNORE_PLATFORM_REQS=1 composer install - Docker 构建时，在
Dockerfile中加ENV COMPOSER_IGNORE_PLATFORM_REQS=1 - 若用
composer update --ignore-platform-reqs仍报错，检查是否用了--with-all-dependencies，它可能重新激活平台检查 - 某些私有仓库插件（如
composer/installers）会在钩子中主动校验平台，此时忽略参数无效，需查插件文档
忽略平台要求后，autoload 和 classmap 还可靠吗
可靠，但仅限于代码加载层面。Composer 的自动加载器（vendor/autoload.php）完全不关心 PHP 版本或扩展是否存在，它只按 PSR-4/PSR-0 规则注册命名空间路径。问题出在运行时——一旦某行代码调用了被忽略的扩展函数（比如 gd_info()），就会直接 fatal error。
- 建议在入口文件或服务启动时补一手运行时检测：
extension_loaded('gd')或function_exists('imagecreate') - 如果项目用到了
symfony/polyfill，它会自动 fallback 到纯 PHP 实现，此时忽略扩展反而更安全 -
composer dump-autoload --optimize生成的classmap不受平台设置影响，但若类内部依赖缺失扩展，autoload 成功也无济于事
真正容易被忽略的是：平台忽略只解决「安装阶段」的依赖冲突，不解决「运行阶段」的功能缺失。上线前务必在目标环境中验证关键扩展是否真实可用。
