linux必须手动安装composer，因apt/yum版多为1.x，不支持^2.5依赖、php 8.2+及现代语法，且缺签名校验；需卸载旧版、启用php-zip等扩展、下载校验安装、修复权限与path、配置国内镜像源。
Linux 上必须手动安装 Composer，用 apt 或 yum 装的版本基本不能用——它大概率是 1.x，不支持 ^2.5 这类依赖约束，也跑不动 PHP 8.2+ 项目。
为什么不能直接 apt install composer
ubuntu/debian 的仓库版 Composer 通常锁定在 1.10.x，centos/RHEL 更老；它缺失对现代 composer.json 语法（如 platform-check、conflict 块）的支持，且无法识别 PHP 8.2+ 新增的类型声明规则。更隐蔽的问题是：它默认不校验包签名，也不支持 self-update --stable 升级路径。
- 运行
composer --version显示1.10.22？立刻卸载：sudo apt remove composer - 检查是否残留旧二进制：
which composer若返回/usr/bin/composer，说明还没清干净 - 新版要求 PHP 扩展
php-zip、php-phar、php-xml必须启用，旧版不会报错，但composer install会卡在class ZipArchive not found
正确安装流程（含校验与权限修复）
官方安装脚本会生成 composer.phar，核心是下载 → 校验 → 移动 → 设权 → 入 PATH。漏掉校验或权限，后续会出无声故障。
- 先确保基础扩展就位：
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+） - 下载并校验（关键！防中间人攻击）：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"<br>HASH=$(curl -sS https://composer.github.io/installer.sig)<br>php -r "if (hash_file('sha384', 'composer-setup.php') === '$HASH') { 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
PATH 不生效？这是最常卡住的环节
/usr/local/bin 默认在大多数 Linux 发行版的 PATH 中，但某些最小化安装或容器环境会删掉它。不报错，只是命令找不到。
- 检查当前 PATH 是否包含：
echo $PATH | grep -o '/usr/local/bin'—— 若无输出，说明没加载 - 临时修复（测试用）：
export PATH="/usr/local/bin:$PATH" - 永久生效（推荐加到
~/.bashrc或~/.zshrc）：echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc - 验证：
which composer应返回/usr/local/bin/composer；composer diagnose会提示PHP binary和OpenSSL状态
国内用户必配镜像源（否则 composer create-project 极可能超时）
不配镜像，composer require laravel/framework 可能卡在 Downloading https://repo.packagist.org/packages.json 超过 5 分钟，最终报 failed to open stream: Connection timed out。
- 全局配置阿里云镜像（推荐）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：
composer config -g repo.packagist应输出该 URL - 如果已存在旧镜像（如
packagist.phpcomposer.com），先取消：composer config -g --unset repos.packagist
真正容易被忽略的是 PHP 扩展和 PATH 的组合问题：php-zip 缺失时，composer --version 一切正常，但第一次 install 就崩；而 PATH 没生效时，你反复重装 Composer，却始终在用系统旧版——这两个点不排查清楚，所有操作都是白忙。