Yii 1.x 不支持原生 layout 嵌套，正确做法是用视图继承+占位符传递：主 layout 中调用 $this->beginContent() 包裹子 layout，子 layout 通过 echo $content 插入最终视图。
layout 里嵌套另一个 layout 怎么写
Yii 1.x 不支持原生的 layout 嵌套（比如 main.php 中直接 $this->renderPartial('sub-layout') 再塞进 $content），强行嵌套会导致 $content 渲染两次或变量作用域丢失。正确做法是用「视图继承」+「占位符传递」，本质是单层 layout 承载多级结构语义。
实操建议：
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
- 在主 layout（如
protected/views/layouts/main.php）中，用$this->beginContent()+$this->endContent()包裹子 layout 的调用，子 layout 再通过echo $content插入最终视图 - 子 layout 文件（如
protected/views/layouts/columns.php）不能直接 echo 输出，必须以<?php echo $content; ?>结尾，否则内容被截断 - 控制器中仍只调用
$this->layout = 'main'，子 layout 由 main 主动引入，不要在 controller 里设两层 layout 变量
三栏 frameset 布局在 Yii 1 中怎么落地
frameset 是 HTML4 旧标准，现代 Yii 项目应避免使用——它破坏前进/后退、SEO 不友好、无法响应式，且 Yii 自身的 layout 机制与 frameset 天然冲突。但若维护老系统，必须用 frameset，则只能绕过 Yii layout 流程，手动输出 HTML。
常见错误现象：headers already sent 或页面空白，因为 Yii 默认输出前已发 HTTP 头，而 frameset 需要纯 HTML 文档开头。
立即学习“前端免费学习笔记（深入）”；
实操建议：
- 在 action 中禁用 layout：
$this->layout = false; - 视图文件（如
index.php）第一行必须是<!DOCTYPE html>，接着写<frameset>，不经过任何 Yii 的render包装逻辑 - 每个 frame 的 src 指向独立 action（如
admin/left、admin/main），这些 action 同样设$this->layout = false，只输出纯 HTML 片段 - 注意 session 共享和 CSRF token 在 frame 间失效问题，需显式传参或改用 cookie-based auth
不同模块用不同 layout 怎么配置
Yii 1 支持按模块指定 layout，但不是在 config/main.php 的 modules 数组里直接写 'layout' => 'xxx' ——那样无效。真正生效的位置是模块类自身的 defaultLayout 属性或控制器中的动态赋值。
实操建议：
- 在模块类（如
protected/modules/admin/AdminModule.php）中定义：public $layout = 'admin'; - 该模块下所有控制器默认使用
protected/views/layouts/admin.php；若某控制器想覆盖，可在 action 中写$this->layout = 'special'; - 如果模块未定义
$layout，则回退到应用级Yii::app()->layout（通常在config/main.php设置） - 注意：模块 layout 文件路径始终相对于
protected/views/layouts/，不随模块路径变化
为什么 $this->render() 里的 $content 不包含子 layout 渲染结果
因为 $content 是 Yii 在执行 $this->render() 时，把当前视图文件（如 site/index.php）的执行结果字符串化后传给 layout 的——它永远只是「当前 action 对应的那个视图」，不会自动递归渲染你手动 include 的其他 layout 文件。
容易踩的坑：
- 在 layout 里写
include 'another-layout.php';，但忘了里面也要有echo $content;，导致最内层内容丢失 - 误以为
$this->render('xxx', array(), false)能返回子视图 HTML 并拼接，其实第三个参数为false仅表示不输出，仍需手动return或echo，且变量作用域不继承 - 用
$this->widget()尝试封装 layout 行为，但 widget 默认不参与 layout 生命周期，无法接管$content
复杂点在于：Yii 1 的 layout 机制是线性的、单次的，没有抽象出「layout stack」概念。所有嵌套意图，都得靠开发者用 beginContent/endContent 或纯 PHP include + 显式变量传递来模拟，稍不注意就断链。
