罗罗编程学习记录
本页内容 展开查看

06.5.3.14 小部件视图与主题

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.3 Yii

06.5.3.14-001 小部件(Widget)在 Yii 中是什么,生命周期如何?

一句话结论

小部件是可复用的视图组件,封装渲染逻辑与配套资源;典型生命周期为 begin()/end() 包裹内容,内部先 init() 初始化,再 run() 生成输出,也可通过静态 widget() 直接渲染独立片段。

概念解释

小部件继承 yii\base\Widget,init() 做配置校验与前置准备,run() 返回渲染内容或输出 HTML。包裹式用法允许在 begin 与 end 之间插入视图内容,由小部件包裹输出;独立用法直接调用 widget() 渲染自包含片段。小部件不承担业务数据查询,数据由控制器/服务准备后传入。

原理流程

  1. 配置小部件属性。
  2. begin() 注册小部件实例并调用 init()。
  3. 包裹内容在视图中编写。
  4. end() 调用 run(),组装并返回最终 HTML。

代码或图示

// 独立小部件
echo \yii\widgets\ListView::widget([
    'dataProvider' => $provider,
    'itemView' => '_item',
]);

// 包裹式小部件示意
$form = \yii\widgets\ActiveForm::begin();
// 字段内容
\yii\widgets\ActiveForm::end();

常见误区

  • 在小部件内直接查库:视图组件变成业务层,难以复用与测试。
  • init() 里输出内容:初始化只做准备,输出应在 run()。

追问

  • 小部件与视图局部片段区别?答:片段是纯模板文件;小部件带类逻辑、配置与资源注册,可跨项目复用。
  • 自定义小部件如何传数据?答:公共属性接收数据提供者、视图名、选项等;复杂对象由上层注入。

06.5.3.14-002 GridView 如何配置列与数据提供者?

一句话结论

GridView 接收 dataProvider 提供分页数据,columns 声明每列的属性、格式与内容;支持属性列、显式定义列、操作列与过滤模型,列表展示与数据查询分离。

概念解释

列可直接写属性名,框架按格式化器输出;显式列用 ['attribute' => ..., 'format' => ..., 'value' => ...] 定义取值与渲染。filterModel 配合过滤条件显示筛选行;formatter 控制日期、数字、布尔等输出格式。数据提供者负责分页、排序与结果装配。

原理流程

  1. 控制器准备 ActiveDataProvider。
  2. 视图实例化 GridView,传入提供者与列配置。
  3. 小部件遍历当前页记录渲染各列。
  4. 分页/排序链接由数据提供者与 URL 规则生成。

代码或图示

echo GridView::widget([
    'dataProvider' => $provider,
    'filterModel' => $searchModel,
    'columns' => [
        'id',
        'title',
        ['attribute' => 'status', 'format' => 'raw', 'value' => fn($m) => $m->statusLabel],
        ['class' => 'yii\grid\ActionColumn'],
    ],
]);

常见误区

  • 列里直接拼用户内容不转义:format 为 raw 时需自行确认内容可信,默认格式按上下文编码。
  • 在 GridView 内做重查询:每行触发关联查询导致 N+1,应在数据提供者侧预加载(参见 06.5.3.7-012)。

追问

  • 排序字段如何限制?答:数据提供者排序配置允许排序的属性;未列入的字段不生成排序链接。
  • 导出与列表复用什么?答:复用 SearchModel 查询与数据组装;导出走独立动作,不依赖 GridView 渲染。

06.5.3.14-003 ActiveForm 如何绑定模型并生成字段?

一句话结论

ActiveForm 包裹表单开始与结束,field() 绑定模型属性生成标签、输入控件与错误提示;提交后控制器 load() 接收入参并 validate() 校验。

概念解释

field($model, $attribute) 返回字段构造器,链式选择输入类型(textInput、dropDownList、fileInput 等);表单自动输出 CSRF 隐藏字段。模型规则决定校验与错误显示;客户端校验由表单配置控制(见 06.5.3.10-017)。表单 action 与 method 按配置生成。

原理流程

  1. 视图 ActiveForm::begin() 输出 <form> 与隐藏令牌。
  2. 逐字段调用 field() 渲染控件与错误占位。
  3. end() 闭合表单。
  4. 提交后控制器加载模型并校验。

