macOS M1 芯片下通过 Homebrew 高效安装 Composer 的最佳实践-composer-PHP中文网

应使用官方脚本安装composer：先用homebrew安装php≥8.1并确保/opt/homebrew/bin/php在path中，再执行curl -ss https://getcomposer.org/installer | php生成composer.phar，移至/opt/homebrew/bin/composer并sudo chmod +x，最后配置阿里云镜像源。

macos m1 芯片下通过 homebrew 高效安装 composer 的最佳实践

别用 brew install composer —— 这个命令在 2026 年已彻底失效，不是“可能出问题”，而是根本不会装对：路径错、PHP 绑错、版本卡在 v2.2.x、composer --version 直接报 Permission denied 或 command not found。M1/M2 上唯一稳定路径是：用 Homebrew 装好原生 PHP，再用官方脚本生成 composer.phar，手动部署到正确位置并赋权。

确认 Homebrew 和 PHP 已就位且路径正确

Composer 是 PHP 写的，没可用的 CLI PHP，它根本起不来。macOS 12+ 已移除系统 PHP，/usr/bin/php 是空壳或 PHP 8.0，不满足 Composer 2.5+（需 ≥ 8.1）。

which brew 必须输出 /opt/homebrew/bin/brew；若为 /usr/local/bin/brew，说明装的是 Intel 版，需卸载重装 ARM64 原生版
brew install php（自动启用 phar、openssl、fileinfo、curl 扩展）
php -v 应输出 ≥ 8.1 的版本；which php 必须是 /opt/homebrew/bin/php
若 php 命令报错，检查 ~/.zshrc 是否含 eval "$(/opt/homebrew/bin/brew shellenv)" 并已 source ~/.zshrc；别手写 PATH= 行

用官方脚本安装 composer.phar 并部署到系统路径

Homebrew 的 composer 包自 2023 年起被标记为 deprecated，当前稳定路径是下载 PHAR 并手动部署——确保版本新、ARM64 兼容、绑定你刚装的 PHP。

macOS Notes

通过 AppleScript 创建、读取、搜索及管理 macOS 备忘录。适用于用户要求记笔记、记录事项、保存想法、创建会议记录等场景。

下载

执行：curl -sS https://getcomposer.org/installer | php，当前目录生成 composer.phar
M1/M2 用户运行：sudo mv composer.phar /opt/homebrew/bin/composer
立刻赋权：sudo chmod +x /opt/homebrew/bin/composer（缺这步必报 Permission denied）
验证：composer --version 应输出类似 Composer version 2.7.7

PATH 没生效？不是没装，是 shell 没读到

常见现象：composer --version 报 command not found，但 ls /opt/homebrew/bin/composer 确实存在。本质是 shell 没加载 Homebrew 的 bin 目录。

echo $SHELL 确认是 /bin/zsh（macOS Catalina 及以后默认）
编辑 ~/.zshrc，末尾加：eval "$(/opt/homebrew/bin/brew shellenv)"
然后运行：source ~/.zshrc
别手写 export PATH="/opt/homebrew/bin:$PATH" —— 官方方式能同步管理所有 Homebrew bin 子目录（如 share、sbin）

国内用户不配镜像源，等于白装

默认源 https://packagist.org 在国内访问极不稳定，composer install 十次九卡在 “Resolving dependencies”，甚至直接报 Connection timed out。这不是 Composer 的 bug，是基础设施现实。

配置阿里云镜像源：composer config -g repo.packagist https://mirrors.aliyun.com/composer/
验证是否生效：运行 composer show，看输出中 repositories 是否指向阿里云地址
如果仍慢，检查是否漏了 -g（全局配置），或被项目级 composer.json 中的 repositories 覆盖

最常被忽略的其实是 PHP 扩展状态和镜像源作用域——php -m | grep -E '^(openssl|fileinfo|curl)$ 缺任意一个，Composer 都可能静默失败；而镜像源没加 -g，只在当前目录生效，切项目就退回原源。