Yii集成Layui核心卡点在资源加载顺序、表单验证桥接、AJAX数据交互三方面：需通过AssetBundle显式声明JqueryAsset依赖并设JS加载位置为POS_HEAD；ActiveForm须禁用客户端校验，改用layui.form监听submit并手动$.post提交；layui.table需parseData适配Yii返回结构，菜单权限须后端RBAC校验过滤而非仅前端隐藏。
Yii 集成 Layui 不是“套个 CSS 就完事”，核心卡点在资源加载顺序、表单验证桥接、AJAX 数据交互这三块。直接硬塞 layui.js 会导致 form.render() 失效、lay-submit 不触发、table 渲染空白——因为 Yii 的 ActiveForm 默认会拦截 submit 事件，而 Layui 的表单提交依赖原生 DOM 行为。
yii\web\AssetBundle 必须显式声明 jQuery 和 layui 的依赖顺序
很多人把 jquery.min.js 和 layui.js 并列写进 $js 数组，结果 layui 启动时报 jQuery is not defined。
-
LayuiAsset的$depends必须包含yii\web\JqueryAsset（不能只靠yii\web\YiiAsset） -
$jsOptions['position']要设为View::POS_HEAD或View::POS_BEGIN，否则layui.css加载晚于 DOM 渲染，样式错位 - 若项目已用
yii2-jui或其他 JS 组件，需确认它们没覆盖全局$，否则layui.use(['form'], ...)会静默失败
正确示例：
class LayuiAsset extends AssetBundle
{
public $basePath = '@webroot';
public $baseUrl = '@web';
public $css = [
'assets/layuiadmin/layui/css/layui.css',
'assets/layuiadmin/style/admin.css',
];
public $js = [
'assets/layuiadmin/layui/layui.js',
];
public $jsOptions = ['position' => \yii\web\View::POS_HEAD];
public $depends = [
\yii\web\JqueryAsset::class, // 关键：必须显式依赖
];
}
ActiveForm 与 lay-submit 冲突时，禁用 Yii 自动提交并手动接管
当你在 ActiveForm::begin() 里写 lay-submit 按钮，点击后页面刷新或 400 错误，是因为 Yii 的 ActiveForm 默认绑定 submit 事件并执行 AJAX 提交逻辑，而 Layui 的 lay-submit 是纯 DOM 触发，两者互不感知。
- 解决方法：给
ActiveForm::begin()加'enableClientValidation' => false, 'validateOnSubmit' => false，关闭 Yii 前端校验 - 用
layui.use(['form'], function(){...})手动监听form.on('submit(...)')，再用$.post()提交到 Yii 控制器 - 后端控制器要返回 JSON（不是
render()），例如：return $this->asJson(['code' => 0, 'msg' => 'ok', 'data' => []]); - 注意 CSRF：Layui 提交时需带上
X-CSRF-Token请求头，值取自meta[name="csrf-token"]的content属性
layui.table 使用 Yii2 分页接口时，url 和 parseData 必须配对处理
layui.table 默认期望后端返回 {code: 0, count: 100, data: [...]}，但 Yii2 的 ActiveDataProvider 或原生 SQL 查询通常返回二维数组，没有 count 字段，直接传会报 count is undefined。
- 前端 table 的
url应指向一个专用 action（如/admin/user/list），不要复用index视图页 - 必须配置
parseData回调，把 Yii 返回的['dataList' => [...], 'total' => 123]映射为 Layui 要的结构 - 后端 PHP 中避免用
ActiveDataProvider直接toArray()，它默认不带总条数；改用原生查询或手动补totalCount - 如果用了
yii2-grid等扩展，注意它可能劫持响应格式，需在 action 中先Yii::$app->response->format = Response::FORMAT_JSON;
示例 parseData：
parseData: function(res){
return {
"code": res.code || 0,
"msg": res.msg || "",
"count": res.total || 0,
"data": res.dataList || []
};
}
菜单权限控制不能只靠 config/menu.php，必须和 RBAC 规则联动
看到 config/menu.php 里写了 ['url' => '/admin/user']，就以为用户有权限访问？错。Yii 的 UrlRule 只负责路由匹配，不校验权限。Layui 左侧菜单渲染出来，但点击 403，说明权限没透传到前端渲染逻辑。
-
config/menu.php中的url必须是 RBAC 中已定义的权限项（即authManager->addPermission()创建过的） - 菜单生成前，应调用
Yii::$app->user->can($permissionName)过滤掉无权项，而不是全量渲染再前端 hide - 常见坑：菜单项 URL 写成
['/admin/user/index']，但 RBAC 中注册的是admin/user（省略 action），导致can()返回 false - 建议封装一个
MenuHelper::getAccessibleMenu()，内部遍历 menu 配置并逐条can()校验，再递归过滤子项
最易忽略的一点：layuiadmin 的侧边栏是前端渲染的，如果后端没做过滤，菜单项即使不可点，URL 仍可被手动输入访问——权限控制必须双端一致，后端鉴权不可绕过。
