在 macOS 上用 Composer 管理 PHP 项目依赖，核心是搭好可靠环境、装对工具、用对命令：必须通过 Homebrew 安装 PHP ≥ 8.1（如 php@8.3），启用 openssl 和 mbstring 扩展；用官方脚本全局安装 Composer 到 /opt/homebrew/bin/composer 并配置 PATH；项目中依场景执行 composer install --no-dev、require 或 update；配置阿里云镜像源提升速度与稳定性。
在 macos 上用 composer 管理 php 项目依赖，核心是搭好可靠环境、装对工具、用对命令。php 自带版本已弃用，必须用 homebrew 安装新版；composer 要全局可调用；项目中依赖操作得区分场景，避免误更新或引入 dev 包。
确认并安装匹配的 PHP 环境
Composer 当前稳定版要求 PHP ≥ 8.1，macOS 自带 PHP 不可用且不更新。推荐用 Homebrew 安装维护及时的版本：
- 运行 brew install php（默认装 php@8.3，兼容性好）
- 检查路径：which php 应返回
/opt/homebrew/bin/php - 验证版本：php -v，确认输出为 8.1 或更高
- 确认必需扩展已启用：php -m | grep openssl 和 php -m | grep mbstring 都应有输出
全局安装 Composer 并配置可用路径
不建议只生成 composer.phar 放在项目里——难复用、易遗漏更新。推荐直接安装为全局命令：
- 执行：sudo curl -sS https://getcomposer.org/installer | php -- --install-dir=/opt/homebrew/bin --filename=composer（Apple Silicon 机型需 sudo，避免权限错误）
- 验证：composer --version 应显示版本号
- 若提示 command not found，编辑 ~/.zshrc，添加：export PATH="/opt/homebrew/bin:$PATH"，再运行 source ~/.zshrc
项目级依赖管理常用操作
进入项目根目录后，所有操作围绕 composer.json 展开，lock 文件决定实际安装版本：
- 首次初始化：composer init 交互生成基础配置，或手动创建 composer.json 后运行 composer install
- 添加新包：composer require monolog/monolog:^3.0（自动写入 json、更新 lock、下载到 vendor）
- 生产环境部署：composer install --no-dev（跳过 require-dev 中的测试/开发工具）
- 精准更新：composer update monolog/monolog（只升指定包，不碰其他依赖）
加速与稳定性优化配置
国内访问官方源常超时，设镜像源能显著提升体验，且不影响依赖逻辑：
立即学习“PHP免费学习笔记（深入）”；
- 设阿里云镜像（全局生效）：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 验证是否生效：composer config -g repo.packagist 应返回上述地址
- 临时覆盖（单次命令）：composer install --repository=https://mirrors.aliyun.com/composer/
- 如需跳过平台检查（例如本地 PHP 版本与 lock 中声明不符但确定可用）：composer install --ignore-platform-reqs
