Composer安装失败90%源于PHP环境配置错误：需确认openssl、curl、json扩展已加载，PHP版本≥7.2.5，临时目录可写，且CLI与Web端php.ini一致；运行php -m和composer diagnose可精准定位问题。
Composer 安装失败，90% 不是 Composer 的问题，而是你本地 PHP 环境没配对——它不报错，只静默退出或返回 Exit Code 1 或 Exit Code 255。
PHP 版本和扩展是否真就位？
很多人运行 php -v 看到“7.4”或“8.2”就以为过关了，但 Composer 安装器在执行时会严格检查 openssl、curl、json 这三个扩展是否已加载，缺一个就直接中断，且不提示具体缺谁。
- 运行
php -m | grep -E "(openssl|curl|json)"，确认三者都在输出里；Windows 用户注意：XAMPP/MAMP 的 CLI PHP 和 Web PHP 配置文件可能不同，php -i | grep "Loaded Configuration"才能看清实际读的是哪个php.ini -
Exit Code 255很大概率是 PHP 命令根本找不到，或版本低于7.2.5（Composer 2.x 最低要求），比如某些 Linux 发行版默认带的php是php-cli包没装，或 PATH 指向了旧版 - Mac 上用 Homebrew 安装 PHP 后，常漏装
php@8.2-curl这类子包，得单独brew install
下载阶段就卡住或校验失败？别急着换镜像
官方安装命令 curl -sS https://getcomposer.org/installer | php 表面看是网络问题，实则常被防火墙重定向成 HTML 页面（比如返回“您访问的页面被拦截”），导致 PHP 脚本解析失败，最终退出码为 1。
- 先手动测试下载通路：
curl -I https://getcomposer.org/installer，确认响应头含HTTP/2 200；若返回302或内容是 HTML，说明中间有网关干预 - 临时跳过 SHA384 校验可快速验证是否是校验环节出错：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"，再运行php composer-setup.php --quiet - Windows PowerShell 默认禁用远程脚本执行，改用 CMD，或先运行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
权限与临时目录限制比你想象中更常见
Composer 安装器需要写入当前目录（生成 composer.phar），首次运行时还会调用 sys_get_temp_dir() 创建临时解压路径。很多失败发生在 Docker 容器、CI 环境或共享主机上，用户没意识到自己没权限。
- 运行
php -r "echo sys_get_temp_dir();"查看临时目录，然后检查该路径是否可写（Linux/macOS：ls -ld $(php -r "echo sys_get_temp_dir();")） - 避免在系统级受保护目录（如
/usr/local/bin）直接安装；推荐先cd ~再执行安装命令 - 部分主机禁用
proc_open或exec，导致后续composer install无法调用git或unzip；查phpinfo()中disable_functions是否包含这些函数
安装成功后 composer install 还失败？环境检测要分两层
装上 composer.phar 只是第一步。真正跑项目依赖时，composer install 会再次校验 PHP 版本、扩展、甚至 allow_url_fopen 开关状态——而这些配置可能和安装阶段用的不是同一份 php.ini。
- 运行
composer diagnose，它会主动检查常见陷阱，比如openssl扩展是否支持 TLS、zip扩展是否可用、缓存目录是否可写 - 若报
Your requirements could not be resolved，先看错误里有没有PHP version does not satisfy——这说明composer.json里写的"php": "^8.1"和你当前 CLI PHP 版本不一致，别急着加--ignore-platform-reqs，先确认你是不是在 Valet/Docker/多版本共存环境下调错了 PHP - 国内用户最常忽略的是 SSL 证书路径问题：某些 PHP 编译未内置 CA 包，
curl请求 HTTPS 仓库时失败；可在php.ini加curl.cainfo = /path/to/cacert.pem（从 curl.se 下载）
真正卡住的地方，往往藏在 php -i 输出的几十屏配置里，或者某个被代理重写的 HTTP 响应头中。别信“重装一遍就好”，先让 php -v 和 composer diagnose 说清楚话。
