macOS 中需先确认 PHP ≥ 7.4 并加入 PATH，再通过 curl 安装 composer.phar 至 /usr/local/bin/composer，最后配置阿里云或腾讯云镜像源并验证安装与功能。
如果您在 macOS 系统中已安装 PHP，但尚未配置 Composer，将无法直接使用 composer 命令管理 PHP 依赖。以下是完成 Composer 全流程配置的操作步骤：
一、确认 PHP 环境可用性
Composer 依赖系统中已安装且可调用的 PHP 可执行文件，需先验证 PHP 版本与路径是否符合要求（建议 PHP ≥ 7.4）。若未安装或版本过低，Composer 将无法正常初始化。
1、打开终端，输入 php -v 查看当前 PHP 版本。
2、输入 which php 确认 PHP 可执行文件路径是否在系统 PATH 中。
立即学习“PHP免费学习笔记（深入）”；
3、若返回为空或版本低于 7.4，需通过 Homebrew 安装新版 PHP：brew install php，并确保 brew 安装的 bin 目录已加入 PATH。
二、全局安装 Composer
Composer 提供官方一键安装脚本，适用于 macOS 系统，安装后生成可全局调用的 composer 命令，无需每次指定路径。
1、在终端中执行下载命令：curl -sS https://getcomposer.org/installer | php。
2、将生成的 composer.phar 移动至系统可执行路径：sudo mv composer.phar /usr/local/bin/composer。
3、验证安装结果：composer --version，成功将显示类似 Composer version 2.x.x 的输出。
三、设置国内镜像源（阿里云）
默认使用官方源（https://packagist.org）在大陆访问缓慢且易超时，切换为阿里云镜像源可显著提升包下载速度与稳定性，适用于所有后续 composer install 或 composer require 操作。
1、执行全局镜像配置命令：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。
2、验证配置是否生效：composer config -g repo.packagist，应返回 https://mirrors.aliyun.com/composer/。
3、如需临时覆盖镜像（仅本次命令生效），可在任意命令后添加 --repository=https://mirrors.aliyun.com/composer/ 参数。
四、设置国内镜像源（腾讯云）
腾讯云镜像源提供与阿里云同等级的同步频率和带宽支持，可作为备用方案。当阿里云源出现异常时，可快速切换至此源，避免构建中断。
1、执行全局替换命令：composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/。
2、检查当前镜像地址：composer config -g repo.packagist，确认输出为腾讯云地址。
3、若仅对当前项目生效，进入项目根目录后运行：composer config repo.packagist composer https://mirrors.cloud.tencent.com/composer/（不加 -g 参数）。
五、验证 Composer 功能与镜像有效性
创建最小测试项目可验证 Composer 是否能正常解析依赖、下载包及使用镜像源，排除权限、网络或配置残留问题。
1、新建空目录并进入：mkdir test-composer && cd test-composer。
2、初始化 composer.json：composer init -n（-n 跳过交互式提问）。
3、尝试安装一个轻量依赖：composer require monolog/monolog:^2.0，观察是否从国内镜像地址拉取 zip 包并成功解压。
