要在本地快速跑起功能完整的yii框架项目,需用phpstudy一键配置php(≥7.4,推荐8.2.12)、apache、mysql及必需扩展(pdo_mysql、mbstring、openssl、gd、intl),再通过composer或归档包创建yii2-app-basic项目,最后配置虚拟主机yii2.test并启用mod_rewrite,访问即成功。

要在本地快速跑起一个功能完整的Yii框架项目,必须让PHP版本、扩展、Web服务器和数据库全部协同工作,phpStudy正好能一次性解决所有依赖问题,不用手动编译Apache、配置php.ini、折腾MySQL权限。
安装phpStudy并启用必要服务
访问官网 xp.cn 下载 phpStudy Pro 最新版,安装路径避免中文和空格,例如 D:\phpstudy_pro;安装完成后以管理员身份运行主程序,否则MySQL可能无法启动。
在首页界面点击 Apache 右侧的启动按钮 → 点击 MySQL 右侧的启动按钮 → 观察右下角状态栏,两项均显示绿色“已启动”才算成功。
打开浏览器访问 http://localhost,看到 phpStudy 欢迎页即证明基础环境就绪;若打不开,请检查是否被 Skype、IIS 或其他软件占用了 80 端口。
切换并验证PHP版本与扩展
Yii2 要求 PHP ≥ 7.4,推荐使用 PHP 8.0 或更高版本。点击顶部菜单【软件管理】→ 在 PHP 版本列表中勾选 php-8.2.12(或当前最新稳定版)→ 点击【设置为当前版本】,系统将自动重载配置并重启 Apache。
新建一个 info.php 文件,内容为 <?php phpinfo(); ?>,保存到网站根目录(默认为 D:\phpstudy_pro\WWW),然后访问 http://localhost/info.php,确认页面顶部显示的 PHP 版本号正确。
【pdo_mysql、mbstring、openssl、gd、intl 这五个扩展必须启用】,在 phpinfo 页面搜索这些名称,若任一缺失,返回 phpStudy 主界面 → 点击【环境】→ 【PHP扩展】→ 勾选对应项并保存,再重启 Apache。
用Composer创建Yii2基础项目
方法一:命令行方式(推荐)
打开 Windows 终端(CMD 或 PowerShell),执行以下命令:
cd /d D:\phpstudy_pro\WWW
composer create-project --prefer-dist yiisoft/yii2-app-basic yii2-demo
这一步会自动下载 Yii2 官方基础模板,并解压到 WWW 目录下的 yii2-demo 文件夹中;如果提示“composer 不是内部或外部命令”,需先下载 Composer 安装程序并完成全局安装。
方法二:归档包方式(无 Composer 时备用)
前往 https://github.com/yiisoft/yii2/releases 下载最新 stable 版本的 yii2-app-basic-x.x.x.tgz → 解压后得到 basic 文件夹 → 将其重命名为 yii2-demo → 整体复制进 D:\phpstudy_pro\WWW 目录。
注意:归档方式部署后必须手动编辑 config/web.php,在 'components' → 'request' 下添加 'cookieValidationKey' => 'your-secret-key-here',否则首次访问会报错。
配置虚拟主机并访问项目
第一步:在 phpStudy 中添加站点
点击顶部【网站】→ 【添加站点】→ 域名填写 yii2.test → 根目录选择 D:\phpstudy_pro\WWW\yii2-demo → PHP 版本选刚设置好的 8.2.12 → 点击【确认】。
第二步:绑定本地域名
用记事本(需以管理员身份运行)打开 C:\Windows\System32\drivers\etc\hosts → 在文件末尾新增一行:
127.0.0.1 yii2.test
第三步:启用 URL 重写支持
确保 Apache 的 mod_rewrite 模块已启用:进入 phpStudy 【环境】→ 【Apache 设置】→ 【Apache 配置】→ 找到 LoadModule rewrite_module modules/mod_rewrite.so 这行,确认前面没有 # 注释符号。
重启 Apache 服务,打开浏览器访问 http://yii2.test,看到 Yii2 的绿色欢迎页面即表示部署成功。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











