Composer全局可用需满足两个条件：文件具备可执行权限且所在目录在$PATH中；下载的composer.phar需手动移至~/bin或/usr/local/bin并确保对应路径已加入$PATH，再通过which composer和composer --version验证。
Composer 不需要“安装到服务器”——它是个 PHP 工具，必须以 PHP 可执行文件形式存在，且路径得进 $PATH 才能全局用。
为什么直接运行 composer 报 “command not found”
这不是权限或网络问题，而是 shell 根本找不到这个命令。Linux 不会自动把下载的二进制文件加进系统路径，你手动放哪儿、是否可执行、$PATH 里有没有它，三者缺一不可。
-
curl -sS https://getcomposer.org/installer | php下载的是composer.phar—— 它是 PHP 归档文件，不是系统命令 - 直接
php composer.phar install能跑，但composer install不能，说明没做全局注册 - 如果用
sudo mv composer.phar /usr/local/bin/composer却仍报错，大概率是/usr/local/bin不在当前用户的$PATH里（尤其是非 root 用户或某些最小化发行版）
怎么让 composer 真正全局可用
核心就两步：确保文件可执行 + 确保所在目录在 $PATH 中。别抄网上“一键脚本”，先看自己环境。
- 下载后立刻加执行权限：
chmod +x composer.phar - 推荐放到用户级 bin 目录（避免 sudo）：
mv composer.phar ~/bin/composer（前提是~/bin已在$PATH；若没有，先在~/.bashrc或~/.zshrc里加一行export PATH="$HOME/bin:$PATH"，再source ~/.bashrc） - 或者系统级安装（需 sudo）：
sudo mv composer.phar /usr/local/bin/composer，然后确认/usr/local/bin在$PATH中（大多数发行版默认包含，但 Alpine、某些容器镜像不包含） - 验证是否生效：
which composer应输出路径；composer --version应正常返回版本号
composer 全局配置写哪儿、改什么
全局配置不是环境变量，而是 Composer 自己维护的 JSON 文件，位置固定：~/.composer/config.json（PHP 7.4+ 默认用 ~/.config/composer/config.json，旧版本可能 fallback）。别手动改 /etc/profile 或瞎 export。
- 设默认仓库源（国内加速）：
composer config -g repo.packagist composer https://packagist.phpcomposer.com（注意：该镜像已停，应换为https://mirrors.aliyun.com/composer/或https://packagist.org） - 设全局 auth（如私有包）：
composer config -g http-basic.example.org username token，会写入auth.json - 查看当前全局配置：
composer config -g --list - ⚠️ 别用
composer config --global混用参数顺序，-g 必须紧挨 config，否则写到当前项目而非全局
真正卡住人的从来不是下载命令，而是 PATH 是否生效、用户 shell 配置是否重载、以及 Composer 版本和 PHP 版本是否兼容（比如 Composer 2.x 要求 PHP >=7.2）。这些细节不验证，光复制粘贴安装命令，永远在 “command not found” 里打转。
