Yii是一款用PHP编写的高性能全栈Web框架，采用严格的MVC分层设计和组件化结构。对新手而言，最难的不是语法，而是搞清楚请求从浏览器到达代码再到页面返回的完整链路。本文会沿着环境准备、项目初始化、核心概念、基础功能开发这条主线，说明入门Yii时每一步该做什么、为什么这样做。
一、准备运行环境与创建项目
开始学习Yii前，本地需要具备PHP运行环境（建议PHP 7.4以上）以及Composer依赖管理工具。Yii官方通过Composer分发代码包，手动下载源码不仅容易缺文件，也难以处理后续的扩展升级。使用Composer能确保自动加载机制和版本约束都符合框架要求。
最推荐的方式是直接用Composer生成官方的基础模板。基础模板包含了完整的目录结构、默认路由和一套可运行的示例页面，适合理解框架骨架。执行下面命令即可创建名为 basic 的项目：
# 使用 Composer 创建 Yii 基础应用模板 composer create-project yiisoft/yii2-app-basic basic
创建完成后进入项目目录，通过内置PHP服务器启动应用：
cd basic php yii serve
此时访问 http://localhost:8080 就能看到Yii的欢迎页。这一步的意义在于让你确认环境无误，并直观看到入口文件 web/index.php 如何被Web服务器指向，从而启动整个框架的生命周期。
二、理解MVC与请求流转
Yii严格遵循MVC模式。浏览器发出的请求首先进入 web/index.php 入口脚本，框架据此加载配置并创建应用实例。应用通过URL管理组件解析路由，确定要调用的控制器与动作。控制器负责协调模型与视图：模型用ActiveRecord封装数据库操作，视图则是纯展示层的PHP模板。
以默认站点控制器为例，下面的代码展示了控制器动作如何传递数据给视图。注意这里没有手写SQL，模型层已帮你处理数据存取：
<?php
namespace appcontrollers;
use yiiwebController;
class SiteController extends Controller
{
// 动作 index 对应路由 /site/index
public function actionIndex()
{
$message = '当前时间是：' . date('Y-m-d H:i:s');
// 渲染 views/site/index.php 并传入变量
return $this->render('index', [
'message' => $message,
]);
}
}
对应视图文件 views/site/index.php 可以这样写，框架会把 $message 自动注入：
<?php
use yiihelpersHtml;
?>
<h3><?= Html::encode($message) ?></h3>
</p>
<p>这种分层带来明显好处：业务逻辑集中在模型，页面调整不影响数据处理，控制器只做调度。新手常犯的错误是把数据库查询直接写进视图，导致后期无法维护。理清这一层关系，才算真正踏入Yii开发。</p>
<h2>三、用Gii快速生成代码</h2>
<p>Gii是Yii自带的代码生成模块，能基于数据表结构一键生成模型、控制器和增删改查页面。对新手来说，它是理解框架约定的最佳工具，也比自己从零写CRUD更不易出错。</p>
<p>先在配置文件 config/web.php 中确保Gii模块已启用（基础模板默认开启），然后访问 http://localhost:8080/gii。选择 Model Generator，填写表名如 post，便会生成对应的 Post 模型类。接着用 CRUD Generator 指定模型和控制器ID，就能得到完整的列表、新增、编辑、删除界面。</p>
<pre class=brush:php;toolbar:false>
// 生成的 Post 模型片段示例
namespace appmodels;
use yiidbActiveRecord;
class Post extends ActiveRecord
{
// 指定数据表名，默认按类名复数推断
public static function tableName()
{
return '{{%post}}';
}
// 字段验证规则
public function rules()
{
return [
[['title', 'content'], 'required'],
[['content'], 'string'],
[['created_at'], 'integer'],
];
}
}
通过Gii生成的代码遵循框架标准写法，你可以直接运行，再对照源码学习路由如何映射、表单如何用 ActiveForm 构建。这种“先跑通再读码”的路径，比单纯看文档效率更高。
四、掌握路由与表单验证
Yii的路由默认格式为 ?r=控制器/动作，也可在配置中开启美化URL。理解路由规则，才能知道用户访问的地址会落到哪段代码。同时在接收用户输入时，必须依赖模型的 rules() 方法做校验，防止脏数据进库。
下面示例展示了一个简单的联系表单模型及其控制器动作，体现了验证流程：
// models/ContactForm.php
namespace appmodels;
use yiibaseModel;
class ContactForm extends Model
{
public $name;
public $email;
public $body;
public function rules()
{
return [
[['name', 'email', 'body'], 'required'],
['email', 'email'],
];
}
}
// controllers/SiteController.php 片段
public function actionContact()
{
$model = new appmodelsContactForm();
if ($model->load(Yii::$app->request->post()) && $model->validate()) {
// 验证通过，可发送邮件或存库
return $this->refresh();
}
return $this->render('contact', ['model' => $model]);
}
视图中通过 ActiveForm 挂接模型，字段错误会自动回显。新手应重点练习这一闭环：定义规则、加载数据、校验、处理。它几乎覆盖了后台管理类应用的大部分交互场景。
五、下一步该深入的方向
走完上述路径后，你已经能用Yii写出带数据库的完整页面。接下来建议按顺序了解：数据库迁移工具、行为（Behavior）复用逻辑、事件机制解耦代码、以及REST控制器快速暴露接口。每一步都建立在前面跑通的项目之上，不必另起炉灶。
入门Yii的关键不是背下所有类和方法，而是先建立“请求—路由—控制器—模型—视图”的全局认知，再用Gii和示例反推框架设计。顺着这条路径，从空白目录到可维护的小型系统，通常一周内就能实现。