先安装Yii2并熟悉项目结构，再通过创建页面和连接数据库实践MVC流程。使用Composer创建基础项目后，访问web目录验证安装；掌握web、config、controllers、views等目录作用；在SiteController添加actionAbout方法并创建对应视图文件实现新页面；配置config/db.php连接数据库，用Gii生成User模型类，通过ActiveRecord操作数据。动手体验路由、表单验证等功能，逐步进阶REST API与权限控制。

想快速上手 Yii2 框架？别被“框架”两个字吓到。Yii2 虽然是一个功能强大的 PHP 全栈框架，但它的结构清晰、文档完善，非常适合有一定 PHP 基础的新手快速入门。下面是一个实用的入门路径，带你从零开始搭建第一个 Yii2 应用。

安装与环境准备

在开始之前，确保你的开发环境满足基本要求：PHP 5.4 或更高版本（推荐 PHP 7.4+），Composer 已安装，以及 Web 服务器（如 Apache 或 Nginx）配置好。

Yii2 推荐使用 Composer 来安装，这是最简单的方式：

• 打开终端，运行命令：composer create-project –prefer-dist yiisoft/yii2-app-basic basic
• 这会创建一个名为 basic 的基础项目
• 进入目录：cd basic
• 在浏览器中访问 http://localhost/basic/web，看到 “Congratulations!” 页面就说明成功了

理解项目结构

Yii2 的目录结构是约定优于配置的典型体现。掌握关键目录的作用，能让你少走弯路。

• web/：入口文件 index.php 所在目录，所有公共访问都应指向这里
• config/：存放应用配置文件，如数据库连接、路由等
• controllers/：控制器目录，处理用户请求
• views/：视图文件，负责展示页面
• models/：数据模型，用于操作数据库或封装业务逻辑
• runtime/ 和 assets/：运行时生成的缓存和资源文件，需确保 Web 服务器有写权限

创建第一个页面

我们来添加一个简单的“关于”页面，体验 Yii2 的 MVC 流程。

• 在 controllers/SiteController.php 中添加一个动作方法：

public function actionAbout()
{
return $this->render(‘about’);
}

• 在 views/site/ 目录下新建文件 about.php，内容可以是：

关于我们

这是一个使用 Yii2 框架构建的页面。

• 访问 http://localhost/basic/web/index.php?r=site/about 就能看到新页面了

连接数据库与使用模型

大多数应用都离不开数据库。Yii2 的 ActiveRecord 让数据库操作变得非常简单。

• 在 config/db.php 中配置你的数据库信息：

return [
‘class’ => ‘yii\db\Connection’,
‘dsn’ => ‘mysql:host=localhost;dbname=yii2basic’,
‘username’ => ‘root’,
‘password’ => ”,
‘charset’ => ‘utf8’,
];

• 创建一张表，比如 user 表，包含 id, name, email 字段
• 使用 Gii（Yii2 内置的代码生成工具）生成模型：
• 访问 http://localhost/basic/web/index.php?r=gii
• 点击 “Model Generator”，输入表名 user，生成模型类 User.php
• 之后就可以在控制器中使用：$users = User::find()->all();

基本上就这些。Yii2 的强大之处在于它提供了路由、表单验证、分页、缓存、安全防护等开箱即用的功能。新手可以从基础应用入手，逐步尝试模块化、REST API、RBAC 权限控制等高级特性。关键是动手实践，边做边学，很快就能掌握核心用法。