Yii整合AdminLTE教程详解

Yii2后台集成AdminLTE失败，往往并非模板本身问题，而是三大关键环节未对齐：views路径覆盖不全（必须完整复制到backend/views/并确保layouts与site双目录同步）、as access权限拦截配置错误（需精确设置allowActions为['site/*', 'admin/*']并避免重复定义）、以及菜单数据未正确加载（依赖Menu::getItems()动态获取且需数据库路由同步+缓存清理）；只要逐一核验这三处，90%的样式失效、菜单空白、无限重定向和404/500报错都能立竿见影地解决。

AdminLTE 在 Yii2 后台集成失败，大概率不是模板本身的问题，而是 views 覆盖路径、as access 拦截逻辑、或路由权限未预热这三处没对齐。直接按标准流程走，90% 的“样式不生效”“菜单不显示”“404/500 刷屏”都能当场解决。

复制 views 时必须覆盖 backend/views/layouts 和 site

很多人只复制了 layouts，漏掉 site，结果登录页是 AdminLTE 样式，但首页还是默认白板；或者反过来，首页有菜单但登录框错位。这是因为 AdminLTE 的 left.php（侧边栏）、main.php（主布局）、login.php（登录页）分散在两个目录里。

• 来源路径一定是：vendor/dmstr/yii2-adminlte-asset/example-views/yiisoft/yii2-app/
• 目标路径必须是：backend/views/（不是 views/ 或 frontend/views/）
• 复制后检查：backend/views/layouts/left.php 文件是否存在且内容含 AdminLTE 字样（搜索 sidebar-menu 或 skin-blue 可快速验证）
• 如果用的是 yii2-adminlte3（hail812 版），路径略有不同：vendor/hail812/yii2-adminlte3/example-views/yiisoft/yii2-app/，别混用

as access 配置错误会导致菜单空白或无限重定向

启用 mdmsoft/yii2-admin 后，as access 组件会拦截所有未授权请求。但如果配置里漏写了 admin/* 或写成 admin/（少一个星号），就会导致 /admin/menu 进不去、/admin/route 403、甚至整个左侧菜单渲染为空 —— 因为菜单数据是通过 admin/menu 接口动态加载的，接口被拦，前端就收不到任何菜单项。

• 正确写法：'allowActions' => ['site/*', 'admin/*']（注意末尾的 *）
• 临时调试时可设为 ['*']，但上线前必须删掉或收紧
• 如果已配置但仍 403，检查是否在 backend/config/main.php 中重复定义了 as access —— 多个同名行为会互相覆盖
• 还有一种常见情况：用户没分配任何角色，authManager 返回空权限，菜单自然为空。用 admin 用户测试前，先确保它绑定了 /* 权限

菜单不显示？先确认 left.php 是否读取了真实菜单数据

AdminLTE 的侧边栏不是静态 HTML，而是靠 PHP 循环 $menuItems 渲染的。这个变量来自 mdm\admin\components\Menu::getItems()，底层依赖 authManager 查询数据库。如果菜单列表页面能打开但侧边栏空白，说明数据没传进来。

• 打开 backend/views/layouts/left.php，找到类似 foreach ($menuItems as $item) 的循环，确认上面有没有 use mdm\admin\components\Menu; 或 $menuItems = Menu::getItems();
• 如果用了旧版拷贝（比如从 yii2-app-basic 复制的），里面可能压根没调 Menu::getItems()，而是写死的数组，这种必须手动替换
• 检查数据库表 auth_item 和 auth_item_child 是否有你添加的菜单路由（如 /admin/role/index），没有就说明 /admin/route 页面没点“刷新”或“同步”按钮
• 路由缓存也可能干扰：执行 php yii cache/flush-schema 或清空 @runtime/cache/ 目录再试

最常被忽略的一点：AdminLTE 的 left.php 默认只渲染一级和二级菜单，如果你加了三级菜单（比如“角色 → 权限 → 分配”），但没在 Menu::getItems() 的递归逻辑里放开深度限制，它就不会显示。这不是 bug，是设计如此 —— 真实项目中三级以上菜单体验差，建议用 Tab 或 Modal 替代。

文中关于Yii框架的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Yii整合AdminLTE教程详解》文章吧，也可关注golang学习网公众号了解相关技术文章。