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

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 展开,本页聚焦验证器本身与安全防护。

原理流程

  1. 控制器 load() 把请求参数批量赋给模型。
  2. 调用 validate()(AR save() 内部自动调用)。
  3. 框架按 rules() 顺序匹配当前场景下的验证器执行。
  4. 任一属性产生错误即记入 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 写条件回调。规则只作用于当前场景允许批量赋值的属性。

原理流程

  1. 模型返回规则数组,每条规则声明属性与验证器。
  2. 验证时按场景过滤规则(on 命中或未被 except 排除)。
  3. 解析验证器类型并实例化/调用。
  4. 执行校验,失败则写入属性错误。

代码或图示

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 对数组属性逐项套用子规则。完整清单与参数以当前版本文档为准。

原理流程

  1. 规则匹配内置验证器名称。
  2. 框架实例化对应验证器并填充参数。
  3. 验证器读取属性值执行内置逻辑。
  4. 不通过时生成默认或自定义错误消息。

代码或图示

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 才执行规则,适合“某字段填写后另一字段才必填”的联动校验。

原理流程

  1. 规则执行前检查 when 回调返回值。
  2. 检查属性是否为空、是否已有错误,按跳过参数短路。
  3. 条件满足才执行验证器主体。
  4. 失败消息写入 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() 写入消息,校验通过不写错误。

原理流程

  1. 行内:规则第二项写方法名,框架调用 $this->validateXxx($attr, $params)。
  2. 独立类:继承 Validator,实现 validateAttribute($model, $attribute)。
  3. 校验失败调用 $model->addError() 或基类 addError()。
  4. 验证器参数通过规则数组传入类属性。

代码或图示

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 展开;安全要点是:身份、角色、余额、状态机内部字段等敏感属性不得进入可批量赋值集合,应在服务层单独赋值。

原理流程

  1. load() 读取请求参数键名。
  2. 与当前场景安全属性集合求交集。
  3. 仅交集中的属性被赋值。
  4. 未在白名单的参数被忽略。

代码或图示

// 场景中只开放表单填写字段
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 趋势同样是把校验与领域对象、持久化分离。

原理流程

  1. 定义表单模型继承 Model,声明规则与标签。
  2. 控制器 load() + validate() 校验输入。
  3. 校验通过后表单模型调用服务层,服务层操作 AR 或领域对象。
  4. 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 与错误结构。

原理流程

  1. 验证器把失败消息写入模型 errors。
  2. 控制器判断 hasErrors() 决定是否继续。
  3. 视图字段级错误由 ActiveForm 绑定属性输出。
  4. 汇总错误走 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: 协议。

原理流程

  1. 输入阶段:富文本规则挂 filter 或 Purifier 消毒配置。
  2. 输出阶段:视图助手按上下文编码用户内容。
  3. URL 类输出校验协议白名单。
  4. 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)。

原理流程

  1. 接收用户输入,类型收敛后传入查询参数。
  2. Query 生成带占位符的语句。
  3. 驱动绑定参数值执行。
  4. 动态标识符先过白名单再进入语句。

代码或图示

// 安全:值走参数绑定
$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,但需确认会话凭证不参与请求。

原理流程

  1. 页面渲染时生成令牌存入会话并写入表单/meta。
  2. 提交时令牌随字段或请求头发送。
  3. 请求组件比对会话令牌与提交值。
  4. 不匹配拒绝处理;豁免场景在配置中显式声明。

代码或图示

// 视图中令牌 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 开销也越大;应按服务器性能实测选择可接受的基线值。用户密码明文不入库、不记日志、不回显。

原理流程

  1. 注册时调用哈希方法生成存储串。
  2. 数据库只保存哈希串。
  3. 登录时取用户记录,用验证方法比对提交密码与存储串。
  4. 验证方法兼容历史算法标识,便于未来升级成本因子。

代码或图示

// 示意:方法名与默认参数以当前安全组件文档为准,待确认
$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 类能力),避免按前缀失败差异泄露内容。数据加密/解密用于必须可逆保存的字段,密钥管理不在框架内解决。

原理流程

  1. 生成场景调用安全随机方法产出令牌。
  2. 令牌存数据库或会话,设置有效期与用途。
  3. 校验时用恒定时间比较方法比对。
  4. 可逆加密字段单独评估密钥存放与轮换。

代码或图示

// 示意:方法名以安全组件文档为准,待确认
$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 验证器约束宽高与类型。

原理流程

  1. 表单 fileInput 提交文件,控制器取 UploadedFile::getInstance()。
  2. 模型 file 规则校验扩展名、MIME、大小、数量。
  3. 校验通过后生成安全文件名并保存到上传目录。
  4. 数据库记录相对路径或对象标识,不存可执行路径。

代码或图示

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。伪装成图片的脚本文件在解析阶段即被拒绝。

原理流程

  1. 文件通过基础 file 校验后进入 image 规则。
  2. 图片库读取尺寸与格式。
  3. 对照宽高与类型约束。
  4. 失败写入属性错误。

代码或图示

['avatar', 'image', 'extensions' => ['jpg', 'png', 'webp'],
    'minWidth' => 200, 'maxWidth' => 1000,
    'minHeight' => 200, 'maxHeight' => 1000],

常见误区

  • 只校验扩展名不解析图片:畸形文件无法被识别。
  • 放开尺寸上限:超大图占用存储与后续缩略图处理资源。

追问

  • 上传后是否需要生成缩略图?答:按业务在保存后异步生成多尺寸副本,原图保留或按策略清理;生成过程不在验证器内完成。
  • 图片 EXIF 信息要处理吗?答:涉及隐私或旋转方向时在服务端规范化重写,不依赖浏览器元数据。

06.5.3.10-016 属性标签与错误文案如何组织?

