全局安装 Composer 是将 composer.phar 放入 PATH 目录(如 /usr/local/bin 或 $HOME/bin)并赋执行权限;需下载校验 installer、生成 PHAR、配置 PATH、验证版本及环境,支持直接调用命令和 self-update 升级。

在 Mac 或 Linux 系统上全局安装 Composer,本质是把 composer.phar 可执行文件放到系统 PATH 中的某个目录(如 /usr/local/bin),并赋予执行权限。整个过程不依赖 Homebrew(但可用),也不需要 root 权限(除非写入系统级目录)。
下载并验证 composer.phar
打开终端,运行以下命令下载最新稳定版:
- 执行:
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php'); - 校验签名(推荐,避免中间人攻击):
php -r "if (hash_file('sha384', 'composer-setup.php') === 'e0012edf3e80b6978849f5eff0d4b4e4c79ff1609dd1f824b77632032483a598d3172322237347d2635724679a03772e753') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
(注意:官方 SHA384 值会更新,务必从 getcomposer.org/download/ 复制最新值) - 生成可执行 PHAR:
php composer-setup.php --filename=composer --install-dir=/usr/local/bin
手动放入 PATH 目录(推荐方式)
如果上一步因权限被拒(提示 Permission denied),改用普通用户可写的目录,再软链或添加到 PATH:
- 创建本地 bin 目录(若不存在):
mkdir -p $HOME/bin - 移动文件:
mv composer $HOME/bin/ - 确保
$HOME/bin在 PATH 中:
对 Bash(~/.bash_profile 或 ~/.bashrc)添加:export PATH="$HOME/bin:$PATH"
对 Zsh(~/.zshrc)添加相同行,然后运行source ~/.zshrc
验证安装是否成功
关闭并重新打开终端,或运行 source 加载配置后,执行:
-
composer --version→ 显示版本号(如Composer version 2.7.7) -
which composer→ 应返回路径,如/usr/local/bin/composer或/Users/xxx/bin/composer -
composer diagnose→ 检查环境兼容性(PHP 版本、openssl、curl 等)
后续使用提示
全局安装后,你可以在任意目录直接运行 composer create-project、composer require 等命令。无需每次 cd 到项目目录再下载;也无需在每个项目里重复安装 composer.phar。
升级 Composer:运行 composer self-update(需有对应目录写权限)。
如需切换到稳定版(非预发布):加 --stable 参数,例如 composer self-update --stable。










