推荐在 macOS（尤其 M1/M2）上用官方 curl 脚本安装 Composer，因 Homebrew 的 composer 包自 2023 年起已弃用，易致路径错乱、版本陈旧或权限失败；需先通过 brew install php 安装 PHP，再执行 curl -sS https://getcomposer.org/installer | php，移至 /opt/homebrew/bin/composer 并 chmod +x，最后配置阿里云镜像源提升国内访问速度。
composer 在 macOS 上安装，推荐用官方 curl 脚本方式安装，而非 brew install composer —— 因为 Homebrew 的 composer 包自 2023 年起已被标记为 deprecated（已弃用），在 M1/M2 Mac 上尤其容易出路径错乱、版本陈旧或权限失败问题。
确认 PHP 环境是否就绪
Composer 是 PHP 写的命令行工具，必须依赖可用的 php CLI。macOS 自带的 PHP 已被苹果弃用（macOS 12+ 不再预装），不能用。
执行以下命令检查：
php -v
若报错 command not found: php，或版本低于 7.4（如显示 PHP 8.0 以下），需重装：
- 先确保 Homebrew 已装在 Apple Silicon 原生路径：
which brew应输出/opt/homebrew/bin/brew；若为/usr/local/bin/brew，说明是 Intel 版，需卸载重装 - 运行：
brew install php（自动安装最新稳定版，如 PHP 8.3） - 验证：
which php应返回/opt/homebrew/bin/php；若无，把这行加进~/.zshrc：export PATH="/opt/homebrew/bin:$PATH"，然后source ~/.zshrc
用官方脚本安装 composer.phar
Homebrew 不再维护 composer 包，官方明确推荐 curl 方式，保证版本新、路径可控、ARM64 兼容。
在终端中依次执行：
curl -sS https://getcomposer.org/installer | php
该命令会生成一个本地文件：composer.phar（即 Composer 的可执行 PHAR 包）。
接着将其移到系统可执行路径（M1/M2 Mac 对应 /opt/homebrew/bin/，不是旧的 /usr/local/bin/）：
sudo mv composer.phar /opt/homebrew/bin/composer
再赋权（避免 Permission denied）：
sudo chmod +x /opt/homebrew/bin/composer
验证：
composer --version
应输出类似 Composer version 2.7.7 —— 表示成功。
配置国内镜像源（必做，否则慢到超时）
默认源 https://www.php.cn/link/ec811d0d775adc62776ba80fadd4ed19 在国内访问极不稳定，composer install 或 require 极易卡住或报 Connection timed out。
推荐使用阿里云镜像（同步及时、CDN 加速）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否生效：
composer config -g repo.packagist
应输出：https://mirrors.aliyun.com/composer/
⚠️ 注意：如果之前手动改过 ~/.composer/config.json，且里面写了 "secure-http": false，请删掉——现在所有主流镜像都支持 HTTPS，开启 secure-http（默认 true）更安全，也避免警告。
常见错误与绕过方法
你可能遇到这些典型现象：
-
zsh: command not found: composer→ 检查which composer是否有输出；没有则确认/opt/homebrew/bin在$PATH中，且没用 Rosetta 打开终端（终端设置里关掉「使用 Rosetta」） -
Permission denied→ 不要跳过chmod +x步骤；也不要尝试sudo composer，那会污染用户级配置 -
Your configuration does not allow connections to http://...→ 镜像地址用了http://开头（如老教程写的http://packagist.phpcomposer.com），必须换为https://地址；secure-http不要设为false -
curl: (7) Failed to connect→ 先试curl -I https://getcomposer.org/installer看是否能通；如不能，检查网络代理或公司防火墙是否拦截了 HTTPS 请求
Mac 上装 composer 最容易被忽略的一点是：路径必须匹配芯片架构 —— M1/M2 用户一定要用 /opt/homebrew/bin/，而不是沿用旧教程里的 /usr/local/bin/；哪怕只差一个字符，composer 就找不到 PHP 或无法加载扩展。
