Windows 下安装 Yii 框架完整指南

Yii 是一个高性能的 PHP 框架，特别适合开发大型 Web 应用。本文将详细介绍在 Windows 系统下通过 GitHub 安装 Yii 框架的完整流程，包括环境准备、安装步骤和常见问题解决。

环境准备

在开始安装 Yii 之前，需要确保你的 Windows 系统已具备以下环境：

1. PHP 环境：Yii 2.0 需要 PHP 5.4 或更高版本，推荐使用 PHP 7.4+
2. Composer：PHP 的依赖管理工具
3. Git：版本控制工具
4. Web 服务器：Apache 或 Nginx（也可使用 PHP 内置服务器）

安装步骤

1. 安装 Composer

首先需要安装 Composer，这是安装 Yii 的必备工具：

1. 访问 Composer 官网下载 Windows 安装包
2. 运行安装程序，按照向导完成安装
3. 安装完成后，打开命令提示符，输入 composer -V 验证是否安装成功

2. 通过 GitHub 安装 Yii

Yii 官方在 GitHub 上维护了项目仓库，我们可以通过 Composer 从 GitHub 安装：

1. 打开命令提示符（CMD）或 PowerShell
2. 切换到你的 Web 服务器目录（如 cd C:\xampp\htdocs）
3. 执行以下命令安装基础应用模板：

composer create-project --prefer-dist yiisoft/yii2-app-basic yii-basic

如果你想安装高级应用模板（包含前后台分离结构），使用：

composer create-project --prefer-dist yiisoft/yii2-app-advanced yii-advanced

3. 初始化应用

安装完成后，需要初始化应用：

1. 进入项目目录：cd yii-basic
2. 执行初始化命令：php init
3. 按照提示选择开发环境（Development）并确认

4. 配置 Web 服务器

使用 PHP 内置服务器（快速测试）：

php yii serve

默认会在 http://localhost:8080 启动服务。

配置 Apache：

1. 修改 httpd.conf 文件，确保启用了 mod_rewrite
2. 在项目目录下创建 .htaccess 文件（基础模板已包含）
3. 配置虚拟主机指向项目 web 目录

常见问题解决

1. Composer 安装速度慢：

   • 使用中国镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

2. 缺少 PHP 扩展：

   • 常见需要启用的扩展：mbstring, pdo, openssl, fileinfo
   • 在 php.ini 中取消对应扩展的注释

3. 权限问题：

   • 确保 runtime 和 web/assets 目录可写

4. GitHub 连接问题：

   • 如果直接从 GitHub 克隆遇到问题，优先使用 Composer 安装

安装后优化

1. 配置数据库： 修改 config/db.php 文件配置你的数据库连接

2. 启用 Gii 代码生成器： 在开发环境中，可以通过 http://localhost/path/to/web/index.php?r=gii 访问 Gii 工具

3. 更新框架： 定期使用 composer update 保持框架最新

通过以上步骤，你应该已经成功在 Windows 系统下通过 GitHub 安装了 Yii 框架。Yii 提供了强大的功能和良好的文档支持，是开发 PHP 应用的优秀选择。