悠悠楠杉
网站页面
Yii框架环境安装：详细步骤指南
11/13
在现代Web开发中，选择一个高效、稳定的PHP框架至关重要。Yii框架以其高性能、良好的扩展性和清晰的MVC架构，成为许多开发者构建中小型项目的首选。然而，对于刚接触Yii的新手来说，如何正确搭建开发环境常常是一道门槛。本文将带你一步步完成Yii框架的环境安装，确保你能在本地顺利运行第一个Yii应用。
首先，我们需要准备基础的本地服务器环境。推荐使用XAMPP，它集成了Apache、MySQL、PHP和phpMyAdmin，安装简单，管理方便。前往Apache Friends官网下载对应操作系统的XAMPP安装包。以Windows系统为例，下载完成后双击安装程序，建议将XAMPP安装在根目录如 C:\xampp，避免路径中出现中文或空格。安装过程中可根据提示选择需要的组件，通常默认全选即可。安装完成后启动XAMPP控制面板，依次开启Apache和MySQL服务，打开浏览器访问 http://localhost，若看到XAMPP欢迎页面，则说明本地服务器已正常运行。
接下来是PHP依赖管理工具Composer的安装。Yii框架通过Composer进行包管理和项目初始化。前往getcomposer.org官网下载Windows安装程序，运行后按照向导完成安装。安装完成后，打开命令提示符（CMD）输入 composer --version，如果显示版本号，说明Composer已成功配置。为加快国内访问速度，建议设置国内镜像源。执行以下命令：
bash
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
这将全局设置阿里云镜像，大幅提升依赖下载速度。
现在，我们正式进入Yii框架的安装环节。Yii官方提供了两种版本：稳定版Yii 2和新一代的Yii 3。本文以广泛使用的Yii 2为例。在XAMPP的 htdocs 目录下（即 C:\xampp\htdocs），新建一个项目文件夹，例如 my-yii-app。打开命令行，进入该目录：
bash
cd C:\xampp\htdocs\my-yii-app
然后执行以下命令来创建一个基础的Yii 2应用：
bash
composer create-project yiisoft/yii2-app-basic .
该命令会从Packagist下载Yii 2的基本应用模板，并自动安装所有依赖。整个过程可能需要几分钟，请耐心等待。安装完成后，你会看到项目目录中包含 config、controllers、views、web 等标准结构。
为了让项目通过浏览器访问，我们需要配置虚拟主机或直接使用子路径。最简单的方式是通过 http://localhost/my-yii-app/web/ 访问。但为了更好的开发体验，建议配置虚拟主机。编辑 C:\xampp\apache\conf\extra\httpd-vhosts.conf 文件，添加如下内容：
apache
<VirtualHost *:80>
DocumentRoot "C:/xampp/htdocs/my-yii-app/web"
ServerName yii.local
<Directory "C:/xampp/htdocs/my-yii-app/web">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
保存后，修改系统hosts文件（位于 C:\Windows\System32\drivers\etc\hosts），添加一行：
127.0.0.1 yii.local
重启Apache服务，打开浏览器访问 http://yii.local，如果看到“Congratulations!”页面，说明Yii框架已成功运行。
最后，别忘了配置数据库。进入 config/db.php 文件，根据你的MySQL设置修改用户名、密码和数据库名。你可以使用phpMyAdmin创建新数据库，并导入Yii所需的初始数据表（如有需要）。
至此，Yii框架的本地开发环境已全部搭建完毕。你可以开始创建控制器、模型和视图，深入探索Yii的强大功能。整个过程虽然涉及多个组件，但只要按步骤操作，绝大多数问题都能避免。记住，良好的开发环境是高效编码的第一步。