代码或图示

$form = ActiveForm::begin();
echo $form->field($model, 'title')->textInput(['maxlength' => true]);
echo $form->field($model, 'status')->dropDownList($statusList);
echo Html::submitButton('保存');
ActiveForm::end();

常见误区

  • 字段名与模型属性不一致:错误提示与批量赋值对不上。
  • 表单内手写控件绕过 field():丢失错误绑定与标签联动。

追问

  • 表单模型与 AR 都能用 ActiveForm 吗?答:可以,只要实现模型基类的属性与规则接口。
  • 多步表单如何组织?答:分步表单模型分别校验,服务层协调提交;单表单小部件不承载跨步骤状态。

06.5.3.14-004 ListView 与 DetailView 各适用什么场景?

一句话结论

ListView 渲染多条记录的列表(每项一个视图片段),DetailView 展示单条记录的属性键值对;前者配合数据提供者分页,后者用于详情页与只读摘要。

概念解释

ListView 通过 itemView 指定每条记录的局部视图,itemOptions 控制包裹标签;emptyText 处理空集合。DetailView 用 attributes 声明字段与格式,输出定义列表样式的只读展示。两者都依赖格式化器处理值类型。

原理流程

  1. 控制器准备数据提供者或单条模型。
  2. 视图实例化对应小部件并配置视图/属性。
  3. 小部件遍历记录或属性渲染。
  4. 空数据按配置输出占位文本。

代码或图示

echo ListView::widget([
    'dataProvider' => $provider,
    'itemView' => '_item',
    'layout' => '{items}{pager}',
]);

echo DetailView::widget([
    'model' => $model,
    'attributes' => ['id', 'title', 'created_at:datetime'],
]);

常见误区

  • 用 DetailView 做可编辑表单:它是只读展示,编辑走 ActiveForm。
  • ListView 项视图内重复查询关联:预加载在数据提供者侧完成。

追问

  • 列表项视图能访问额外变量吗?答:通过 viewParams 传递共享变量到 itemView。
  • 空列表文案如何定制?答:配置 emptyText 与空选项;国际化文案走翻译组件。

06.5.3.14-005 视图渲染有哪几种方式,查找路径如何确定?

一句话结论

控制器提供 render()(带布局)、renderPartial()(不带布局)、renderAjax()(AJAX 片段);视图按控制器视图目录、模块视图路径与主题映射逐级查找。

概念解释

render() 渲染视图并套布局;renderPartial() 只渲染片段,适合局部刷新与邮件模板;renderAjax() 处理 AJAX 响应中的资源注册。视图名解析:相对当前控制器视图目录,别名引用共享视图。模块视图路径由模块配置决定(见 06.5.3.11-010)。

原理流程

  1. 控制器调用渲染方法并传视图名与参数。
  2. 视图组件按目录约定定位模板文件。
  3. 提取传入变量在模板作用域内使用。
  4. render() 再把内容嵌入布局输出。

代码或图示

// 控制器内
return $this->render('view', ['model' => $model]);
return $this->renderPartial('_summary', ['items' => $items]);

常见误区

  • 视图里用 $_GET 等全局超全局:数据应由控制器传入视图。
  • 跨目录硬编码相对层级:视图移动后路径失效,优先用别名或共享视图路径。

追问

  • 视图变量如何传入?答:渲染方法第二参数为关联数组,键名在模板中成为变量;未定义变量在模板中不可直接访问。
  • 布局在哪里配置?答:控制器或应用 layout 属性指定布局名;模块可覆盖自身布局。

06.5.3.14-006 布局与视图块替换如何工作?

一句话结论

布局是包裹页面内容的公共模板,通过内容占位输出当前视图;视图可定义命名块(block)向布局注入局部内容,实现公共骨架与页面专属片段的组合。

概念解释

应用/控制器配置布局文件,render() 把视图结果放入布局占位。视图中开启块记录内容,布局或父模板按块名取用。块机制支持嵌套与默认内容;页面专属脚本、侧栏片段通过块注入布局,而不是复制布局文件。

原理流程

  1. 配置布局路径与名称。
  2. 视图渲染过程中记录命名块内容。
  3. 布局输出主内容占位与各块位置。
  4. 块缺失时使用布局默认内容。

