homebrew 不直接安装 yii2，而是通过安装 php 和 composer 来搭建环境，再用 composer 创建项目；需启用 openssl、mbstring 等扩展，配置国内镜像，安装 fxp/composer-asset-plugin，并运行 ./init 初始化。
Homebrew 本身不提供 Yii2 的直接安装命令（如 brew install yii2），因为 Yii2 是 PHP 应用框架，不是系统级二进制软件。它必须通过 Composer 安装，而 Homebrew 只负责为你铺好底层环境——PHP、Composer 和相关依赖。所以“用 Homebrew 安装 Yii2”实际是指：用 Homebrew 搭建 PHP + Composer 环境，再用 Composer 创建 Yii2 项目。
一、用 Homebrew 安装并配置 PHP
确保已安装 Homebrew（若未装，运行：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"）
推荐安装 PHP 8.1 或 8.2（Yii2 当前兼容稳定，避开尚不支持的 8.5+）：
brew install php@8.2
安装后需将 PHP 加入系统 PATH（Homebrew 会提示，通常执行）：
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
（M1/M2 Mac 路径为 /opt/homebrew；Intel Mac 为 /usr/local/bin）
验证是否生效：
php -v（应显示 8.2.x）
php -m | grep -E "openssl|mbstring|pdo|curl|json"（所有关键扩展必须在列表中）
二、用 Homebrew（间接）获取 Composer
虽然官方推荐用 curl 安装 Composer，但 Homebrew 也托管了它，更省心：
brew install composer
安装后立即配置国内镜像（否则必卡在 GitHub API）：
composer config -g repo.packagist composer https://packagist.proxy.fly.dev
升级到最新版：
composer self-update
Yii2 需加载前端资源（Bower/NPM 包），必须装 asset 插件：
composer global require fxp/composer-asset-plugin:^1.4.6
三、创建 Yii2 项目（基础版或高级版）
进入你习惯存放项目的目录，例如：
cd ~/Sites
选一种模板创建：
基础版（单应用，适合学习或小项目）：
composer create-project --prefer-dist yiisoft/yii2-app-basic myapp
高级版（前后端分离，含 frontend/backend/console）：
composer create-project --prefer-dist yiisoft/yii2-app-advanced myapp
创建完成后务必初始化（尤其高级版）：
cd myapp && ./init
选择 Development mode，按回车确认。
四、启动与访问（无需 Nginx 也可快速验证）
基础版：进入 web 目录，用 PHP 内置服务器启动：
cd web && php -S localhost:8080
浏览器打开 https://www.php.cn/link/cbb686245ece57c9827c4bc0d0654a8e
高级版：需分别启动 frontend 和 backend：
cd frontend/web && php -S localhost:8080
cd ../backend/web && php -S localhost:8081
对应访问：
前台：https://www.php.cn/link/cbb686245ece57c9827c4bc0d0654a8e
后台：https://www.php.cn/link/97a34e8859e946b5313f18f5f5f4c9f6
注意：入口文件必须在 web 子目录下运行，不能从项目根目录直接执行 php index.php，否则会报错 Class 'Yii' not found。
