Composer安装失败主因是PHP CLI版本非8.3.8、curl等5项扩展未启用或证书校验失败；需用php -v和php -m验证，修正php.ini中extension与curl.cainfo，清理PATH并重装。
PHP 8.3 安装 Composer 失败，常见于 CLI 环境未真实运行 8.3.8、关键扩展缺失或证书校验失败，直接执行安装脚本却卡在 curl_init() 报错或提示“command not found”，说明问题不在网络，而在本地 PHP 配置与 Composer 寻址逻辑的错位。
确认 CLI 真实 PHP 版本与扩展状态
运行 php -v，输出必须含 8.3.8；若显示 8.1.x 或 8.2.x，Composer 安装必然失败——它只认 shell 中 php 命令指向的版本，和 phpinfo() 显示的 Web 版本无关。
接着执行 php -m | grep -E "curl|json|openssl|phar|zlib"，五项缺一不可。Windows 用户特别注意：XAMPP/MAMP 的 CLI php.ini 通常位于 php\php8.3.8\php.ini，不是 Apache 目录下的那个。
若报 Call to undefined function curl_init()，说明 curl 扩展未启用，打开对应 php.ini，取消 ;extension=curl 前的分号，保存后重启终端。
立即学习“PHP免费学习笔记（深入）”；
解决证书错误与国内网络阻断
运行官方安装脚本时出现 cURL error 60 或超时，是证书验证失败或 GitHub 直连被阻断所致，不是 Composer 本身缺陷。
方法一：更新 CA 证书包。下载最新 cacert.pem（来自 curl.se），在 php.ini 中添加完整路径：curl.cainfo = "D:/DevTools/php8.3/cacert.pem"，重启命令行。
方法二：改用国内镜像源安装。执行：php -r "copy('https://install.phpcomposer.com/installer', 'installer.php');" → php installer.php → sudo mv composer.phar /usr/local/bin/composer（Linux/macOS）。
【注意】不要用 php composer.phar 替代全局 composer 命令，IDE 和 CI 工具无法识别，且每次都要多敲 php。
修复环境变量冲突（Windows 专属）
第一步：打开系统环境变量设置，找到 PATH，删除所有旧 PHP 路径（如 C:\xampp\php、C:\php\php74）。
第二步：将 PHP 8.3.8 的绝对路径（如 D:\DevTools\php8.3）置于 PATH 列表最顶端。
第三步：关闭所有 CMD/PowerShell 窗口，重新打开，执行 php -v 和 where php（Windows）或 which php（macOS/Linux），确认返回路径唯一且指向 8.3.8。
第四步：重新运行 Composer 安装脚本。若仍提示找不到 php，说明 Composer 安装程序当初检测时记录了错误路径，此时需卸载重装——删掉 composer.phar 和 composer.bat，再走一遍安装流程。
强制指定 PHP 解释器路径安装
当 PATH 无法立即清理干净，或需在 CI/CD 中临时保障一致性时，跳过环境变量依赖，直指二进制。
Linux/macOS 执行：/usr/bin/php8.3 composer-installer.php → sudo mv composer.phar /usr/local/bin/composer。
Windows 执行："C:\php\php83\php.exe" composer-installer.php → 将生成的 composer.phar 移至 %PROGRAMFILES%\Composer\ 并配置该路径入系统变量。
【关键前提】/usr/bin/php8.3 或 C:\php\php83\php.exe 必须真实存在且为 8.3.8 版本，否则无效。