代码或图示

// 视图中定义块(示意,块 API 以当前视图组件为准,待确认)
$this->beginBlock('sidebar');
echo $this->render('_sidebar');
$this->endBlock();

常见误区

  • 为每个页面复制一份布局:公共骨架改动要改多处,应抽块复用。
  • 块内容依赖布局变量:块由视图定义,只应使用传入视图的数据。

追问

  • 布局切换按什么条件?答:控制器 layout 属性按动作/模块设置;前后台布局分离见 06.5.3.11-014。
  • 布局里能放业务逻辑吗?答:只做展示组装;数据准备在控制器/服务层。

06.5.3.14-007 主题(Theme)如何配置与覆盖视图?

一句话结论

主题组件通过 pathMap 把默认视图目录映射到主题目录,渲染时优先查找主题文件;baseUrl 定位主题静态资源,主题可整体替换外观而不改业务视图源码。

概念解释

pathMap 是默认路径到主题路径的映射数组;视图组件解析视图路径时先检查主题目录,存在则使用,否则回退默认视图。主题资源(CSS/图片/JS)通过 baseUrl 或资源包发布。多主题按应用配置或运行时条件切换。

原理流程

  1. 配置 view 组件主题的路径映射与资源 URL。
  2. 渲染请求解析默认视图路径。
  3. 按映射查找主题覆盖文件。
  4. 命中用主题文件,未命中回退默认。

代码或图示

'components' => [
    'view' => [
        'theme' => [
            'pathMap' => ['@app/views' => '@app/themes/light'],
            'baseUrl' => '@web/themes/light',
        ],
    ],
],

常见误区

  • 主题目录缺文件却以为全局覆盖:未命中回退默认视图,外观不一致。
  • 在主题模板里改业务行为:主题只换展示,逻辑改动留在视图/服务层。

追问

  • 主题与模块视图覆盖关系?答:模块视图路径同样可被 pathMap 映射;查找顺序以视图组件实现为准,待确认。
  • 多套主题如何共存?答:目录分主题存放,配置按环境/用户组切换映射;资源包按主题注册。

06.5.3.14-008 资源包(AssetBundle)如何组织 CSS/JS 与依赖?

一句话结论

资源包类声明 css、js、depends、sourcePath、publishOptions 等,把页面依赖的样式脚本与依赖包分组管理;视图注册资源包后,组件按依赖顺序发布并加载资源。

概念解释

sourcePath 指向未发布的源码目录,发布后复制/链接到 Web 可访问目录;depends 声明其他资源包,保证加载顺序;css/js 列出包内文件;jsOptions、cssOptions 控制加载位置与属性。框架核心资源包提供 jQuery 等基础依赖。

原理流程

  1. 定义资源包类列出资源文件与依赖。
  2. 视图或小部件注册资源包。
  3. 发布器把源码目录发布到 Web 目录。
  4. 布局按依赖顺序输出 CSS 链接与 JS 脚本。

代码或图示

class AppAsset extends \yii\web\AssetBundle
{
    public $sourcePath = '@app/assets/app';
    public $css = ['css/site.css'];
    public $js = ['js/site.js'];
    public $depends = ['yii\web\YiiAsset'];
}

常见误区

  • 页面直接 <script> 引用:绕过资源包依赖排序与发布流程。
  • 循环依赖资源包:加载顺序无法解析,需拆分公共基础包。

追问

  • 资源发布方式有哪些?答:复制发布或符号链接;发布选项按部署环境配置,具体选项名以当前版本为准,待确认。
  • 第三方库怎么进资源包?答:Composer 安装后在资源包 sourcePath/js 中引用 vendor 路径文件,不手工复制到 Web 目录。

06.5.3.14-009 资源发布(publish)机制做什么?

一句话结论

发布机制把 Web 不可直接访问目录中的资源文件复制或链接到 Web 可访问目录,并生成可访问 URL;源码留在应用目录,Web 目录只放发布产物。

概念解释

资源包 sourcePath 通常在应用源码目录;发布器按文件哈希/目录名生成发布路径,AssetManager 提供 URL 映射。文件变更后按发布策略重新发布;生产环境可预发布静态资源,避免请求时复制。

