Composer安装失败主因是PHP环境不达标或配置干扰：需PHP≥7.2.5（推荐≥8.0）并启用curl、json、openssl、phar、zlib扩展；证书错误可配curl.cainfo；全局命令需手动加PATH；务必确认CLI与Web使用同一php.ini。
Composer 安装失败，90% 以上不是 Composer 本身坏了，而是你当前 CLI 环境的 PHP 版本、扩展、权限或镜像源没对上——直接看报错关键词比重装快十倍。
看到 “PHP version does not satisfy” 就别折腾网络了
这是最常被误判为“网络问题”的错误，实际是当前 php 命令对应的版本低于 composer.json 中 "php": "^8.1" 这类声明。注意：Web 服务器用的 PHP 和终端里跑的 php 很可能不是同一个。
- 运行
php -v和php --ini，确认 CLI 加载的是哪个php.ini - 检查
composer.json的require段，比如写了"php": ">=8.2"，但你本地是 8.1.3，就会硬拦住 - 临时绕过（仅调试）：
composer install --ignore-platform-reqs；生产环境必须升级 PHP 或降级依赖 - 别信“XAMPP 面板显示 PHP 8.2”——CLI 下
php -v才算数
“file could not be downloaded” 或卡在 downloading
国内用户几乎全是镜像源 + TLS 校验双重问题，和你本地磁盘、内存无关。
- 立刻换阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 换完必须清缓存：
composer clear-cache，否则旧失败记录还在干扰 - 如果仍报 SSL 错误（如 cURL error 60），临时关 TLS 验证：
composer config -g secure-http false（仅开发机，勿上生产） - 弱网环境可加超时：
composer config -g process-timeout 3000、composer config -g http-timeout 600
“Permission denied” 写 vendor 或 ~/.composer/vendor/bin
Linux/macOS 下最典型权限陷阱：你曾用 sudo composer install，导致 vendor/ 归属变成 root，后续普通用户再也写不进去。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
立即学习“PHP免费学习笔记（深入）”；
- 先查归属：
ls -ld ./vendor ~/.composer/vendor/bin，只要看到root就得修 - 修复命令（谨慎）：
sudo chown -R $USER:$USER ./vendor（项目内）或sudo chown -R $USER:$USER ~/.composer（全局） - 永远不要用
sudo composer global require——生成的二进制文件（如laravel）会属于 root，PATH 也找不到 - Windows 用户注意：
%USERPROFILE%\AppData\Roaming\Composer\vendor\bin是隐藏路径，需手动输入资源管理器地址栏才能访问
“Could not find package” 或 “Your requirements could not be resolved”
这不是网络故障，是依赖描述本身冲突或缺失，靠换源解决不了。
-
Could not find package：包名拼错、版本号不存在（比如"monolog/monolog": "3.99.0"）、或镜像源还没同步新发布包（等几小时再试） -
Your requirements could not be resolved：两个包要求互斥的 PHP 版本，或一个要ext-gd另一个没声明但运行时报Call to undefined function imagecreatefrompng()——这时去开gd扩展 - 用
composer why-not vendor/package:version查谁在阻止安装 - 删
vendor/和composer.lock后重装只适合开发环境；生产环境应先git status看 lock 是否被意外修改
真正难搞的从来不是报错文字本身，而是 CLI 和 Web 服务用两套 PHP 配置、或你改了 php.ini 却忘了重启 php-fpm —— 这些地方不会报错，只会让你反复验证“明明开了 openssl 为什么还说找不到函数”。
