应使用--ignore-platform-req=ext-xxx精准跳过单个扩展检查，参数须严格匹配composer.json中require键名、大小写敏感且不可省略ext-前缀；忽略多个需重复书写该参数。
Composer 镜像本身不处理 PHP 扩展检查，它只加速包下载；扩展兼容性问题必须在依赖解析阶段解决，而非镜像配置环节。
composer config -g repo.packagist 无法跳过 ext-* 限制
很多人误以为换镜像就能绕过 ext-gd、ext-intl 这类扩展报错，其实镜像只管“从哪下”，不管“能不能装”。composer install 卡在 ext-* 报错，说明 Composer 正在做平台兼容性校验，这一步发生在依赖解析（Resolving dependencies）阶段，和镜像源完全无关。
- 镜像生效后，
Downloading变快，但Resolving dependencies仍慢或失败 → 一定是平台约束问题，不是镜像没配对 -
repo.packagist配置再正确，也无法让 Composer 忽略你没装ext-redis - 验证方式：运行
composer config -g repo.packagist看输出是否为{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}；若正确，就可排除镜像问题
--ignore-platform-req=ext 是最常用且安全的绕过方式
比起全局忽略所有平台要求（--ignore-platform-reqs），单独跳过扩展检查更可控，既保留 PHP 版本校验，又避免因漏装扩展导致运行时 fatal error。
- 开发环境执行：
composer install --ignore-platform-req=ext - CI 脚本中推荐显式指定：
composer install --no-dev --prefer-dist --ignore-platform-req=ext - 如果只想忽略某几个特定扩展，可重复使用参数：
--ignore-platform-req=ext-gd --ignore-platform-req=ext-mbstring - 注意：该参数仅影响
install和update，不影响require命令的交互式版本约束提示
项目级 platform 配置比命令行参数更适合长期协作
把平台约束写进 composer.json，能让团队成员和 CI 环境行为一致，避免有人忘加 --ignore-platform-req=ext 导致构建失败。
- 在项目根目录执行：
composer config platform.ext-gd "8.1.0"（表示“假装已安装 gd 扩展”） - 也可一次性模拟多个扩展：
composer config platform.ext-intl "8.1.0" && composer config platform.ext-opcache "8.1.0" - 生成的配置会写入
composer.json的config.platform字段，Git 提交后即生效 - 缺点：不能“假装未安装”某个扩展（比如禁用
ext-xdebug），只能模拟存在；如需彻底屏蔽，仍得用--ignore-platform-req
宝塔/CI 中 composer install 仍报 ext 错误？检查运行用户和 php.ini 实际加载路径
即使你在终端用 root 配好了 --ignore-platform-req=ext，宝塔后台或 GitLab Runner 仍可能失败——因为它们用的是 www 或 runner 用户，而该用户启动的 PHP 进程可能加载了另一份 php.ini，里面禁用了关键扩展。
- 在宝塔面板里，进入对应 PHP 版本的“配置文件”，确认
extension=gd等行未被注释 - 在 CI 脚本中加一行诊断：
php -i | grep "Loaded Configuration File"，看实际读的是哪个php.ini - 某些 Docker 环境默认不启用
curl或mbstring，需在Dockerfile中显式安装对应扩展包（如docker-php-ext-install curl mbstring） - 宝塔用户常漏掉
putenv被禁用的问题，会导致 Composer 插件无法设置环境变量，间接触发扩展检测失败；需在 PHP 管理 → 禁用函数中移除putenv
镜像配置和扩展处理是两条平行线：前者解决“下载慢”，后者解决“装不上”。最容易被忽略的是——你以为换完镜像就万事大吉，结果卡在 Resolving dependencies 十几分钟，其实根本没走到下载那步。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