原理流程

  1. 注册资源包触发发布检查。
  2. 发布器比对源码与发布目录。
  3. 复制或建立符号链接,记录 URL 前缀。
  4. 视图输出资源 URL。

代码或图示

源码:@app/assets/app/css/site.css
发布:@webroot/assets/<hash>/css/site.css
URL:@web/assets/<hash>/css/site.css

常见误区

  • 把源码资源直接放 Web 目录:源码与发布产物混放,部署与缓存策略混乱。
  • 发布目录纳入版本管理:产物应在部署时生成,不手工提交。

追问

  • 资源更新后浏览器缓存怎么办?答:发布路径带版本/哈希段,资源变更后路径变化;具体哈希策略以发布器实现为准。
  • 符号链接在共享主机受限怎么办?答:改用复制发布;注意文件权限与目录可写。

06.5.3.14-010 视图中如何注册脚本与样式文件?

一句话结论

视图组件提供 registerCss()、registerJs()、registerCssFile()、registerJsFile() 等方法,按位置(头部、主体、末尾)注册内联与外部资源,并纳入资源包依赖排序。

概念解释

registerJsFile/registerCssFile 引用外部文件,可指定依赖包与位置;registerJs/registerCss 注册内联代码。脚本位置影响执行顺序与 DOM 就绪时机;重复注册同一文件由资源管理器去重。内联脚本应避免拼接未转义的用户内容。

原理流程

  1. 视图调用注册方法登记资源。
  2. 资源管理器按依赖与位置分组。
  3. 布局渲染对应位置输出标签。
  4. 浏览器按顺序加载执行。

代码或图示

$this->registerJsFile('@web/js/order.js', ['depends' => [AppAsset::class]]);
$this->registerJs('Order.init();', \yii\web\View::POS_END);

常见误区

  • 内联脚本直接拼接用户输入:未转义内容形成 XSS 注入点(参见 06.5.3.10-009)。
  • 脚本位置随意:依赖 DOM 的脚本放到头部导致元素未就绪。

追问

  • 注册方法的位置常量有哪些?答:头部、BEGIN、END、READY 等位置,具体常量名以 View 类为准,待确认。
  • 外部文件与资源包如何选?答:成组复用的资源进资源包;页面专属脚本可在视图注册文件。

06.5.3.14-011 格式化器(Formatter)组件如何工作?

一句话结论

格式化器按属性格式把原始值转为展示文本:日期时间、数字、货币、百分比、布尔、枚举标签等;GridView/DetailView/ListView 列通过 format 调用同一套格式化规则。

概念解释

格式名对应格式化方法(date、datetime、integer、decimal、currency、boolean、raw 等);格式化器可配置时区、日期格式、语言与布尔显示文本。视图也可直接调用组件方法格式化值。raw 表示不编码,使用前确认内容可信。

原理流程

  1. 小部件列配置格式名。
  2. 格式化器读取原始值与配置。
  3. 按格式转换为展示字符串。
  4. 输出到页面(非 raw 格式按上下文编码)。

代码或图示

echo Yii::$app->formatter->asDate($model->created_at, 'yyyy-MM-dd');
echo Yii::$app->formatter->asBoolean($model->is_on);

常见误区

  • 所有列用 raw 图方便:关闭编码后用户内容需自行转义,XSS 风险升高。
  • 时间戳直接输出:时区与格式不统一,应走格式化器。

追问

  • 枚举状态怎么显示中文?答:在模型或视图提供标签映射,格式化列 value 取标签;或自定义格式化方法。
  • 多语言数字/日期格式如何切换?答:格式化器配置随应用语言/区域设置,具体配置键以当前版本为准。

06.5.3.14-012 Html 助手提供哪些常用能力?

一句话结论

Html 助手生成安全的标签、链接、表单控件与列表,并对输出值做编码;常用方法包括 encode()、a()、img()、submitButton()、dropDownList()、activeRadioList() 等。

概念解释

助手方法自动处理属性引号与值编码,避免手写 HTML 拼接出错。encode() 是基础转义;生成类方法接受标签属性数组。表单类助手与 ActiveForm 字段构造器配合使用,后者绑定模型错误。

