如何在Mac/Linux系统下全局安装Composer？（命令行教程）

全局安装 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 加载配置后，执行：

与光AI

一站式AI视频工作流创作平台

66

查看详情

• 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。

以上就是如何在Mac/Linux系统下全局安装Composer？（命令行教程）的详细内容，更多请关注php中文网其它相关文章！