macOS 上应通过 Homebrew 安装 PHP（如 php@8.3）并启用 openssl、mbstring 等扩展；推荐 sudo curl 安装 Composer 到 /opt/homebrew/bin 并配置 PATH；项目中用 composer install/--no-dev/--update 精准管理依赖，配置国内镜像与 platform-check false 提升体验。
在 macOS 上管理 PHP 项目的 Composer 依赖，关键在于确保 PHP 环境可靠、Composer 安装正确、全局与项目级配置合理，并能应对常见权限和路径问题。
确认 PHP 环境可用且版本匹配
Composer 对 PHP 版本有明确要求（当前稳定版需 PHP ≥ 8.1）。macOS 自带的 PHP 已被弃用，不建议使用。推荐通过 Homebrew 安装维护性好、更新及时的 PHP：
- 运行
brew install php（默认安装最新稳定版，如 php@8.3） - 检查是否生效：
which php应返回类似/opt/homebrew/bin/php - 验证版本：
php -v，并确认php -m | grep openssl和php -m | grep mbstring均有输出（Composer 必需扩展）
安装与校验 Composer（推荐全局可执行）
避免使用 curl -sS https://getcomposer.org/installer | php 生成本地 composer.phar 的方式——它不易全局调用且易遗漏更新。更稳妥的做法是：
- 下载可执行二进制：
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer - 若提示权限拒绝（尤其 Apple Silicon），改用：
sudo curl -sS https://getcomposer.org/installer | php -- --install-dir=/opt/homebrew/bin --filename=composer - 执行
composer --version验证；若报错“command not found”，请将对应目录加入$PATH（如在~/.zshrc中添加export PATH="/opt/homebrew/bin:$PATH"，然后source ~/.zshrc）
项目级依赖管理实操要点
进入 PHP 项目根目录后，Composer 行为由 composer.json 驱动。注意几个高频场景：
立即学习“PHP免费学习笔记（深入）”；
- 首次初始化：运行
composer init交互生成基础配置，或手动创建composer.json后执行composer install（读取lock文件精确还原依赖） - 添加新包：
composer require monolog/monolog:^3.0（自动写入composer.json并更新vendor/和composer.lock） - 避免 dev 依赖污染生产环境：
composer install --no-dev（上线部署时必加） - 更新依赖要谨慎：
composer update会按composer.json规则升级版本并重写lock；日常开发建议用composer update vendor/package-name指定更新
常用配置与故障应对
Composer 默认配置位于 ~/.composer/config.json，可手动编辑优化体验：
- 设置国内镜像加速（解决超时）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 禁用平台配置警告（如本地 PHP 版本略低于
composer.json中声明的platform.php）：composer config -g platform-check false - 权限错误（如
vendor/写入失败）：通常因 Homebrew PHP 以用户身份运行，但某些目录被sudo创建过。执行sudo chown -R $(whoami) ~/.composer && sudo chown -R $(whoami) ./vendor修复归属 - 找不到扩展（如 zip 或 gd）：用
brew install libzip gd，再重新brew reinstall php让 PHP 重新链接