原理流程

  1. 视图需要标签时调用 Html 助手方法。
  2. 方法编码值与属性,拼接合法 HTML。
  3. 属性数组转为标签属性字符串。
  4. 输出到页面。

代码或图示

use yii\helpers\Html;

echo Html::a('查看详情', ['view', 'id' => $model->id], ['class' => 'btn']);
echo Html::encode($model->nickname);

常见误区

  • 手写字符串拼接标签:属性引号与转义容易遗漏,助手更稳妥。
  • 助手方法输出未编码值:确认具体方法是否自动编码,raw 场景显式处理。

追问

  • 链接路由如何生成?答:助手链接 href 接收路由数组,由 URL 管理器生成 URL(参见 06.5.3.4)。
  • Html 与 Url 助手分工?答:Html 生成标签与控件,Url 生成路由 URL;两者配合使用。

06.5.3.14-013 小部件的视图路径与命名空间如何约定?

一句话结论

小部件类按 PSR-4 命名空间放置,自带视图文件在小部件视图目录;getViewPath() 解析目录,自定义小部件可覆盖视图路径,视图名与类位置保持对应。

概念解释

小部件 run() 中通过 $this->render() 渲染自带视图;视图目录约定在类同级 views 下或按配置指定。跨项目复用的小部件包自带模板;项目定制小部件视图可被主题覆盖。命名空间与目录一致才能自动加载。

原理流程

  1. 小部件类按命名空间放对应目录。
  2. render() 解析小部件视图路径。
  3. 加载模板并传入数据。
  4. 主题映射可覆盖小部件视图文件。

代码或图示

widgets/
  CardWidget.php
  views/card.php

常见误区

  • 小部件视图路径写死绝对层级:目录移动后渲染失败,使用基类路径解析方法。
  • 视图命名空间与文件目录不一致:自动加载找不到类。

追问

  • 小部件能否复用应用共享视图?答:可以,渲染时引用共享视图路径或别名;避免小部件反向依赖控制器视图目录。
  • 小部件视图默认布局吗?答:小部件 render 渲染片段,不套应用布局;布局由页面渲染流程处理。

06.5.3.14-014 小部件配置如何复用与注入?

一句话结论

通用小部件可通过继承基类、容器配置默认参数或项目公共小部件类复用;重复出现的配置(列定义、选项)抽到公共类或配置数组,避免每个视图复制一份。

概念解释

项目内高频小部件可封装子类,固定数据格式与视图;容器/服务定位器可预定义小部件配置。复用方式与 DI 容器配置相关(见 06.5.3.2)。小部件仍保持无业务查询职责,数据由上层传入。

原理流程

  1. 识别跨视图重复的小部件配置。
  2. 抽取公共小部件类或配置工厂。
  3. 各视图调用公共组件并传差异化数据。
  4. 调整公共行为时集中修改。

代码或图示

class StatusColumn extends \yii\grid\Column
{
    public $statusMap = [];
    // 渲染逻辑集中在公共列类
}

常见误区

  • 把公共配置复制到每个视图:样式调整要改多处,漏改即不一致。
  • 复用类里硬编码业务数据:应通过属性注入映射表与列表。

追问

  • 容器如何预配置小部件?答:通过容器定义类参数默认值;具体配置方式对照 06.5.3.2 的容器定义机制。
  • 小部件之间能互相调用吗?答:可在视图中组合多个小部件;小部件内部不直接实例化其他业务小部件,组合由视图层完成。

06.5.3.14-015 视图层性能与资源优化有哪些手段?

一句话结论

视图优化包括:片段缓存包裹重渲染片段、资源合并/压缩、避免视图内 N+1 查询、精简视图层级、按需加载脚本样式;数据查询优化在数据层完成,视图只负责渲染。

概念解释

片段缓存减少重复 HTML 渲染(见 06.5.3.12-007);资源发布配合构建产物合并压缩;关联数据在控制器/服务侧预加载。视图内循环不触发新查询;分页控制单次渲染记录数。脚本按页面拆分,避免全站加载大脚本。

原理流程

  1. 数据层预加载关联、准备分页。
  2. 视图按片段缓存包裹高成本区域。
  3. 资源按页面注册,合并压缩产物由发布流程处理。
  4. 渲染期只做模板取值与格式化。

