使用Yii框架可3–5分钟快速搭建后台管理系统骨架:通过yiic或yii命令生成应用,集成RBAC权限管理,配置AdminLTE等UI框架,创建admin模块及用户、菜单、角色模型,并初始化数据库与管理员账号。

用 Yii 快速搭建后台管理系统骨架,核心是借助框架自带的命令行工具 yiic(Yii 1.1)或 yii(Yii 2+),配合合理目录结构和基础权限模块,3–5 分钟即可生成可运行的雏形。
使用 yiic 或 yii 命令一键生成应用
这是最直接的方式。确保已正确安装 Yii 并配置好 PHP 环境路径:
- Yii 1.1:进入
framework目录,执行:./yiic webapp /path/to/your/admin(Linux/macOS)
或yiic webapp \path\to\your\admin(Windows) - Yii 2.x:推荐用 Composer 创建:
composer create-project --prefer-dist yiisoft/yii2-app-basic admin
如需带高级模板(含后台常用结构),改用:composer create-project --prefer-dist yiisoft/yii2-app-advanced admin - 生成后,将
admin目录放到 Web 服务器根目录(如htdocs或www),访问http://localhost/admin/web/即可见欢迎页
快速集成 RBAC 权限管理基础
后台系统离不开权限控制。Yii 内置 RBAC 支持,无需从零写逻辑:
- Yii 1.1:启用
CPhpAuthManager或CDbAuthManager,在main.php配置:'authManager' => array('class' => 'CPhpAuthManager') - Yii 2.x:在
config/web.php中配置authManager组件,推荐使用数据库方式:'authManager' => ['class' => 'yii\rbac\DbManager'],再执行yii migrate --migrationPath=@yii/rbac/migrations初始化数据表 - 用 Gii 工具(
/index.php?r=gii)生成权限管理 CRUD 界面,或手动调用yii rbac/init命令创建默认角色(如 admin、user)
添加后台常用模块与布局
骨架要像后台,得有统一导航、侧边栏和响应式结构:
- 在
views/layouts/main.php中替换默认布局,引入 AdminLTE、Ant Design 或 Bootstrap 4+ 的后台 UI 框架 - 新建
modules/admin模块(Yii 2.x 推荐),把用户管理、菜单配置、日志查看等归入其中,避免控制器堆积在controllers根目录 - 为后台定制
UrlManager规则,例如让/admin/user/index映射到admin/user,提升可读性 - 在
components下添加AdminController基类,统一处理登录校验、权限检查($this->checkAccess('admin'))和面包屑生成
初始化数据库与基础模型
后台离不开用户、角色、菜单三张核心表:
- 用 Gii 生成
User、Menu、Role模型及对应 CRUD 控制器 - 修改
User模型继承yii\web\IdentityInterface,实现findIdentity()、validatePassword()等方法,支撑登录逻辑 - 菜单表建议支持父子结构(
parent_id字段),配合递归查询生成左侧导航;可用ActiveRecord::find()->with('children')一次加载 - 首次运行前执行数据库迁移(Yii 2.x)或导入 SQL(Yii 1.1),填入初始管理员账号(如 username: admin, password: 123456)


















