先安装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 流程。
本套教程,以一个真实的学校教学管理系统为案例,手把手教会您如何在一张白纸上,从零开始,一步一步的用ThinkPHP5框架快速开发出一个商业项目,让您快速入门TP5项目开发。
- 在 controllers/SiteController.php 中添加一个动作方法:
- 在 views/site/ 目录下新建文件 about.php,内容可以是:
关于我们
这是一个使用 Yii2 框架构建的页面。
- 访问 http://localhost/basic/web/index.php?r=site/about 就能看到新页面了
连接数据库与使用模型
大多数应用都离不开数据库。Yii2 的 ActiveRecord 让数据库操作变得非常简单。
- 在 config/db.php 中配置你的数据库信息:
- 创建一张表,比如 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 权限控制等高级特性。关键是动手实践,边做边学,很快就能掌握核心用法。