代码或图示

视图优化路径
数据预加载 → 片段缓存 → 资源按需注册 → 精简层级 → 分页控制体量

常见误区

  • 在视图循环里 find() 关联:N+1 在渲染期暴露,应在数据侧 with 预加载。
  • 所有页面加载全套脚本样式:首屏体积偏大,按资源包拆分。

追问

  • 视图缓存与页面缓存如何配合?答:未整页缓存时用片段缓存局部提速;两者粒度与变体不同,见 06.5.3.12-007、06.5.3.12-008。
  • 模板编译缓存属于哪一层?答:由视图/模板引擎实现,本章不展开第三方模板引擎。

06.5.3.14-016 3.0 视图与小部件机制与 2.x 有何对照?

一句话结论

3.0 视图能力位于独立视图包,小部件以接口/类形式装配,资源注册走独立资源包与 PSR 标准;渲染思想延续,但类命名空间、视图组件注册方式与资源发布机制需对照 3.0 包文档确认。

概念解释

2.x 视图组件是应用核心组件;3.0 包化后视图、小部件、资源为独立包,通过容器注入。模板片段、格式化、主题映射等概念延续,具体类名与配置键可能调整。迁移时先盘点自定义小部件与视图注册点,再按新包接口改造。

原理流程

  1. 确认 3.0 视图/资源包版本与接口。
  2. 梳理 2.x 小部件类、视图路径与资源包。
  3. 按新包继承关系与注册方式迁移。
  4. 回归页面渲染、资源加载与主题覆盖。

代码或图示

2.x:yii\base\Widget + yii\web\View + 应用组件
3.0:独立视图包 + 接口化小部件 + 容器装配(具体待确认)

常见误区

  • 照搬 2.x 小部件基类命名空间:3.0 包化后基类位置可能变化。
  • 依赖全局视图组件静态调用:3.0 倾向显式注入视图实例。

追问

  • 哪些视图实践可跨版本复用?答:数据与视图分离、小部件不查库、资源分组、格式化集中、主题覆盖思路。
  • 如何核实 3.0 资源机制?答:查看安装包的资源包接口与发布器实现;本机未装 vendor 时标注待确认。

06.5.3.14-017 主题覆盖优先级与多主题组织要注意什么?

一句话结论

主题文件优先于默认视图,但未覆盖文件回退默认;多主题目录按主题隔离资源与模板,切换配置时保证所选主题文件齐备,避免半覆盖状态。

概念解释

pathMap 可配置多组映射;视图解析按映射顺序查找。多主题共享的公共片段抽基础模板,主题只覆盖差异部分。主题切换后需检查资源 URL 与发布路径对应新主题目录。主题不是模块,不承载业务路由。

原理流程

  1. 规划主题目录与共享基础模板。
  2. 配置路径映射与资源 URL。
  3. 渲染时按映射优先级查找。
  4. 未命中回退默认视图。

代码或图示

themes/
  light/   浅色主题覆盖视图与资源
  dark/    深色主题覆盖视图与资源
views/     默认基础视图

常见误区

  • 主题只覆盖部分文件:混合外观,需明确哪些差异必须覆盖。
  • 主题间复制公共片段:公共部分应留在基础视图,主题只写差异。

追问

  • 主题能按用户分组切换吗?答:可在运行时更换 view 组件主题配置;切换需保证资源可访问。
  • 主题版本如何管理?答:资源路径带版本段,模板随代码库版本发布;旧缓存路径需清理。

06.5.3.14-018 视图与控制器之间的数据传递有哪些规范?

一句话结论

控制器准备数据并通过渲染参数传入视图,视图不反向取全局请求;模型/数据提供者作为参数传递,视图只做取值、格式化与渲染,业务判断留在控制器或服务层。

概念解释

规范数据流:请求 → 控制器/服务 → 模型/提供者 → 视图参数 → 模板。视图内不直接调用 Yii::$app->request 查参数,不执行写库操作。复杂派生数据在进入视图前计算完成。这样视图可复用、可测试,渲染逻辑与业务解耦。

原理流程

  1. 控制器调用服务获取模型与提供者。
  2. 组装渲染参数数组。
  3. 视图读取参数渲染。
  4. 小部件接收提供者与配置属性。

