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 条目。











