必须手动安装最新版composer，因apt/yum源中1.x版本不支持^2.5约束、php 8.2+及签名校验，且无法升级至2.x；需下载校验、移动至/usr/local/bin、设执行权限并配置国内镜像。
直接用 apt install composer 或 yum install composer 装出来的几乎肯定不能用——它大概率是 1.x 版本，不支持 ^2.5 依赖约束、PHP 8.2+ 项目，也不校验包签名。必须手动下载并设为全局可执行。
为什么 composer --version 显示 1.10.22 就得立刻重装
这个版本无法解析 composer.json 中的 platform-check 和 conflict 块，composer install 会静默失败，报错却显示 Class 'ZipArchive' not found（其实是扩展没启用，但旧版不提示）。它也不支持 self-update --stable，没法升级到 2.x 稳定通道。
- Ubuntu/Debian 仓库版通常卡在 1.10.22；CentOS/RHEL 更老，甚至缺
php-zip扩展支持 - 卸载旧版：
sudo apt remove composer（Ubuntu）或sudo yum remove composer（CentOS） - 检查是否残留：
which composer，若输出/usr/bin/composer，说明还没清干净
下载 + 校验 + 移动 + 设权，四步缺一不可
漏掉校验或权限，后续会出无声故障：比如 composer install 卡住、composer update 报 Killed 或 Allowed memory size exhausted。
- 先确保 PHP 扩展就位：
sudo apt install -y php-cli php-zip php-json php-mbstring php-xml php-phar（Ubuntu）或sudo dnf install -y php-cli php-zip php-json php-mbstring php-xml php-phar（RHEL 8+） - 进临时目录下载并校验（防中间人攻击）：
cd /tmp && curl -sS https://getcomposer.org/installer -o composer-setup.php，然后运行：php -r "if (hash_file('sha384', 'composer-setup.php') === file_get_contents('https://composer.github.io/installer.sig')) { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;" - 执行安装：
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer - 删临时文件：
rm composer-setup.php；若composer --version报Permission denied，补权限：sudo chmod +x /usr/local/bin/composer
command not found 和 Permission denied 的真实原因
这两个错误不是 Composer 的问题，而是环境没走通。Linux 不会自动把下载的二进制加进系统路径，你放哪儿、有没有 x 权限、$PATH 里有没有它，三者缺一不可。
-
bash: composer: command not found→ 检查echo $PATH | grep -o '/usr/local/bin'，没输出就说明没加载；临时修复：export PATH="/usr/local/bin:$PATH"；永久生效需写入~/.bashrc或/etc/profile.d/composer.sh -
Permission denied→ 先看ls -l /usr/local/bin/composer，确认有x权限；再查 PHP 是否禁用了关键函数：php -i | grep disable_functions，若含proc_open或exec，得去/etc/php.d/下对应.ini文件里删掉它们 - 某些最小化系统（如 Alpine、Docker 容器）默认不包含
/usr/local/bin在PATH中，这点最容易被忽略
国内用户不配镜像源，composer create-project 大概率超时失败
官方源 packagist.org 国内直连极不稳定，必须提前配置国内镜像，否则 composer install 卡在 “Loading from cache…” 或直接 timeout。
- 设阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：
composer config -g --list | grep repo.packagist，应输出对应 URL - 别用已停用的
https://packagist.phpcomposer.com，该镜像已于 2025 年底下线
