Yii2在Windows和macOS上安装核心是环境准备和路径选择，需确保PHP 7.4+及openssl、mbstring、pdo、curl扩展启用，统一通过Composer安装，选择高级版或基础版模板后执行php init配置环境，并通过Web服务器或内置服务器指向/web或/frontend/web目录访问。
从零开始在 Windows 和 macOS 上安装 Yii2，核心就两点：环境准备到位、安装路径选对。不用纠结“哪个平台更难”，只要按步骤来，两边流程高度一致，只是命令写法和路径风格略有不同。
一、基础环境必须齐备
无论 Windows 还是 macOS，Yii2 依赖 PHP 7.4 或更高版本（推荐 8.1+），且以下扩展必须启用：
- openssl（HTTPS 请求、Composer 通信必需）
- mbstring（多字节字符串处理，框架底层大量使用）
- pdo 与 pdo_mysql（数据库操作基础，即使暂不连库也建议开启）
- curl（部分扩展和 Asset 插件需要）
检查方式（终端/命令提示符中执行）：
php -v && php -m | grep -E "(openssl|mbstring|pdo|curl)"（macOS/Linux）
php -v && php -m（Windows，手动查找关键词）
若缺失，编辑 php.ini，去掉对应行前的分号（如 ;extension=openssl → extension=openssl），保存后重启 Web 服务或 CLI。
二、Composer 是唯一推荐入口
别再用归档包“图省事”——它跳过依赖管理，后期升级、加扩展会反复踩坑。双平台统一走 Composer 流程：
- Windows：下载运行 Composer-Setup.exe（自动识别 PHP 路径）；安装后在 CMD 中输入 composer --version 验证
-
macOS：终端运行：
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
装好后立即升级插件（关键！否则 bower/npm 包拉不下来）：
composer global require "fxp/composer-asset-plugin:^1.4.7"
注意：macOS 若提示权限错误，改用 sudo composer global require...；Windows 无需 sudo。
三、选模板 + 装项目（一步到位）
进到你希望存放项目的目录（比如 C:\xampp\htdocs\ 或 ~/Sites/），执行：
- 装高级版（带 frontend/backend/console，适合中大型项目）：
composer create-project --prefer-dist yiisoft/yii2-app-advanced myapp - 装基础版（单应用，学习或小项目首选）：
composer create-project --prefer-dist yiisoft/yii2-app-basic myapp
⚠️ 提示 GitHub 登录？这是 Composer 访问 API 的限频保护。直接输你的 GitHub 账号密码（或生成 Personal Access Token 替代），输一次，后续不再弹。
装完进入项目目录，运行：
php init
选 0（开发环境），确认 yes —— 此步自动生成配置、设置权限、初始化 runtime 目录。
四、本地访问配置（双平台通用逻辑）
Yii2 不是放根目录就能直接打开的，入口在 /frontend/web/（高级版）或 /web/（基础版）。需让 Web 服务器指向该路径：
-
Apache：修改 httpd-vhosts.conf，添加类似配置：
ServerName yii.local
DocumentRoot "/path/to/myapp/frontend/web"
AllowOverride All
Require all granted
然后在系统 hosts 文件（C:\Windows\System32\drivers\etc\hosts 或 /etc/hosts）追加：
127.0.0.1 yii.local -
PHP 内置服务器（快速验证）：进到 myapp/frontend/web 目录，运行：
php -S localhost:8000 router.php
浏览器打开 http://localhost:8000 即可看到欢迎页
高级版 backend 同理，只需把 DocumentRoot 换成 /backend/web，域名设为 admin.yii.local 并同步加 hosts 条目。
