Composer怎么在Win安装 Composer怎么在Mac配置【兼容】

windows 安装 composer 需手动指定 php.exe 并启用 openssl/curl 扩展；mac 应弃用 brew install composer，改用官方脚本安装并配置 path 与国内镜像。

windows 上装 Composer：别信自动检测，先盯住 php.exe 和 openssl

Windows 下装不成功，九成是因为 PHP 没配对，或 openssl 扩展压根没开。官方 Composer-Setup.exe 会“自动检测”，但经常漏掉你实际用的 PHP（比如 XAMPP、WAMP、独立 zip 包三选一，它只扫注册表或默认路径）。

• 先运行 php --ini 看 Loaded Configuration File 路径，打开对应的 php.ini
• 确认这两行已取消注释：extension=openssl 和 extension=curl（不是 php_openssl.dll）
• 保存后，在终端跑 php -m | findstr openssl，有输出才算真启用
• 安装时若提示“PHP not found”，别点 Next，点 Browse 手动选你确认无误的 php.exe（比如 C:xamppphpphp.exe）
• 安装完立刻新开一个 CMD 或 PowerShell —— 旧窗口不会自动加载新 PATH，composer --version 必须在这里测

Mac 上装 Composer：别用 brew install composer，它已弃用

Homebrew 自 2023 年起就标记 composer 包为 deprecated，M1/M2 上尤其容易出 command not found、PHP Parse Error 或卡在权限拒绝。真正靠谱的路径是：用 Homebrew 装好 PHP，再用官方脚本生成 composer.phar，手动放进系统路径。

• 先确保 brew 装在正确位置：which brew 必须返回 /opt/homebrew/bin/brew（M 系列）或 /usr/local/bin/brew（Intel）
• 执行 brew install php，然后验证：php -v 有输出，且 which php 指向同级 bin 目录
• 接着跑：curl -sS https://getcomposer.org/installer | php → 生成本地 composer.phar
• M 系列用户执行：sudo mv composer.phar /opt/homebrew/bin/composer && sudo chmod +x /opt/homebrew/bin/composer
• Intel 用户用：sudo mv composer.phar /usr/local/bin/composer && sudo chmod +x /usr/local/bin/composer

Mac 的 PATH 坑：改了 ~/.zshrc 不生效？可能根本没 reload

macOS 12+ 默认用 zsh，但它不读 ~/.bash_profile；而很多人编辑了文件却忘了让终端“认账”，结果反复重装、以为是 Composer 问题。

• 确认 shell：echo $SHELL 输出 /bin/zsh 就编辑 ~/.zshrc，输出 /bin/bash 才动 ~/.bash_profile
• 在 ~/.zshrc 末尾加：export PATH="/opt/homebrew/bin:$PATH"（M 系列）或 export PATH="/usr/local/bin:$PATH"（Intel）
• 必须执行：source ~/.zshrc，否则新开终端也白搭
• 验证是否真进 PATH：echo $PATH | grep homebrew 或 which composer 应该返回完整路径，不是 ./composer
• 如果用了 Oh My Zsh，某些插件会覆盖 PATH，把 export PATH=... 放到 ~/.zshrc 最顶部

装完必须配国内镜像，否则 composer install 卡死是常态

默认源 https://packagist.org 在国内直连基本不可用，不是网络断了，是 DNS 解析慢 + TLS 握手超时，create-project、require 都会卡在 “Loading composer repositories…” 甚至报 Connection timed out。

• 全局配置阿里云镜像（推荐）：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 腾讯镜像备选：composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
• 验证是否生效：运行 composer config -g repo.packagist，应输出镜像 URL，不是 https://packagist.org
• 注意：这个配置写在全局配置文件里（~/.composer/config.json），不影响单个项目，也不需要每次项目都重复设

最常被忽略的是：改完环境变量不 source，或者开了新终端却没重新加载；还有人装了 PHP 却没开 openssl，硬是把网络问题当成 Composer 故障。这些都不是 Composer 本身的问题，而是它对底层环境很诚实——你给它什么，它就用什么。