composer安装失败主因是环境配置错误，需依次检查php版本≥7.4.0、openssl扩展启用、allow_url_fopen=on、vc++运行库（windows）、path路径生效、镜像与超时设置、ssl证书路径、文件权限归属，而非composer本身故障。
composer 安装失败，绝大多数情况不是 Composer 本身坏了，而是环境没配对。它像一把钥匙，PHP 版本、扩展、网络、权限、路径——缺一环就打不开门。
检查 PHP 环境是否达标
Composer 不是独立程序，它依赖 PHP 运行。哪怕你装了 PHP，也可能因版本低、扩展缺失或配置关闭而静默失败。
- 运行
php -v，确认版本 ≥7.4.0（当前最低要求）；低于此版本会直接报错requires PHP >= 7.4.0 - 运行
php -m | grep -i openssl（Linux/macOS）或php -m（Windows），确保openssl扩展已启用 - 检查
allow_url_fopen是否为On：php -i | grep allow_url_fopen
若显示Off，需在php.ini中改为allow_url_fopen = On - Windows 用户若双击
Composer-Setup.exe无反应，大概率是缺Visual C++ 2015–2022 Redistributable，请先安装
PATH 和命令不可用？别信自动配置
很多用户装完提示 'composer' 不是内部或外部命令，是因为安装程序“以为”加好了系统路径，其实没生效。
- Windows：默认路径是
C:\ProgramData\ComposerSetup\bin，但该目录常被 PATH 遗漏。手动进「系统属性 → 环境变量 → 系统变量 → Path」新增这一行 - macOS/Linux：若用脚本安装，
sudo mv composer.phar /usr/local/bin/composer后仍无效，检查/usr/local/bin是否在$PATH中：echo $PATH
- 验证方式统一：新开终端（不是已有窗口！），执行
composer --version；若失败，说明 PATH 没刷新 - 别用
./composer.phar临时顶替——这不是解决，是绕开问题
连不上 Packagist？镜像 + 超时 + 缓存三连清
国内用户最常卡在下载阶段，错误如 Could not fetch packagist.org、cURL error 60 或无限 pending，本质是网络策略阻断或证书失效。
- 立即切阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 延长超时（尤其企业网/弱网）：
composer config -g process-timeout 3000<br>composer config -g http-timeout 600
- 清除损坏缓存：
composer clear-cache
，再删项目下的vendor/和composer.lock（如有），重试composer install - 遇到
cURL error 60（SSL 证书问题）：在php.ini中指定 CA 证书路径：curl.cainfo = "/path/to/cacert.pem"
，可从 curl.se 下载并填入绝对路径
权限错误：别用 sudo，要改归属
Permission denied 或 failed to open stream: Permission denied 类错误，90% 是因为文件/目录所有者不是当前用户，尤其在 WSL、Docker 或共享主机中高发。
- 绝不要运行
sudo composer install——这会让vendor/下所有文件归root，后续你连git status都可能被拒 - 修复项目目录权限：
sudo chown -R $(whoami) /path/to/your/project
- 修复 Composer 缓存目录（新版默认在
~/.cache/composer）：sudo chown -R $(whoami) ~/.cache/composer
- 若无法改系统目录权限（如某些云主机），用
composer config --global cache-dir ~/my-composer-cache指向用户可写路径
真正卡住的点，往往不在 Composer 文档里，而在你本地 php.ini 的一行配置、公司代理的一次变更、或 Windows PATH 多了一个空格。每次失败，先问：我刚改过什么？
