composer命令失败主因是未加入path；需先验证php≥7.4且启用openssl、curl等扩展，再下载校验安装器并全局安装，最后配置镜像源与证书路径。
如果您尝试安装 PHP 依赖管理工具 Composer，但命令执行失败或无法调用 composer 命令，则可能是由于 PHP 环境不满足基础要求、安装路径未纳入系统变量、或网络与权限配置异常所致。以下是解决此问题的步骤：
一、验证并修复 PHP 运行环境
Composer 本质是 PHP 脚本，必须在可用且合规的 PHP CLI 环境下运行。缺失关键扩展或版本过低会导致静默中断或致命错误。
1、执行 php -v 查看 CLI 模式下的 PHP 版本，确认 ≥ 7.4.0（Composer 2.5+ 最低要求）。
2、运行 php -m | grep -E "(json|openssl|curl|mbstring|phar|zlib)"，检查必需扩展是否全部启用；若某项缺失，需编辑 CLI 所用 php.ini 文件，取消对应 extension=xxx 行前的分号注释。
3、确认 allow_url_fopen = On 且 curl.cainfo 已指向有效 CA 证书路径（如从 curl.se 下载 cacert.pem 后，在 php.ini 中设置完整绝对路径）。
二、使用官方脚本完成正确安装
仅下载 composer-setup.php 并不等于安装完成；必须赋予可执行权限、指定全局安装路径，并确保该路径已加入系统 $PATH 或环境变量。
1、执行 php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" 下载安装器。
2、校验哈希值（官网每次发布均提供 SHA384），例如：echo "当前官网提供的SHA384值" | sha384sum -c -，避免中间人篡改。
3、运行 php composer-setup.php --install-dir=/usr/local/bin --filename=composer（Linux/macOS）或将其移至 Windows 的 %PROGRAMFILES%\Composer\ 并手动添加该路径到系统环境变量 Path。
三、解决“command not found”问题
该提示表明 shell 无法定位 composer 可执行文件，核心原因是安装后的二进制未被系统路径识别，而非 Composer 本身未生成。
1、Linux/macOS 下检查 /usr/local/bin 是否在 $PATH 中：echo $PATH；若无，执行 export PATH="/usr/local/bin:$PATH" 并写入 shell 配置文件（如 ~/.bashrc 或 ~/.zshrc）。
2、Windows 下打开「系统属性 → 高级 → 环境变量」，在「系统变量」中找到 Path，点击「编辑」后新增一行：C:\ProgramData\ComposerSetup\bin（若为图形安装器路径）或你自定义的存放路径。
3、新开终端窗口（非已有标签页），运行 composer --version 验证是否输出版本号。
四、切换国内镜像源规避网络失败
默认连接 packagist.org 易因 DNS 污染、TLS 握手超时或连接重置导致安装器下载中断或后续依赖拉取失败，更换可信镜像可绕过链路瓶颈。
1、执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 设置全局镜像源。
2、若安装器脚本下载失败，改用国内中转地址：php -r "copy('https://install.phpcomposer.com/installer', 'installer.php');"，再运行 php installer.php --install-dir=/usr/local/bin --filename=composer。
3、清除历史缓存干扰：composer clear-cache，再重试安装命令。
五、处理 cURL 证书与 TLS 相关错误
cURL error 60、SSL certificate problem 或 Could not resolve host 等报错，本质是 PHP 的 curl 扩展无法完成 HTTPS 证书链校验，常见于系统 CA 证书陈旧或 PHP 未正确加载证书路径。
1、下载最新 cacert.pem 文件（来源：https://curl.se/ca/cacert.pem），保存至固定位置（如 /etc/ssl/certs/cacert.pem）。
2、在 CLI 模式所用 php.ini 中添加：curl.cainfo = "/etc/ssl/certs/cacert.pem"（路径需为绝对路径）。
3、重启终端使配置生效，或直接临时指定证书路径运行安装器：php -d curl.cainfo=/etc/ssl/certs/cacert.pem composer-setup.php --install-dir=/usr/local/bin --filename=composer。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
