06.5.3.10 验证规则与安全防护
所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.3 Yii
06.5.3.10-001 验证器在 Yii 中处于什么执行时机?
一句话结论
验证在模型 validate() 被调用时触发:批量赋值之后、数据持久化或业务处理之前;控制器通过 load() 接收入参后显式调用 validate(),AR 在 save() 内部也会先执行验证,校验失败则中断后续流程。
概念解释
验证器按规则数组逐条作用于属性,把错误写入模型的 errors 集合。验证是服务端强制防线,前端校验只改善体验,不能作为安全边界。模型可以是继承 yii\base\Model 的表单模型,也可以是 ActiveRecord;AR 的规则场景与批量赋值边界已在 06.5.3.7 展开,本页聚焦验证器本身与安全防护。
原理流程
- 控制器
load()把请求参数批量赋给模型。 - 调用
validate()(ARsave()内部自动调用)。 - 框架按
rules()顺序匹配当前场景下的验证器执行。 - 任一属性产生错误即记入 errors;全部通过才允许继续。
代码或图示
$model = new ExampleForm();
if ($model->load(Yii::$app->request->post()) && $model->validate()) {
// 校验通过后再进入业务流程
}
常见误区
- 只依赖前端表单提示:绕过页面直接发请求即可跳过前端校验,服务端必须重验。
- 在
load()之后直接save()而不检查结果:AR 保存失败可能只是校验未过,错误信息未被读取。
追问
- 何时手动调用
validate()?答:表单模型不入库时必须手动调用;AR 可由save()触发,但需要提前拿错误信息时手动调用。 - 验证顺序由什么决定?答:规则在
rules()数组中的声明顺序;同属性多规则按声明依次执行,是否短路由规则参数控制。
06.5.3.10-002 rules() 返回的规则数组结构是什么?
一句话结论
每条规则形如 [属性列表, 验证器类型, 场景与参数 => 选项]:前两项指定属性与验证器,后续键值配置消息、跳过条件、场景限定与验证器专属参数。
概念解释
属性可写单个字符串或数组;验证器类型可以是内置验证器名称、行内方法名或独立验证器类名。on/except 限定规则生效场景,message 覆盖默认错误文案,skipOnEmpty、skipOnError 控制跳过行为,when 写条件回调。规则只作用于当前场景允许批量赋值的属性。
原理流程
- 模型返回规则数组,每条规则声明属性与验证器。
- 验证时按场景过滤规则(
on命中或未被except排除)。 - 解析验证器类型并实例化/调用。
- 执行校验,失败则写入属性错误。
代码或图示
public function rules()
{
return [
[['title', 'email'], 'required'],
['email', 'email'],
['title', 'string', 'max' => 128],
['status', 'in', 'range' => [0, 1, 2]],
['bio', 'safe'],
];
}
常见误区
- 把业务校验写进控制器而模型无规则:同一模型被多个入口复用时校验不一致。
- 规则参数写错位置:验证器专属参数应作为规则数组的键值,而不是塞进验证器类型字符串。
追问
safe验证器做什么?答:标记属性可被当前场景批量赋值但不做格式校验,常用于只参与业务计算、不直接校验的字段。- 一条规则能否作用于多个属性?答:可以,第一项传属性数组,验证器对每个属性分别执行。
06.5.3.10-003 常用内置验证器覆盖哪些校验场景?
一句话结论
内置验证器覆盖必填、类型、格式、取值范围、比较、默认值、过滤、文件/图片、存在性与唯一性等场景;常用包括 required、string、integer、number、boolean、email、url、match、in、compare、default、filter、trim、safe、exist、unique、file、image、each、captcha。
概念解释
类型验证器约束数值与布尔;格式验证器校验邮箱、URL、正则;范围验证器用 range 限定枚举;比较验证器与另一属性比较;exist/unique 查数据库约束行存在或唯一;file/image 校验上传文件;each 对数组属性逐项套用子规则。完整清单与参数以当前版本文档为准。
原理流程
- 规则匹配内置验证器名称。
- 框架实例化对应验证器并填充参数。
- 验证器读取属性值执行内置逻辑。
- 不通过时生成默认或自定义错误消息。
代码或图示
return [
['age', 'integer', 'min' => 0, 'max' => 120],
['nickname', 'match', 'pattern' => '/^[A-Za-z0-9_]+$/'],
['category_id', 'exist', 'targetClass' => Category::class, 'targetAttribute' => 'id'],
['email', 'unique', 'targetClass' => User::class],
];
常见误区
- 用
integer验证器代替业务权限判断:格式合法不等于有权操作该记录。 - 忽略
exist的关联校验:只验证格式不验证归属,可能提交他人记录 ID。
追问
match的正则边界怎么写?答:正则需含起止锚点,避免子串匹配通过;错误消息中不要回显完整正则以防泄露内部规则。each适用于什么属性?答:数组型属性(如多选标签 ID),对子元素逐条套用指定规则。
06.5.3.10-004 规则参数 skipOnEmpty、skipOnError、when 如何控制执行?
一句话结论
skipOnEmpty 在属性为空时跳过规则,skipOnError 在前置规则已报错时跳过,when 用回调按上下文决定是否执行;组合这些参数可以构造条件校验链。
概念解释
skipOnEmpty 默认行为与属性空值定义按验证器实现为准,非必填字段配类型规则时常用;skipOnError 避免同一属性连续报多条无意义错误;when 接收模型与属性参数,返回 true 才执行规则,适合“某字段填写后另一字段才必填”的联动校验。
原理流程
- 规则执行前检查
when回调返回值。 - 检查属性是否为空、是否已有错误,按跳过参数短路。
- 条件满足才执行验证器主体。
- 失败消息写入 errors。
代码或图示
return [
['company_name', 'required', 'when' => function ($model) {
return $model->type === 'enterprise';
}],
['phone', 'string', 'min' => 6, 'skipOnEmpty' => true],
];
常见误区
- 必填字段配
skipOnEmpty仍依赖内置 required:应先有required规则拦截空值,类型规则再跳过空值避免重复报错。 - 把
when写成请求上下文判断:验证器应只依赖模型状态,控制器负责准备上下文。
追问
- 客户端条件校验如何对应?答:
whenClient写 JavaScript 回调做前端联动,服务端when仍必须保留,前后端各写一份。 on/except与when区别?答:前者按场景名过滤规则,后者按模型运行时状态判断,可叠加使用。
06.5.3.10-005 如何编写自定义验证器?
一句话结论
两种方式:在模型中定义 validateXxx($attribute, $params) 行内方法,或继承 yii\validators\Validator 实现独立类;行内方法在规则中用方法名引用,独立类在规则中写类名并传参数。
概念解释
行内验证器访问模型 $this 方便,但只能在当前模型复用;独立验证器可跨模型、跨模块复用,适合通用规则(如统一社会信用代码、手机号段规则)。自定义验证器不通过时调用 addError() 写入消息,校验通过不写错误。
原理流程
- 行内:规则第二项写方法名,框架调用
$this->validateXxx($attr, $params)。 - 独立类:继承 Validator,实现
validateAttribute($model, $attribute)。 - 校验失败调用
$model->addError()或基类addError()。 - 验证器参数通过规则数组传入类属性。
代码或图示
class PhoneValidator extends \yii\validators\Validator
{
public function validateAttribute($model, $attribute)
{
if (!preg_match('/^1[3-9]\d{9}$/', (string)$model->$attribute)) {
$model->addError($attribute, '手机号格式不正确');
}
}
}
// 规则中引用
['phone', PhoneValidator::class],
常见误区
- 自定义验证器里直接写死错误消息不读参数:无法复用默认消息配置与
message覆盖。 - 验证器内执行数据库副作用:验证职责是校验,写库应放到服务层事务中。
追问
- 独立验证器如何支持数组属性?答:重写
validateValue()基类方法可返回校验结果,配合each逐项调用;具体基类方法签名以当前版本文档为准,待确认。 - 行内方法能否被其他模型复用?答:不能直接复用;可抽到基类模型或独立验证器类。
06.5.3.10-006 批量赋值的安全边界如何由属性白名单控制?
一句话结论
load() 只把请求参数赋给当前场景 attributes() 允许的属性;白名单之外的字段即使出现在请求中也不会被赋值,避免攻击者提交隐藏字段覆盖敏感属性。
概念解释
属性白名单由 scenarios() 按场景声明,规则中的 safe 也会把对应属性纳入安全属性集合。AR 层面的场景与批量赋值已在 06.5.3.7-003、06.5.3.7-004 展开;安全要点是:身份、角色、余额、状态机内部字段等敏感属性不得进入可批量赋值集合,应在服务层单独赋值。
原理流程
load()读取请求参数键名。- 与当前场景安全属性集合求交集。
- 仅交集中的属性被赋值。
- 未在白名单的参数被忽略。
代码或图示
// 场景中只开放表单填写字段
public function scenarios()
{
return [
'register' => ['nickname', 'email', 'password'],
];
}
// role、balance、is_admin 不出现于任何场景白名单
常见误区
- 把
safe当作“安全无需校验”:它只表示可批量赋值,格式仍需其他规则覆盖。 - 依赖表单不显示某字段:抓包可补任意字段,后端白名单才是防线。
追问
- 敏感字段如何赋值?答:服务层在授权后用显式
$model->role = ...写入,不经过load()白名单。 - 批量赋值失败如何排查?答:检查场景名、规则中的
safe标注与属性名大小写,确认请求参数与模型属性对应。
06.5.3.10-007 表单模型(Model)与 ActiveRecord 在验证职责上如何分工?
一句话结论
yii\base\Model 承载不入库的表单输入与校验,AR 在此基础上映射表并在保存前复用同一套规则;跨写多个模型的业务、DTO 入参应使用表单模型,避免把复杂表单硬塞进单个 AR。
概念解释
表单模型只持有输入、校验与业务转调,不接数据库;AR 负责持久化与关联。一个页面涉及多张表或聚合校验时,用表单模型收集输入、内部协调多个 AR 与服务,比给单个 AR 堆场景和规则更清晰。3.0 趋势同样是把校验与领域对象、持久化分离。
原理流程
- 定义表单模型继承 Model,声明规则与标签。
- 控制器
load()+validate()校验输入。 - 校验通过后表单模型调用服务层,服务层操作 AR 或领域对象。
- AR 自身规则兜底持久化前校验。
代码或图示
class OrderCheckoutForm extends \yii\base\Model
{
public $address_id;
public $coupon;
public function rules()
{
return [['address_id', 'required'], ['coupon', 'string']];
}
}
常见误区
- 复杂聚合表单全部挂在主 AR 上:场景膨胀、规则互相干扰,难以复用。
- 表单模型直接写库:绕过服务层事务与授权,职责越界。
追问
- 表单模型需要关联数据库校验吗?答:需要时可在自定义验证器中查询,但只读校验;写入动作留在服务层。
- 3.0 中校验组件如何定位?答:3.0 有独立验证类包,规则以对象或数组方式定义;具体命名空间与 API 以安装包文档为准,待确认。
06.5.3.10-008 错误消息如何读取与展示?
一句话结论
模型提供 getErrors()、getFirstError()、hasErrors() 读取属性错误;视图用 ActiveForm::error() 逐字段渲染,errorSummary() 汇总全部错误;API 场景把错误数组序列化返回。
概念解释
错误按属性键组织,消息可通过规则 message 覆盖。属性标签来自 attributeLabels(),保证错误提示中的字段名可读。服务端校验失败时 HTTP 状态与业务码应区分:表单回显用 200 加错误,API 通常返回 422/400 与错误结构。
原理流程
- 验证器把失败消息写入模型 errors。
- 控制器判断
hasErrors()决定是否继续。 - 视图字段级错误由 ActiveForm 绑定属性输出。
- 汇总错误走
errorSummary()或 API 错误结构。
代码或图示
if (!$model->validate()) {
return $this->asJson([
'ok' => false,
'errors' => $model->getErrors(),
]);
}
常见误区
- 错误消息直接回显用户输入:配合转义避免 XSS;视图输出未转义内容时风险更高。
- 只取第一个错误忽略其余:用户需一次性看到全部问题,除非交互设计明确要求逐条提示。
追问
- 如何自定义字段名?答:在
attributeLabels()返回中文/业务标签,错误消息引用标签而非属性键。 - 跨模型聚合错误怎么展示?答:外层表单模型持有子模型引用,校验后把子模型错误合并到汇总列表。
06.5.3.10-009 XSS 防护在 Yii 中有哪些落点?
一句话结论
输出层默认转义:视图中 Html::encode() 与小部件自动转义用户内容;富文本输入用 HTML Purifier 类过滤器消毒;任何回显到 HTML 的用户内容都不得绕过转义直接拼接。
概念解释
XSS 分存储型、反射型与 DOM 型。服务端防护:保存前对富文本消毒(移除脚本事件属性与危险标签),输出时按上下文转义(HTML、属性、JS、URL 各有转义方式)。纯文本字段不允许保存 HTML;富文本白名单标签需按业务配置,不能放过 script、on* 事件与 javascript: 协议。
原理流程
- 输入阶段:富文本规则挂
filter或 Purifier 消毒配置。 - 输出阶段:视图助手按上下文编码用户内容。
- URL 类输出校验协议白名单。
- CSP 作为浏览器侧纵深防御(部署配置,非框架内置)。
代码或图示
// 视图中转义输出(示意)
use yii\helpers\Html;
echo Html::encode($model->nickname);
// 富文本消毒:具体过滤类与配置项以当前安装的 Purifier 扩展为准,待确认
['content', 'filter', 'filter' => \yii\helpers\HtmlPurifier::class],
常见误区
- 只在入库时过滤一次:输出上下文不同仍可能注入;转义必须发生在输出点。
- 为富文本放开全部标签:白名单只保留业务需要的标签与样式属性。
追问
- 视图里
<?=与Html::encode()关系?答:模板表达式输出应配合编码助手;小部件列默认对值做转义,关闭转义需显式配置并确认内容可信。 - 富文本图片/链接如何防注入?答:协议与域名白名单校验,
href/src只允许 http/https 与相对路径,禁止javascript:。
06.5.3.10-010 SQL 注入在 Yii 中如何被防护?
一句话结论
查询构造器与 ActiveRecord 使用参数绑定,用户输入作为参数值传入而不是拼进 SQL 字符串;禁止把请求参数直接拼接进原生 SQL,表名/列名等不可绑定部分需经白名单校验。
概念解释
参数绑定把值与语句分离,数据库驱动先编译语句再绑定值,值不会被解释为 SQL 语法。排序字段、表名、列名不能用占位符绑定,这类片段必须对照代码内白名单后再拼接。QueryBuilder 的条件数组、andWhere 参数形式均走绑定(参见 06.5.3.8-004、06.5.3.8-020)。
原理流程
- 接收用户输入,类型收敛后传入查询参数。
- Query 生成带占位符的语句。
- 驱动绑定参数值执行。
- 动态标识符先过白名单再进入语句。
代码或图示
// 安全:值走参数绑定
$query = (new \yii\db\Query())
->from('{{%article}}')
->where(['status' => $status])
->andWhere(['like', 'title', $keyword]);
// 危险写法示例(禁止)
// $sql = "SELECT * FROM article WHERE title = '{$_GET['q']}'";
常见误区
- 把
LIKE通配符拼接进参数:参数值安全,但%、_未转义会扩大匹配范围,需在业务层处理。 - 排序字段直接取请求参数:字段名不可绑定,必须白名单映射。
追问
- 原生
createCommand如何绑定?答:使用bindValue/bindParam传参数,不要把值内插进 SQL 字符串;具体方法签名以 db 组件文档为准。 - 存储过程参数怎么防注入?答:同样走绑定参数;过程名与标识符走白名单。
06.5.3.10-011 CSRF 防护机制在表单与 API 中如何落地?
一句话结论
Web 表单通过 CSRF 令牌随请求提交,框架组件校验会话中的令牌;令牌由请求组件生成并与会话绑定,豁免仅用于明确无状态的 API 或安全回调场景。
概念解释
CSRF 利用浏览器自动携带会话凭证的特性,令牌校验确认请求来自本站页面。表单视图由 ActiveForm 自动输出隐藏令牌字段;AJAX 请求从 meta 标签或请求头读取令牌发送。会话与令牌机制已在 06.5.3.6-008、06.5.3.6-009 展开,这里聚焦落地边界:API 若用独立令牌(Header 鉴权、无 Cookie 会话)可豁免 CSRF,但需确认会话凭证不参与请求。
原理流程
- 页面渲染时生成令牌存入会话并写入表单/meta。
- 提交时令牌随字段或请求头发送。
- 请求组件比对会话令牌与提交值。
- 不匹配拒绝处理;豁免场景在配置中显式声明。
代码或图示
// 视图中令牌 meta(示意,具体助手方法以当前版本为准)
use yii\helpers\Html;
echo Html::csrfMetaTags();
常见误区
- 以“接口返回 JSON”为由全站关闭 CSRF:只要依赖 Cookie 会话就必须保留令牌校验。
- 把令牌写进 URL 查询参数:可能被日志与 Referer 泄露,表单字段或 Header 更合适。
追问
- 令牌过期或换号怎么办?答:会话重建后令牌随之更新,页面需重新加载获取;多标签场景的令牌同步行为以框架实现为准,待确认。
- 同源 POST 还需要令牌吗?答:CSRF 防护针对跨站伪造请求,同源表单同样走统一校验,不按来源区分开关。
06.5.3.10-012 密码哈希应使用什么 API?加盐与成本因子如何考虑?
一句话结论
使用框架安全组件提供的密码哈希方法(如 generatePasswordHash/validatePassword,底层对应 password_hash/password_verify 等价能力),禁止 MD5、SHA1 等无盐快速哈希;成本因子在安全与性能间平衡,随硬件升级调整。
概念解释
密码哈希自带随机盐与算法标识,存储结果中已含盐与成本信息,验证时无需单独存盐。成本因子越高单次哈希越慢,抗暴力破解越强,登录与注册 CPU 开销也越大;应按服务器性能实测选择可接受的基线值。用户密码明文不入库、不记日志、不回显。
原理流程
- 注册时调用哈希方法生成存储串。
- 数据库只保存哈希串。
- 登录时取用户记录,用验证方法比对提交密码与存储串。
- 验证方法兼容历史算法标识,便于未来升级成本因子。
代码或图示
// 示意:方法名与默认参数以当前安全组件文档为准,待确认
$hash = Yii::$app->security->generatePasswordHash($plainPassword);
// 校验
if (Yii::$app->security->validatePassword($plainPassword, $model->password_hash)) {
// 身份通过
}
常见误区
- 自己拼接盐再哈希:重复造轮子,弱盐方案易被彩虹表破解。
- 存储可逆加密后的密码:可解密等于明文保管,密码应单向哈希。
- 日志记录密码字段:调试输出与错误上报需排除敏感字段。
追问
- 哈希因子能否事后升级?答:可在登录验证成功后按新因子重新哈希并更新存储,不强制用户改密。
- 密码策略在哪里校验?答:长度、复杂度用验证器规则约束;哈希强度由安全组件算法与因子控制,两者职责不同。
06.5.3.10-013 安全组件还提供哪些随机数与常量比较能力?
一句话结论
安全组件提供加密随机串生成、字符串哈希(带密钥 HMAC 类)、二进制安全比较等方法;随机数用于令牌、验证码与重置凭证,常量比较防止时序侧信道泄露。
概念解释
随机源应使用密码学安全随机生成器,不适合用 rand()/uniqid() 拼接待效凭证。敏感令牌比较使用恒定时间比较方法(对应 hash_equals 类能力),避免按前缀失败差异泄露内容。数据加密/解密用于必须可逆保存的字段,密钥管理不在框架内解决。
原理流程
- 生成场景调用安全随机方法产出令牌。
- 令牌存数据库或会话,设置有效期与用途。
- 校验时用恒定时间比较方法比对。
- 可逆加密字段单独评估密钥存放与轮换。
代码或图示
// 示意:方法名以安全组件文档为准,待确认
$token = Yii::$app->security->generateRandomString(40);
$equals = Yii::$app->security->compareString($expected, $provided);
常见误区
- 用时间戳+用户 ID 生成重置令牌:可预测,被枚举风险高。
- 普通
==比较令牌:存在时序差异,应用恒定时间比较。
追问
- 随机串长度怎么定?答:按令牌用途评估熵值;会话重置令牌、密码重置链接令牌应足够长并带过期时间。
- 加密密钥放哪里?答:走环境变量或配置仓库注入,不写进代码库;本章不展开密钥管理体系。
06.5.3.10-014 文件上传如何做校验?
一句话结论
上传文件先经 UploadedFile 封装,模型用 file 验证器约束扩展名、MIME 类型、大小与数量;存储前重命名、隔离可执行目录,校验链覆盖格式与内容,不只看浏览器提交的扩展名。
概念解释
浏览器提交的扩展名与 MIME 不可信,验证器可检查实际 MIME 与文件内容(依赖对应扩展,具体能力以版本为准)。允许扩展名按业务白名单;上传目录不执行脚本,文件名由服务端生成,避免路径穿越与恶意文件名。图片另用 image 验证器约束宽高与类型。
原理流程
- 表单
fileInput提交文件,控制器取UploadedFile::getInstance()。 - 模型
file规则校验扩展名、MIME、大小、数量。 - 校验通过后生成安全文件名并保存到上传目录。
- 数据库记录相对路径或对象标识,不存可执行路径。
代码或图示
return [
['attachment', 'file', 'extensions' => ['pdf', 'png', 'jpg'],
'maxSize' => 2 * 1024 * 1024, 'mimeTypes' => ['application/pdf', 'image/png', 'image/jpeg']],
];
// 保存(示意)
$file->saveAs(Yii::getAlias('@webroot/uploads/') . $safeName);
常见误区
- 只校验扩展名:改后缀的可执行文件绕过,需 MIME/内容校验配合。
- 保留原始文件名落盘:文件名含路径字符或可执行后缀,存在穿越与解析风险。
- 上传目录与代码目录混放:禁止在上传目录执行脚本。
追问
- 多文件上传怎么校验数量?答:
file规则的maxFiles参数约束数量;控制器取UploadedFile::getInstances()数组。 - 大文件上传如何处理?答:校验大小与超时限制,配合分片或对象存储;不要在 PHP 请求内一次性读入内存。
06.5.3.10-015 图片验证器补充哪些约束?
一句话结论
image 验证器在文件校验基础上检查图片类型、宽高、比例与是否可被图片解析库读取;上传头像、封面等场景应同时约束最小/最大尺寸,避免超大图与伪装文件。
概念解释
图片校验依赖图像处理扩展(如 GD/Imagick,可用能力以环境为准,待确认)。约束包括 minWidth、maxWidth、minHeight、maxHeight、width、height、ratio 与扩展名/ MIME。伪装成图片的脚本文件在解析阶段即被拒绝。
原理流程
- 文件通过基础
file校验后进入image规则。 - 图片库读取尺寸与格式。
- 对照宽高与类型约束。
- 失败写入属性错误。
代码或图示
['avatar', 'image', 'extensions' => ['jpg', 'png', 'webp'],
'minWidth' => 200, 'maxWidth' => 1000,
'minHeight' => 200, 'maxHeight' => 1000],
常见误区
- 只校验扩展名不解析图片:畸形文件无法被识别。
- 放开尺寸上限:超大图占用存储与后续缩略图处理资源。
追问
- 上传后是否需要生成缩略图?答:按业务在保存后异步生成多尺寸副本,原图保留或按策略清理;生成过程不在验证器内完成。
- 图片 EXIF 信息要处理吗?答:涉及隐私或旋转方向时在服务端规范化重写,不依赖浏览器元数据。
06.5.3.10-016 属性标签与错误文案如何组织?
一句话结论
attributeLabels() 提供属性可读名称,规则 message 覆盖单条错误文案;标签集中管理便于多语言与后台复用,错误消息避免暴露内部表名、正则与堆栈。
概念解释
标签用于表单字段标题、错误消息与列表表头。多语言场景通过翻译组件输出对应语言标签。错误文案面向用户说明问题,内部诊断信息走日志,不进响应消息。文案不回显敏感内部规则(如完整正则、数据库约束名)。
原理流程
- 模型声明标签映射。
- 验证器生成消息时替换属性标签占位。
- 视图与 API 错误结构使用最终文案。
- 内部错误细节记录到日志。
代码或图示
public function attributeLabels()
{
return [
'email' => '邮箱地址',
'phone' => '手机号',
];
}
public function rules()
{
return [['email', 'required', 'message' => '请填写{attribute}']];
}
常见误区
- 错误消息写死属性键名:用户看到
email而非业务名称。 - 把 SQL/异常原文抛给前端:泄露表结构与路径,应由错误处理器统一兜底。
追问
{attribute}占位如何替换?答:验证器消息中的占位符由框架用标签与属性值替换;其他可用占位符以验证器文档为准。- 多语言标签怎么做?答:标签返回翻译键,经翻译组件按当前语言输出;具体集成方式与当前项目配置一致。
06.5.3.10-017 客户端验证与服务端验证是什么关系?
一句话结论
客户端验证(浏览器 JS)用于即时反馈与减少请求,服务端验证是唯一安全边界;两者规则需保持一致,客户端可关闭或绕过,绝不能省略服务端规则。
概念解释
ActiveForm 可把部分内置验证器规则生成前端 JS 校验;自定义复杂规则往往只在服务端实现。前端开关关闭、抓包重放、脚本调用都可绕过浏览器校验。服务端规则覆盖全部安全约束,前端只是体验层。
原理流程
- 模型规则声明后,ActiveForm 生成对应前端校验脚本。
- 用户输入时浏览器先做即时校验。
- 提交后服务端重新执行完整规则。
- 服务端错误回显给页面或 API。
代码或图示
// 视图中 ActiveForm 开启客户端校验(示意,默认行为以当前版本为准)
$form = ActiveForm::begin(['enableClientValidation' => true]);
常见误区
- 为复杂自定义验证只写 JS:服务端无规则保护。
- 前端校验通过后跳过服务端判断:
validate()仍必须执行。
追问
- 前端规则与服务端不一致怎么办?答:以服务端规则为准修正前端;
whenClient与when需分别维护并在测试中对照。 - API 项目需要客户端验证吗?答:API 本身无表单页面,校验全部在服务端;前端 App/页面另做体验层校验。
06.5.3.10-018 录入内容如何做安全过滤与类型收敛?
一句话结论
输入先按预期类型收敛(整数、枚举、字符串),再用过滤规则去空白、换行与多余字符;类型收敛在进入业务逻辑前完成,避免字符串比较与隐式转换绕过规则。
概念解释
trim、filter 验证器做输入清理;数值型属性验证器同时完成类型约束。请求取值应通过 Request 组件按类型读取,不直接信任原始参数。富文本与普通文本分通道处理:纯文本不保留 HTML,富文本走消毒白名单。
原理流程
- 从 Request 读取参数并按业务类型声明。
- 规则先执行过滤类规则(trim/filter)。
- 再执行类型与格式规则。
- 清理后的值进入模型与业务层。
代码或图示
return [
[['nickname', 'bio'], 'trim'],
['age', 'integer', 'min' => 0],
['nickname', 'string', 'max' => 32],
];
常见误区
- 业务代码里到处
intval:应在模型规则层收敛,下游拿到类型明确的值。 - 过滤规则排在格式规则之后:未去空白的字符串先校验长度,结果不稳定。
追问
- 数组型输入怎么收敛?答:
each规则逐项校验;预期多选枚举时用in配合数组范围判断。 - 特殊字符需要转义保存吗?答:存储保持原始值,按输出上下文转义;过早转义保存会造成展示与检索困难。
06.5.3.10-019 3.0 验证组件与 2.x 规则写法有何对照?
一句话结论
3.0 校验能力独立成包,校验规则以可组合的验证器对象或配置数组表达,模型/领域对象通过校验入口调用;思想(属性规则、错误集合、自定义校验)延续,但类命名空间、规则定义形式与集成方式不同,具体 API 以安装包文档为准。
概念解释
2.x 规则写在模型 rules() 方法返回数组;3.0 包化后校验器可独立于模型装配,服务层或领域对象可直接调用。迁移 2.x 代码时,规则条目需要对照新包的验证器清单与参数名重写,不能假设同名同参。不确定的签名标注待确认,并在最小示例中实测。
原理流程
- 确认项目实际 3.0 包版本与文档。
- 梳理 2.x 规则用到的内置验证器与自定义类。
- 按新包映射规则定义方式与参数。
- 补充服务端校验测试用例回归。
代码或图示
2.x:模型 rules() 数组 + 框架核心验证器
3.0:独立校验包 + 显式装配的验证器(具体写法待确认)
常见误区
- 把 2.x
rules()数组原样搬进 3.0:参数名与验证器类可能已调整。 - 迁移时只移内置规则忽略自定义验证器:跨包复用需改继承与调用方式。
追问
- 哪些校验思路两代通用?答:服务端强制校验、白名单批量赋值、敏感字段显式赋值、文件内容校验、错误与日志分离。
- 如何核实 3.0 验证器清单?答:查看已安装包的验证器类列表与 README;本机未装 vendor 时不写实测结论。
06.5.3.10-020 安全防护章节有哪些高频踩坑与检查清单?
一句话结论
高频风险集中在:只做前端校验、批量赋值白名单过宽、上传只看扩展名、密码用弱哈希、输出未转义、原生 SQL 拼接;交付前按“服务端规则齐全、敏感字段不白名单、上传内容校验、哈希合规、输出转义、参数绑定”逐项核对。
概念解释
检查清单覆盖:必填与类型规则、场景白名单、自定义验证器复用、XSS 输出转义与富文本消毒、SQL 参数绑定、CSRF 令牌、密码哈希与随机令牌、上传文件内容校验、错误消息不泄露内部信息。涉及环境扩展能力(图像库、Purifier 扩展)标注待确认并在目标环境验证。
原理流程
- 逐模型核对规则覆盖所有入库/入参字段。
- 检查场景白名单排除敏感属性。
- 审计查询与原生 SQL 是否全部参数绑定。
- 检查上传链路:MIME/内容、文件名、目录隔离。
- 核对哈希、令牌、比较方法与输出编码。
代码或图示
安全自检
[ ] 服务端 validate() 覆盖全部入口
[ ] 角色/余额/状态字段不在批量赋值白名单
[ ] 查询全部参数绑定,动态标识符走白名单
[ ] 上传校验扩展名 + MIME/内容 + 大小 + 重命名
[ ] 密码使用强哈希,无弱哈希与明文日志
[ ] 输出按上下文转义,富文本白名单消毒
[ ] CSRF 令牌覆盖 Cookie 会话请求
[ ] 错误响应不携带堆栈与内部路径
常见误区
- 认为“框架自带防护就不用审”:默认配置之外的自定义查询、上传与输出路径仍需逐项检查。
- 把安全问题留到上线前:校验规则应随表单与接口一起开发并补充测试用例。
追问
- 安全校验用什么测试覆盖?答:为必填、类型、边界、唯一/存在约束编写服务端测试用例;上传与 XSS 用恶意样本回归。
- 发现历史模型白名单过宽怎么办?答:先收敛场景字段,敏感字段改为服务层显式赋值;不改既有业务接口行为前先确认影响范围。