一句话结论

attributeLabels() 提供属性可读名称,规则 message 覆盖单条错误文案;标签集中管理便于多语言与后台复用,错误消息避免暴露内部表名、正则与堆栈。

概念解释

标签用于表单字段标题、错误消息与列表表头。多语言场景通过翻译组件输出对应语言标签。错误文案面向用户说明问题,内部诊断信息走日志,不进响应消息。文案不回显敏感内部规则(如完整正则、数据库约束名)。

原理流程

  1. 模型声明标签映射。
  2. 验证器生成消息时替换属性标签占位。
  3. 视图与 API 错误结构使用最终文案。
  4. 内部错误细节记录到日志。

代码或图示

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 校验;自定义复杂规则往往只在服务端实现。前端开关关闭、抓包重放、脚本调用都可绕过浏览器校验。服务端规则覆盖全部安全约束,前端只是体验层。

原理流程

  1. 模型规则声明后,ActiveForm 生成对应前端校验脚本。
  2. 用户输入时浏览器先做即时校验。
  3. 提交后服务端重新执行完整规则。
  4. 服务端错误回显给页面或 API。

代码或图示

// 视图中 ActiveForm 开启客户端校验(示意,默认行为以当前版本为准)
$form = ActiveForm::begin(['enableClientValidation' => true]);

常见误区

  • 为复杂自定义验证只写 JS:服务端无规则保护。
  • 前端校验通过后跳过服务端判断:validate() 仍必须执行。

追问

  • 前端规则与服务端不一致怎么办?答:以服务端规则为准修正前端;whenClient 与 when 需分别维护并在测试中对照。
  • API 项目需要客户端验证吗?答:API 本身无表单页面,校验全部在服务端;前端 App/页面另做体验层校验。

06.5.3.10-018 录入内容如何做安全过滤与类型收敛?

一句话结论

输入先按预期类型收敛(整数、枚举、字符串),再用过滤规则去空白、换行与多余字符;类型收敛在进入业务逻辑前完成,避免字符串比较与隐式转换绕过规则。

概念解释

trim、filter 验证器做输入清理;数值型属性验证器同时完成类型约束。请求取值应通过 Request 组件按类型读取,不直接信任原始参数。富文本与普通文本分通道处理:纯文本不保留 HTML,富文本走消毒白名单。

原理流程

  1. 从 Request 读取参数并按业务类型声明。
  2. 规则先执行过滤类规则(trim/filter)。
  3. 再执行类型与格式规则。
  4. 清理后的值进入模型与业务层。

代码或图示

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 代码时,规则条目需要对照新包的验证器清单与参数名重写,不能假设同名同参。不确定的签名标注待确认,并在最小示例中实测。

原理流程

  1. 确认项目实际 3.0 包版本与文档。
  2. 梳理 2.x 规则用到的内置验证器与自定义类。
  3. 按新包映射规则定义方式与参数。
  4. 补充服务端校验测试用例回归。

代码或图示

2.x:模型 rules() 数组 + 框架核心验证器
3.0:独立校验包 + 显式装配的验证器(具体写法待确认)

常见误区

  • 把 2.x rules() 数组原样搬进 3.0:参数名与验证器类可能已调整。
  • 迁移时只移内置规则忽略自定义验证器:跨包复用需改继承与调用方式。

追问

  • 哪些校验思路两代通用?答:服务端强制校验、白名单批量赋值、敏感字段显式赋值、文件内容校验、错误与日志分离。
  • 如何核实 3.0 验证器清单?答:查看已安装包的验证器类列表与 README;本机未装 vendor 时不写实测结论。

06.5.3.10-020 安全防护章节有哪些高频踩坑与检查清单?

一句话结论

高频风险集中在:只做前端校验、批量赋值白名单过宽、上传只看扩展名、密码用弱哈希、输出未转义、原生 SQL 拼接;交付前按“服务端规则齐全、敏感字段不白名单、上传内容校验、哈希合规、输出转义、参数绑定”逐项核对。

概念解释

检查清单覆盖:必填与类型规则、场景白名单、自定义验证器复用、XSS 输出转义与富文本消毒、SQL 参数绑定、CSRF 令牌、密码哈希与随机令牌、上传文件内容校验、错误消息不泄露内部信息。涉及环境扩展能力(图像库、Purifier 扩展)标注待确认并在目标环境验证。

原理流程

  1. 逐模型核对规则覆盖所有入库/入参字段。
  2. 检查场景白名单排除敏感属性。
  3. 审计查询与原生 SQL 是否全部参数绑定。
  4. 检查上传链路:MIME/内容、文件名、目录隔离。
  5. 核对哈希、令牌、比较方法与输出编码。

代码或图示

安全自检
[ ] 服务端 validate() 覆盖全部入口
[ ] 角色/余额/状态字段不在批量赋值白名单
[ ] 查询全部参数绑定,动态标识符走白名单
[ ] 上传校验扩展名 + MIME/内容 + 大小 + 重命名
[ ] 密码使用强哈希,无弱哈希与明文日志
[ ] 输出按上下文转义,富文本白名单消毒
[ ] CSRF 令牌覆盖 Cookie 会话请求
[ ] 错误响应不携带堆栈与内部路径

常见误区

  • 认为“框架自带防护就不用审”:默认配置之外的自定义查询、上传与输出路径仍需逐项检查。
  • 把安全问题留到上线前:校验规则应随表单与接口一起开发并补充测试用例。

追问

  • 安全校验用什么测试覆盖?答:为必填、类型、边界、唯一/存在约束编写服务端测试用例;上传与 XSS 用恶意样本回归。
  • 发现历史模型白名单过宽怎么办?答:先收敛场景字段,敏感字段改为服务层显式赋值;不改既有业务接口行为前先确认影响范围。