Composer退出码1或255主因是CLI PHP环境异常：需用which php和php --ini确认实际调用路径与配置文件，确保curl/json/openssl/phar/zlib五扩展全启用，且CA证书、系统时间、PATH配置正确。
php -v 显示版本够了，但 composer 还是退出码 1 或 255
这不是网络问题，是 CLI 实际调用的 PHP 二进制和你看到的不是同一个。运行 which php 看路径，再跑 php --ini 确认 Loaded Configuration File 是你改过的那个 php.ini。
常见陷阱：
- Mac 上 Homebrew 装了
php@8.2，但没装php@8.2-curl——php -m里就缺curl - Windows 用 XAMPP，CLI 的
php.ini在php\php8.2.5\下，Apache 用的是另一个，改错位置就白忙 - Linux 发行版默认只装
php-cli包，php-curl、php-openssl得单独apt install -
php -m | grep -E "(curl|json|openssl|phar|zlib)"必须五项全在输出里，缺一个就静默失败
下载 installer.php 卡住、报 cURL error 60 或返回 HTML 页面
这说明中间有网关拦截或证书链失效，不是你本地断网。先手动测通路：curl -I https://getcomposer.org/installer，如果返回 HTTP/2 302 或响应体是 HTML，就是被重定向了。
解决路径：
立即学习“PHP免费学习笔记（深入）”；
- 临时跳过校验：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"，再php composer-setup.php - 更新 CA 证书：下载
cacert.pem（从curl.se），在php.ini里设curl.cainfo = "/full/path/to/cacert.pem" - 国内用户优先换源安装脚本：
php -r "copy('https://install.phpcomposer.com/installer', 'installer.php');"，再执行 - 检查系统时间 —— 误差超 5 分钟会导致 TLS 握手失败，尤其 Docker 容器休眠后没同步
全局命令 composer 找不到，或提示 Could not open input file
这是 PATH 没生效，不是没装成。composer.phar 文件一定生成了，只是 shell 找不到它。
操作要点：
- Linux/macOS：
sudo mv composer.phar /usr/local/bin/composer，再确认/usr/local/bin在$PATH里（echo $PATH） - Windows：把
composer.phar放到%PROGRAMFILES%\Composer\，然后把该路径加进「系统环境变量」里的Path - 改完 PATH 后必须新开终端窗口验证，已有标签页不会自动 reload
- 别长期用
php composer.phar代替composer—— IDE 和 CI 工具不认这种写法
composer install 失败报类签名不兼容或 Rule2Literals::getLiterals()
这基本不是 PHP 版本问题，而是 Composer 2.2+ 的 allow-plugins 机制在作祟。它静默禁用了未授权插件（比如 kylekatarnls/update-helper），导致 autoload 生成中断、vendor 目录不完整。
关键线索：
- 日志里出现类似
"kylekatarnls/update-helper contains a Composer plugin which is currently not in your allow-plugins config" - 你按提示选了
n拒绝启用，但该插件被其他包间接依赖 - 删掉
vendor/后重装必现，composer.lock本身没问题 - 临时解法：
composer install --no-plugins或在composer.json里显式加"allow-plugins": { "kylekatarnls/update-helper": true }
php --ini 输出的配置路径、php -m 的真实扩展列表、composer diagnose 的输出、以及日志里那行被你快速划过的插件提示，才是关键。 
