使用一键PHP环境如phpStudy或XAMPP可快速部署Yii框架，需确保PHP版本≥7.4并启用pdo_mysql、mbstring等扩展，通过Composer安装Yii2基础模板至网站根目录，推荐配置虚拟主机并修改hosts文件实现域名访问，开启mod_rewrite支持美化URL，初始化后访问测试路由验证功能，整体流程简单适合新手学习与小型项目开发。
在一键PHP环境上运行Yii框架其实非常简单，尤其适合新手快速搭建本地开发环境。常见的“一键PHP环境”如phpStudy、XAMPP、WampServer等，都集成了Apache/Nginx、MySQL和PHP，只需简单配置即可部署Yii框架。
选择合适的一键PHP环境
推荐使用phpStudy或XAMPP，它们对Windows用户友好，安装后可直接启动服务。这些工具默认开启Apache和MySQL，PHP扩展也基本齐全，满足Yii2的运行要求。
确保PHP版本不低于7.4（建议8.0以上），并确认已启用以下扩展：
- pdo_mysql
- mbstring
- openssl
- gd2（用于验证码等）
- intl（国际化支持）
下载并安装Yii框架
进入你的一键环境的网站根目录，例如phpStudy的www目录或XAMPP的htdocs目录。
立即学习“PHP免费学习笔记（深入）”；
使用Composer安装Yii2基础模板：
composer create-project yiisoft/yii2-app-basic yii-basic
如果没有安装Composer，请先下载并安装。安装完成后，在命令行中执行上述命令，系统会自动下载Yii2项目到yii-basic文件夹。
配置虚拟主机（可选但推荐）
为了让访问更方便，可以为Yii项目设置一个虚拟域名，比如yii2.test。
以phpStudy为例：
- 打开“其他选项” → “站点域名管理”
- 添加新域名：yii2.test，指向你的项目路径（如D:\phpStudy\WWW\yii-basic）
- 保存后，修改本地hosts文件（C:\Windows\System32\drivers\etc\hosts），添加一行：
127.0.0.1 yii2.test
重启Apache服务后，浏览器访问http://yii2.test即可看到Yii欢迎页面。
初始化应用并测试功能
首次运行时，Yii会检查环境是否达标。如果看到绿色对勾，说明一切正常。若出现错误，根据提示开启对应PHP扩展即可。
你可以尝试访问以下路由来测试：
- /index.php?r=site/about — 查看关于页面
- /index.php?r=site/contact — 测试表单提交
如需美化URL，可开启重写模块（mod_rewrite），并在项目根目录的.htaccess文件中配置规则，或在Nginx中添加伪静态支持。
基本上就这些。只要环境配置正确，Yii框架在一键PHP环境中部署非常顺畅，适合学习和小型项目开发。不复杂但容易忽略的是权限和rewrite配置，注意检查即可。
