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() 渲染自包含片段。小部件不承担业务数据查询,数据由控制器/服务准备后传入。
原理流程
- 配置小部件属性。
begin()注册小部件实例并调用init()。- 包裹内容在视图中编写。
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 控制日期、数字、布尔等输出格式。数据提供者负责分页、排序与结果装配。
原理流程
- 控制器准备 ActiveDataProvider。
- 视图实例化 GridView,传入提供者与列配置。
- 小部件遍历当前页记录渲染各列。
- 分页/排序链接由数据提供者与 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 按配置生成。
原理流程
- 视图
ActiveForm::begin()输出<form>与隐藏令牌。 - 逐字段调用
field()渲染控件与错误占位。 end()闭合表单。- 提交后控制器加载模型并校验。
代码或图示
$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 声明字段与格式,输出定义列表样式的只读展示。两者都依赖格式化器处理值类型。
原理流程
- 控制器准备数据提供者或单条模型。
- 视图实例化对应小部件并配置视图/属性。
- 小部件遍历记录或属性渲染。
- 空数据按配置输出占位文本。
代码或图示
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)。
原理流程
- 控制器调用渲染方法并传视图名与参数。
- 视图组件按目录约定定位模板文件。
- 提取传入变量在模板作用域内使用。
render()再把内容嵌入布局输出。
代码或图示
// 控制器内
return $this->render('view', ['model' => $model]);
return $this->renderPartial('_summary', ['items' => $items]);
常见误区
- 视图里用
$_GET等全局超全局:数据应由控制器传入视图。 - 跨目录硬编码相对层级:视图移动后路径失效,优先用别名或共享视图路径。
追问
- 视图变量如何传入?答:渲染方法第二参数为关联数组,键名在模板中成为变量;未定义变量在模板中不可直接访问。
- 布局在哪里配置?答:控制器或应用
layout属性指定布局名;模块可覆盖自身布局。
06.5.3.14-006 布局与视图块替换如何工作?
一句话结论
布局是包裹页面内容的公共模板,通过内容占位输出当前视图;视图可定义命名块(block)向布局注入局部内容,实现公共骨架与页面专属片段的组合。
概念解释
应用/控制器配置布局文件,render() 把视图结果放入布局占位。视图中开启块记录内容,布局或父模板按块名取用。块机制支持嵌套与默认内容;页面专属脚本、侧栏片段通过块注入布局,而不是复制布局文件。
原理流程
- 配置布局路径与名称。
- 视图渲染过程中记录命名块内容。
- 布局输出主内容占位与各块位置。
- 块缺失时使用布局默认内容。
代码或图示
// 视图中定义块(示意,块 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 或资源包发布。多主题按应用配置或运行时条件切换。
原理流程
- 配置 view 组件主题的路径映射与资源 URL。
- 渲染请求解析默认视图路径。
- 按映射查找主题覆盖文件。
- 命中用主题文件,未命中回退默认。
代码或图示
'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 等基础依赖。
原理流程
- 定义资源包类列出资源文件与依赖。
- 视图或小部件注册资源包。
- 发布器把源码目录发布到 Web 目录。
- 布局按依赖顺序输出 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 映射。文件变更后按发布策略重新发布;生产环境可预发布静态资源,避免请求时复制。
原理流程
- 注册资源包触发发布检查。
- 发布器比对源码与发布目录。
- 复制或建立符号链接,记录 URL 前缀。
- 视图输出资源 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 就绪时机;重复注册同一文件由资源管理器去重。内联脚本应避免拼接未转义的用户内容。
原理流程
- 视图调用注册方法登记资源。
- 资源管理器按依赖与位置分组。
- 布局渲染对应位置输出标签。
- 浏览器按顺序加载执行。
代码或图示
$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 表示不编码,使用前确认内容可信。
原理流程
- 小部件列配置格式名。
- 格式化器读取原始值与配置。
- 按格式转换为展示字符串。
- 输出到页面(非 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 字段构造器配合使用,后者绑定模型错误。
原理流程
- 视图需要标签时调用 Html 助手方法。
- 方法编码值与属性,拼接合法 HTML。
- 属性数组转为标签属性字符串。
- 输出到页面。
代码或图示
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 下或按配置指定。跨项目复用的小部件包自带模板;项目定制小部件视图可被主题覆盖。命名空间与目录一致才能自动加载。
原理流程
- 小部件类按命名空间放对应目录。
render()解析小部件视图路径。- 加载模板并传入数据。
- 主题映射可覆盖小部件视图文件。
代码或图示
widgets/
CardWidget.php
views/card.php
常见误区
- 小部件视图路径写死绝对层级:目录移动后渲染失败,使用基类路径解析方法。
- 视图命名空间与文件目录不一致:自动加载找不到类。
追问
- 小部件能否复用应用共享视图?答:可以,渲染时引用共享视图路径或别名;避免小部件反向依赖控制器视图目录。
- 小部件视图默认布局吗?答:小部件
render渲染片段,不套应用布局;布局由页面渲染流程处理。
06.5.3.14-014 小部件配置如何复用与注入?
一句话结论
通用小部件可通过继承基类、容器配置默认参数或项目公共小部件类复用;重复出现的配置(列定义、选项)抽到公共类或配置数组,避免每个视图复制一份。
概念解释
项目内高频小部件可封装子类,固定数据格式与视图;容器/服务定位器可预定义小部件配置。复用方式与 DI 容器配置相关(见 06.5.3.2)。小部件仍保持无业务查询职责,数据由上层传入。
原理流程
- 识别跨视图重复的小部件配置。
- 抽取公共小部件类或配置工厂。
- 各视图调用公共组件并传差异化数据。
- 调整公共行为时集中修改。
代码或图示
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);资源发布配合构建产物合并压缩;关联数据在控制器/服务侧预加载。视图内循环不触发新查询;分页控制单次渲染记录数。脚本按页面拆分,避免全站加载大脚本。
原理流程
- 数据层预加载关联、准备分页。
- 视图按片段缓存包裹高成本区域。
- 资源按页面注册,合并压缩产物由发布流程处理。
- 渲染期只做模板取值与格式化。
代码或图示
视图优化路径
数据预加载 → 片段缓存 → 资源按需注册 → 精简层级 → 分页控制体量
常见误区
- 在视图循环里
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 包化后视图、小部件、资源为独立包,通过容器注入。模板片段、格式化、主题映射等概念延续,具体类名与配置键可能调整。迁移时先盘点自定义小部件与视图注册点,再按新包接口改造。
原理流程
- 确认 3.0 视图/资源包版本与接口。
- 梳理 2.x 小部件类、视图路径与资源包。
- 按新包继承关系与注册方式迁移。
- 回归页面渲染、资源加载与主题覆盖。
代码或图示
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 与发布路径对应新主题目录。主题不是模块,不承载业务路由。
原理流程
- 规划主题目录与共享基础模板。
- 配置路径映射与资源 URL。
- 渲染时按映射优先级查找。
- 未命中回退默认视图。
代码或图示
themes/
light/ 浅色主题覆盖视图与资源
dark/ 深色主题覆盖视图与资源
views/ 默认基础视图
常见误区
- 主题只覆盖部分文件:混合外观,需明确哪些差异必须覆盖。
- 主题间复制公共片段:公共部分应留在基础视图,主题只写差异。
追问
- 主题能按用户分组切换吗?答:可在运行时更换 view 组件主题配置;切换需保证资源可访问。
- 主题版本如何管理?答:资源路径带版本段,模板随代码库版本发布;旧缓存路径需清理。
06.5.3.14-018 视图与控制器之间的数据传递有哪些规范?
一句话结论
控制器准备数据并通过渲染参数传入视图,视图不反向取全局请求;模型/数据提供者作为参数传递,视图只做取值、格式化与渲染,业务判断留在控制器或服务层。
概念解释
规范数据流:请求 → 控制器/服务 → 模型/提供者 → 视图参数 → 模板。视图内不直接调用 Yii::$app->request 查参数,不执行写库操作。复杂派生数据在进入视图前计算完成。这样视图可复用、可测试,渲染逻辑与业务解耦。
原理流程
- 控制器调用服务获取模型与提供者。
- 组装渲染参数数组。
- 视图读取参数渲染。
- 小部件接收提供者与配置属性。
代码或图示
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 展示注意内容类型与下载策略。视图不暴露内部路径、密钥与调试信息。
原理流程
- 输出点按 HTML/属性/JS/URL 上下文编码。
- 富文本经消毒白名单处理。
- 外部资源限定可信来源。
- 表单携带令牌,上传文件按校验规则处理(见 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 细节标注待确认并在目标环境验证。
原理流程
- 审计视图调用链:数据是否由控制器/服务准备。
- 检查小部件与列配置,确认无循环查询。
- 核对资源包依赖、发布路径与注册位置。
- 验证主题覆盖完整、回退正常。
- 扫描输出编码与视图内全局请求/写库调用。
代码或图示
视图自检
[ ] 视图不直接查库/写库,数据由上层传入
[ ] 小部件只渲染,业务查询在服务层
[ ] 关联数据已预加载,视图循环无 N+1
[ ] 资源走 AssetBundle,依赖顺序正确
[ ] 主题文件齐备,未覆盖项回退默认
[ ] 用户输出按上下文编码,raw 已确认可信
[ ] 视图路径使用别名/约定解析,无硬编码层级
[ ] 表单携带 CSRF 令牌
[ ] 格式化统一走 Formatter 组件
常见误区
- 视图层为了快直接查库:短期省事,后期 N+1 与复用问题集中爆发。
- 自定义小部件复制粘贴演化:缺少公共抽象,配置不一致。
追问
- 如何评审视图质量?答:检查数据流方向、查询位置、资源分组与编码覆盖;用页面渲染期查询计数验证无 N+1。
- 视图层哪些内容最该抽复用?答:状态标签、列表列、详情属性、空态片段与高频表单字段;抽取前确认配置可参数化。