代码或图示

public function actionView($id)
{
    $model = Article::findOne($id);
    return $this->render('view', [
        'model' => $model,
        'related' => $this->service->relatedList($model),
    ]);
}

常见误区

  • 视图内直接 Yii::$app->user 之外的服务查询:视图层混入业务与依赖。
  • 大对象整体传入视图:只传需要的字段与集合,降低耦合。

追问

  • 视图需要当前用户信息怎么办?答:控制器传入必要标识与展示数据;视图直接读身份组件属于轻量例外,复杂判断应上移。
  • 派生标签在模型还是视图算?答:纯展示标签可在模型提供访问器;业务规则计算在服务层。

06.5.3.14-019 常见视图安全问题有哪些?

一句话结论

视图安全集中在输出编码、资源可信来源、表单令牌与上传展示;用户内容按上下文编码,富文本走消毒白名单,外部脚本样式只引用可信资源,表单不遗漏 CSRF 令牌。

概念解释

默认格式化与 Html 助手做编码;raw 场景需自行确认可信。资源文件来自发布目录与可信 CDN,不内联用户上传的脚本。图片/PDF 展示注意内容类型与下载策略。视图不暴露内部路径、密钥与调试信息。

原理流程

  1. 输出点按 HTML/属性/JS/URL 上下文编码。
  2. 富文本经消毒白名单处理。
  3. 外部资源限定可信来源。
  4. 表单携带令牌,上传文件按校验规则处理(见 06.5.3.10-014)。

代码或图示

// 安全输出:助手编码
echo Html::encode($model->bio);

// 危险示例(禁止):未编码输出用户内容
// echo $model->bio;

常见误区

  • 后台页面不设防:后台 XSS 同样可窃取会话,输出编码不能省略。
  • 上传文件直接以脚本类型内联展示:按内容类型隔离,禁止上传目录执行脚本。

追问

  • 视图如何防止点击劫持类问题?答:响应头由响应/部署层配置,不属于视图模板职责。
  • 错误页面泄露什么?答:生产关闭详细堆栈,错误视图不显示路径与源码片段(参见错误处理相关章节)。

06.5.3.14-020 小部件视图章节有哪些高频踩坑与检查清单?

一句话结论

高频问题集中在:小部件查库、视图内 N+1、资源绕过包管理、主题半覆盖、输出未编码、路径硬编码;交付前按“数据视图分离、小部件无业务、资源分组、主题齐备、编码到位、路径别名化”逐项检查。

概念解释

检查清单覆盖:小部件生命周期与职责边界、GridView/ActiveForm/ListView 配置、渲染方式与视图路径、布局与块、主题映射与资源发布、资源注册顺序、格式化器使用、Html 编码、小部件复用组织、3.0 接口对照。涉及 API 细节标注待确认并在目标环境验证。

原理流程

  1. 审计视图调用链:数据是否由控制器/服务准备。
  2. 检查小部件与列配置,确认无循环查询。
  3. 核对资源包依赖、发布路径与注册位置。
  4. 验证主题覆盖完整、回退正常。
  5. 扫描输出编码与视图内全局请求/写库调用。

代码或图示

视图自检
[ ] 视图不直接查库/写库,数据由上层传入
[ ] 小部件只渲染,业务查询在服务层
[ ] 关联数据已预加载,视图循环无 N+1
[ ] 资源走 AssetBundle,依赖顺序正确
[ ] 主题文件齐备,未覆盖项回退默认
[ ] 用户输出按上下文编码,raw 已确认可信
[ ] 视图路径使用别名/约定解析,无硬编码层级
[ ] 表单携带 CSRF 令牌
[ ] 格式化统一走 Formatter 组件

常见误区

  • 视图层为了快直接查库:短期省事,后期 N+1 与复用问题集中爆发。
  • 自定义小部件复制粘贴演化:缺少公共抽象,配置不一致。

追问

  • 如何评审视图质量?答:检查数据流方向、查询位置、资源分组与编码覆盖;用页面渲染期查询计数验证无 N+1。
  • 视图层哪些内容最该抽复用?答:状态标签、列表列、详情属性、空态片段与高频表单字段;抽取前确认配置可参数化。