Composer如何处理需要特定PHP ini配置的依赖？ (环境检查)

composer install 报 extension 或 ini 缺失实为 CLI 环境配置问题，需确认 php –ini 路径、php -m 验证扩展，并用 config.platform 声明目标平台约束以绕过解析检查。

Composer install 时提示 extension 或 ini 设置缺失，实际已启用？

Composer 本身不主动校验 PHP ini 配置，但某些包（如 ext-gd、ext-opcache、memory_limit=256M）会在 composer.json 的 require 或 config.platform 中声明环境约束。真正触发报错的是 Composer 内部调用的 extension_loaded() 和 ini_get() —— 它读的是当前 CLI 环境下 php -i 所用的配置，不是 Web 服务器用的 php.ini。

• 运行 which php 和 php --ini 确认 CLI 使用的 php.ini 路径，不是 apache/nginx 的
• 常见陷阱：docker 中 PHP CLI 和 FPM 使用不同 php.ini；Mac M1 上通过 Homebrew 安装的 PHP，CLI 可能加载了 /opt/homebrew/etc/php/8.3/php.ini，而 GUI 工具用的是另一份
• 执行 php -m | grep gd 比看 phpinfo() 更可靠，因为 CLI 和 Web SAPI 加载扩展可能不同

如何让 Composer 跳过某项 ini 检查？

不能“跳过”，但可以“绕过”——本质是让 Composer 认为该条件已满足。最安全的方式是用 config.platform 告诉它“目标环境有这个配置”，适用于部署时无法修改生产环境 ini 的场景（如共享主机）：

{     "config": {         "platform": {             "php": "8.2.10",             "ext-gd": "1",             "ext-mbstring": "1",             "ext-zip": "1",             "memory_limit": "512M"         }     } }

注意：config.platform 不会改变实际运行时行为，只是影响依赖解析。如果运行时真的缺 ext-gd，应用仍会报错，只是 Composer 允许你装上它。

• memory_limit 这类 ini 值必须写成字符串，如 "256M"，不能写 256M（json 解析失败）
• ext-xxx 的值写 "1" 即可，Composer 只检查是否非空
• 不要滥用：本地开发应真实配置好环境，platform 仅用于 CI/CD 或受限部署环境

vendor/bin/xxx 命令启动失败，报 “class not found” 或 “undefined function”？

这往往不是 Composer 安装问题，而是依赖的二进制脚本（如 phpunit、larastan）在运行时动态检查扩展或 ini 设置，而它们继承的是当前 shell 的 PHP 配置。例如 phpunit 启动时检测 opcache.enable_cli=1，但你的 CLI php.ini 里关掉了它。

立即学习“PHP免费学习笔记（深入）”；

• 用 php -d opcache.enable_cli=1 vendor/bin/phpunit 临时覆盖设置
• 更持久的做法：在项目根目录加 php.ini，然后用 php --php-ini ./php.ini vendor/bin/phpunit
• 检查脚本头部的 #!/usr/bin/env php —— 它调用的是默认 php，不会读取项目级配置
• 某些工具（如 psysh）会明确提示缺失的 ini 项，直接按提示补上即可

CI 环境中反复遇到 “Your requirements could not be resolved”？

这不是依赖冲突，而是 Composer 在解析阶段就拒绝继续，因为平台约束不满足。典型日志如：The requested PHP extension ext-gd * is missing from your system.。此时重点不是改 composer.json，而是确保 CI runner 的 PHP 环境完整：

• gitHub Actions：用 shivammathur/setup-php 动作，显式开启扩展：extensions: gd, mbstring, zip
• gitlab CI：在 .gitlab-ci.yml 中用 apt-get install php8.2-gd（debian/ubuntu）或 apk add php82-gd（Alpine）
• 自建 runner：确认 php -m 输出包含所需扩展，且 php -r "echo ini_get('memory_limit');" 返回合理值
• 避免在 before_script 里用 phpenmod —— 它只对 Apache 有效，CLI 无响应

最常被忽略的一点：PHP CLI 的 disable_functions 会拦截 extension_loaded，导致 Composer 认为扩展不存在，即使 php -m 显示已加载。检查 php -i | grep disable_functions。