Composer诊断显示报错怎么解决？内置检测工具使用说明-composer-PHP中文网

composer diagnose仅检查硬性环境前提，报php版本或扩展不匹配即为硬性拦截，须逐条修复：确认php -v与php -m真实输出，启用mbstring/xml/zip/curl/openssl，升级php而非用--ignore-platform-reqs，排查platform伪装、php.ini路径及ssl配置。

composer诊断显示报错怎么解决？内置检测工具使用说明

composer diagnose 不是万能诊断仪，它只检查环境硬性前提是否满足，报错必须逐条对应修复，不能跳过或忽略。

报 “PHP version” 或 “Extensions” 不匹配

这是 composer.lock 里记录的某依赖包明确要求的 PHP 版本或扩展，而你当前 CLI 环境不达标。不是“建议”，是硬性拦截。

运行 php -v 和 php -m 确认真实版本与已启用扩展
重点检查 ext-mbstring、ext-xml、ext-zip、ext-curl、ext-openssl 是否全部启用（Windows 下注意 php.ini 中分号是否已去掉）
若 PHP 版本低于锁文件要求（如锁文件写明需 PHP >= 8.1，而你是 8.0），升级 PHP 是唯一解；--ignore-platform-reqs 只会让后续运行时崩，不解决根本问题
检查 composer.json 顶部是否有 "config": {"platform": {"php": "8.2.10"}} —— 这会伪装版本，导致装完后 autoload.php 加载失败

报 “The openssl extension is required” 却已启用

常见于 Windows 或多 PHP 环境共存场景：CLI 模式调用的 php.exe 和你改的那个 php.ini 不是同一个。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

执行 php --ini，看输出的 Loaded Configuration File 路径，才是你要编辑的文件
确认该 php.ini 中 extension=openssl 前无分号，且 extension_dir 指向正确（如 extension_dir="C:\php\ext"）
在命令行中运行 php -m | findstr openssl（Windows）或 php -m | grep openssl（Linux/macOS），必须有输出才表示真正生效
别信 phpinfo() 页面结果——那是 Web Server 模块用的配置，和 Composer CLI 无关

报 “A valid cache directory could not be found” 或 “cache directory is not writable”

缓存目录损坏或归属错误，不是权限数字问题，而是用户归属被污染。

先查缓存路径：composer config -g cache-dir，默认是 ~/.composer/cache（Linux/macOS）或 %LOCALAPPDATA%\Composer\cache（Windows）
运行 ls -ld ~/.composer/cache（Linux/macOS），如果 owner 是 root，说明曾用 sudo composer 执行过，现在普通用户无法写入
修复命令：sudo chown -R $USER:$USER ~/.composer/cache（Linux/macOS）；Windows 用户需右键该文件夹 → 属性 → 安全 → 编辑当前用户“完全控制”权限
别用 chmod 777 —— Composer 会拒绝写入过于宽松的目录

报 “You are running Composer with SSL/TLS protection disabled”

这不是警告，是明确拒绝继续——说明你或系统强制禁用了 HTTPS 校验（如设了 export COMPOSER_DISABLE_TLS=1 或 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false)）。

检查环境变量：env | grep -i composer，删掉 COMPOSER_DISABLE_TLS 相关设置
检查全局配置：composer config -g secure-http，输出应为 true；若为 false，运行 composer config -g secure-http true
某些企业代理会静默降级 HTTPS，此时需配合 curl -v https://mirrors.aliyun.com/composer/packages.json 观察 TLS 握手是否卡住

真正难处理的是那些没报错但行为异常的情况：比如 composer diagnose 全绿，composer install 却卡在 “Resolving packages…” —— 那往往指向 DNS、代理或镜像 URL 尾部缺斜杠这类肉眼难辨的细节。