ThinkPHP整合Layui后台的核心是避免硬套AdminLTE的iframe思路，因其SPA结构导致菜单激活失效、tab无法管理、URL丢失、刷新归零及样式冲突；应选用layuiAdmin iframe版，通过外壳+iframe注入+tabsPage统一管理，并配合TP6的url()生成路由与权限前后端协同控制。
ThinkPHP 整合 Layui 后台，核心不是“能不能用”，而是“怎么避免踩坑”——尤其是别硬套 AdminLTE 的 iframe 思路。Layui 本身不带路由或状态管理，得靠 ThinkPHP 的视图层和前端 JS 协同控制，否则菜单跳转失效、tab 标签打不开、刷新丢页面都是常态。
为什么不能直接把 AdminLTE 当 Layui 用
AdminLTE 是单页应用（SPA）结构，window.location.href 跳转整个页面；它没有 iframe 加载逻辑，也不维护 tab 历史栈。你强行改菜单 href 为 javascript:void(0) 并塞进 <iframe src="...">，会立刻遇到：
-
.active类不会同步到左侧菜单 —— 因为激活逻辑绑定在<a>上，和 iframe 内容无关 - 浏览器前进/后退按钮无效 —— AdminLTE 没调用
history.pushState - 刷新后 iframe 回到初始地址（比如
index.html），所有已开 tab 全丢，且无还原机制 - 主题样式（如
skin-blue）作用于<body>，iframe 内页面需单独引入 CSS，极易冲突或漏载
用 layuiAdmin iframe 版才是正解
layuiAdmin 官方 iframe 版本（layadmin-iframe）是专为这类场景设计的：外壳（index.html）固定，含 header、left menu、tab bar；所有业务页以 <iframe src="xxx"> 注入到 layadmin-tabsbody-item 容器中，由 tabsPage 模块统一管理。
- 菜单点击时拦截
data-url属性（如data-url="{:url('user/list')}"），自动新开 tab - 每个 tab 对应独立
<iframe>，src是 ThinkPHP 生成的真实路由（如/index.php?s=user/list） - tab 关闭时调用
iframe.contentWindow.destroy?.()（如果页面暴露该方法），防内存泄漏 - URL 参数可透传：访问
/index.php?transferUrl=/order/detail&openTabsName=订单详情，启动时自动解析并打开对应 tab
ThinkPHP 6 集成 layuiAdmin iframe 版三步到位
别碰 AdminLTE，直接上 layuiAdmin 官方 iframe 版 + ThinkPHP 6 的视图替换能力，最稳。
立即学习“PHP免费学习笔记（深入）”；
- 把
layuiAdmin.std的静态资源（layui/、style/、lib/）放进 ThinkPHP 的public/static/admin/目录 - 在 ThinkPHP 的模板配置中加替换规则：
'__admin__' => '/static/admin/'，这样模板里写<link href="__admin__/layui/css/layui.css">就能正确解析 - 后端控制器返回的 URL 必须用 ThinkPHP 的
url()函数生成（如{:url('user/list')}），确保路由兼容性；禁用伪静态时注意s=参数是否保留
权限与菜单必须前后端对齐
Layui 不管权限，全靠 ThinkPHP 控制输出。常见错误是菜单渲染了但点击 403，或者按钮显示了但接口拒绝访问。
- 菜单数据从后端接口（如
api/menu）动态拉取，字段含href（对应url()结果）、title、icon，前端只做渲染，不做权限判断 - 按钮级权限用注解（如
@Auth('user.delete')）配合中间件拦截，同时前端 JS 根据用户权限列表hide或disable对应按钮（别只靠 CSS 隐藏） - iframe 页面内需主动读取全局权限变量（如
window.AUTH_LIST = ['user.add', 'user.edit']），避免每次请求都查后端
真正麻烦的从来不是引入 JS 和 CSS，而是 tab 状态、URL 同步、权限上下文这三件事没串起来 —— 这些点一旦漏掉，开发后期调试成本会指数级上升。
