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

06.5.2.7 验证器与表单令牌

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

本节要解决的问题

  • 验证器类如何定义规则、场景、错误信息,批量验证与自定义规则怎么写?
  • 常用内置规则、唯一验证与上传文件校验如何使用?
  • 表单令牌如何防重复提交,令牌中间件与 token 规则如何配合?

版本前提:ThinkPHP 6.x / 8.0;验证组件为 think-validate,8.1.2 起独立为依赖,规则名与方法以当前版本手册为准。

06.5.2.7-001 验证器类如何定义,放在哪里?

一句话结论

验证器放在 app/validate 目录,继承 think\Validate,通过 $rule 定义规则、$message 定义错误信息、$scene 定义场景;控制器用 validate() 助手调用。

概念解释

验证器把校验规则从控制器抽成可复用类。规则按字段组织,错误信息按“字段.规则”键定制。

原理流程

  1. 新建验证器类继承 think\Validate。
  2. 声明 $rule、$message、$scene 属性。
  3. 控制器传入验证器类名执行 check()。
  4. 验证失败抛 ValidateException。

代码或图示

namespace app\validate;

use think\Validate;

class User extends Validate
{
    protected $rule = [
        'name'  => 'require|max:25',
        'age'   => 'number|between:1,120',
        'email' => 'email',
    ];

    protected $message = [
        'name.require' => '名称必须',
        'name.max'     => '名称最多 25 个字符',
    ];
}

常见误区

  • 规则写在控制器 if 分支:无法复用与沉淀。
  • 验证器类命名空间与目录不一致:自动加载失败。

追问

  • 不建验证器类能验证吗?答:可以用独立验证,Validate::rule([...]) 链式定义规则后 check()。
  • 验证组件需要单独安装吗?答:框架默认自动依赖 think-validate;第三方框架单独使用需 Composer 安装。

06.5.2.7-002 $rule 规则数组如何书写,分隔符是什么?

一句话结论

规则字符串用 | 分隔多条规则,规则参数用 : 传递(如 between:1,120);字段为键,规则串为值,也可用数组形式定义规则。

概念解释

每条规则对应一种校验能力,参数按规则含义解析。数组形式便于附加闭包规则或多规则组合。

原理流程

  1. 字段名作为数组键。
  2. 规则串按 | 拆分为规则列表。
  3. 每条规则按 : 拆规则名与参数。
  4. 验证器按顺序执行规则校验。

代码或图示

protected $rule = [
    'name'  => 'require|max:25',
    'age'   => 'number|between:1,120',
    'email' => ['require', 'email'],
];

常见误区

  • 规则参数逗号写成其他分隔符:参数解析错误。
  • 规则名大小写写错:规则严格区分大小写。

追问

  • 一条规则多个参数怎么传?答:规则名后 : 接逗号分隔参数,如 between:1,120。
  • 闭包规则与字符串规则能同字段混用吗?答:使用闭包规则后该字段不再支持多条字符串规则,以手册说明为准。

06.5.2.7-003 $message 错误信息如何定制?

一句话结论

错误信息数组以 字段.规则 为键、提示文案为值;只定制需要覆盖的条目,未覆盖使用系统默认信息;也可按字段整体定义。

概念解释

定制信息面向最终用户,避免暴露规则细节。多语言项目可按语言包替换文案。

原理流程

  1. 验证失败定位字段与规则。
  2. 查 $message 是否有对应键。
  3. 命中返回定制文案,否则取默认信息。
  4. 批量验证时错误按字段聚合。

代码或图示

protected $message = [
    'name.require' => '名称必须填写',
    'name.max'     => '名称不能超过 25 个字符',
    'age.between'  => '年龄只能在 1 到 120 之间',
    'email'        => '邮箱格式不正确',
];

常见误区

  • 键名写成 字段-规则 或规则名单独写:匹配不到定制信息。
  • 错误信息暴露内部表名/规则参数:面向用户应脱敏。

追问

  • 字段别名如何设置?答:可通过字段标题/别名定义让错误信息显示友好字段名,具体属性名以手册为准(待确认)。
  • 错误信息支持模板替换参数吗?答:部分规则信息可含参数占位,以对应规则文档为准。

06.5.2.7-004 check() 与 getError() 如何使用?

一句话结论

check($data) 执行验证,通过返回 true;失败可直接读取 getError() 取错误信息,或捕获 ValidateException 后用 $e->getError() 获取。

概念解释

验证器默认失败抛异常(按配置/调用方式);独立验证场景可判断返回值后取错误信息。错误信息可为字符串或数组。

原理流程

  1. 组装待验证数据数组。
  2. 调用 check($data) 触发规则校验。
  3. 失败:读取 getError() 或捕获异常。
  4. 通过后进入业务处理。

代码或图示

$validate = validate(\app\validate\User::class);
if (!$validate->check($data)) {
    dump($validate->getError());
}

try {
    validate(\app\validate\User::class)->check($data);
} catch (\think\exception\ValidateException $e) {
    dump($e->getError());
}

常见误区

  • 验证后不处理错误直接入库:非法数据进入持久层。
  • 把 getError() 当字符串强制拼接:批量验证时可能是数组。

追问

  • 异常类在哪个命名空间?答:think\exception\ValidateException,以当前版本命名空间为准。
  • check 返回值类型?答:通过为 true,失败抛异常或返回 false,行为受批量/异常配置影响,细节以版本源码为准。

06.5.2.7-005 validate() 助手与验证器类如何调用?

一句话结论

validate(验证器类名) 返回验证器实例,可链式接 scene()/batch() 后 check();也可直接传规则数组做独立验证。

概念解释

助手函数简化验证器实例获取,内部经容器解析。控制器中按场景链式配置后执行检查。

原理流程

  1. 调用 validate(User::class) 实例化验证器。
  2. 链式指定场景、批量等选项。
  3. check($data) 执行校验。
  4. 失败按异常/返回值处理。

代码或图示

validate(\app\validate\User::class)
    ->scene('edit')
    ->batch(true)
    ->check($request->param());

常见误区

  • 忘记调 check():只配置规则未执行校验。
  • 把请求对象直接传给 check():应传参数数组。

追问

  • validate() 不传参数怎样?答:返回验证器实例后用 rule() 方法定义规则,做独立验证。
  • 验证器实例可复用吗?答:每次调用建议按请求新建,避免上一次错误状态残留。

06.5.2.7-006 场景验证如何定义与调用?

一句话结论

$scene 数组声明场景对应字段列表,调用时 scene('edit') 指定场景;场景只验证列出的字段,不同用例复用同一验证器的不同规则子集。

概念解释

新增与编辑字段要求不同(如编辑不需要再次校验密码唯一),场景在同一验证器内区分数据子集。

原理流程

  1. $scene 定义场景名到字段数组的映射。
  2. 调用 scene('edit') 切换场景。
  3. 验证器只校验场景内字段。
  4. 场景方法可进一步增删规则。

代码或图示

protected $scene = [
    'edit' => ['name', 'age'],
];

validate(\app\validate\User::class)->scene('edit')->check($data);

常见误区

  • 场景字段列表与实际表单不一致:漏校验或多校验。
  • 以为场景会过滤多余数据:场景只控制校验范围,写库仍需字段白名单。

追问

  • 场景名区分大小写吗?答:场景名不区分大小写,调用时不要把驼峰转下划线,以场景手册说明为准。
  • 一个验证器能定义多个场景吗?答:可以,$scene 支持多个场景条目。

06.5.2.7-007 场景方法 sceneEdit 与 only/remove/append 如何使用?

一句话结论

可为场景定义方法 scene + 场景名,用 only() 限定字段、remove() 移除某字段规则、append() 追加规则;多次移除同一字段规则需数组或 | 一次性传。

概念解释

场景方法在字段列表基础上精细调整规则:编辑场景追加长度规则、移除唯一性规则等。

原理流程

  1. 定义 sceneEdit() 方法。
  2. only() 声明本场景字段。
  3. remove() 删除部分规则,append() 追加规则。
  4. 框架按调整后的规则集校验。

代码或图示

public function sceneEdit()
{
    return $this->only(['name', 'age'])
        ->append('name', 'min:5')
        ->remove('age', 'between')
        ->append('age', 'require|max:100');
}

常见误区

  • 链式多次 remove('field', 'rule1')->remove('field', 'rule2'):第二条移除可能不生效,应合并传数组/|。
  • 场景方法名拼写与 $scene 键不一致:方法不被调用。

追问

  • append 追加的规则与原规则并存吗?答:并存叠加,移除才会去掉指定规则。
  • 场景方法与 $scene 数组冲突吗?答:方法优先做精细调整,数组提供基础字段列表。

06.5.2.7-008 批量验证 batch(true) 如何工作?

一句话结论

默认遇到第一条失败即停止后续校验;batch(true) 收集全部字段错误后一次性返回,错误信息为包含字段与提示的数组。

概念解释

批量验证适合表单一次性展示全部错误,提升前端体验;默认短路校验适合接口快速失败。

原理流程

  1. 调用 batch(true) 开启批量模式。
  2. 逐字段执行规则,失败记录但不中断。
  3. 汇总错误数组。
  4. 抛异常或 getError() 返回聚合结果。

代码或图示

try {
    validate(\app\validate\User::class)->batch(true)->check([
        'name'  => 'thinkphp',
        'email' => 'thinkphp@qq.com',
    ]);
} catch (\think\exception\ValidateException $e) {
    dump($e->getError()); // 字段 => 错误信息数组
}

常见误区

  • 批量错误当字符串输出:结构为数组,前端需按字段渲染。
  • 高并发写接口用批量验证:短路失败更省校验成本。

追问

  • 批量模式下规则顺序还重要吗?答:仍按规则顺序收集错误,但不因单条失败中断。
  • 8.1.2 对批量验证有修正吗?答:更新日志记载批量验证有修正,以对应版本说明为准。

06.5.2.7-009 闭包规则如何写,返回值含义是什么?

一句话结论

字段规则可传闭包,首参为字段值、次参为全部数据;返回 true 通过,返回 false 用系统错误信息,返回字符串则以该串为错误提示。

概念解释

闭包规则承载简单内联校验,无需新建自定义规则方法。使用闭包后该字段不再叠加多条字符串规则。

原理流程

  1. 规则值写为闭包。
  2. 验证器传入值与全量数据。
  3. 闭包返回布尔或错误字符串。
  4. 按返回值判定通过/失败。

代码或图示

$validate = \think\facade\Validate::rule([
    'name' => function ($value, $data) {
        return strtolower($value) === 'thinkphp' ? true : '用户名错误';
    },
]);

常见误区

  • 闭包内抛异常代替返回 false:异常会中断验证流程,应返回错误标识。
  • 闭包规则与 | 规则混用:该字段不再支持多规则组合。

追问

  • 闭包能做数据库查询校验吗?答:可以,但复杂可复用规则应抽自定义规则方法或验证器场景。
  • 闭包第二参数一定有吗?答:可选参数,只声明值参数也可运行。

06.5.2.7-010 自定义规则方法如何定义?

一句话结论

在验证器类中定义驼峰方法(如 checkName),参数依次为验证值、验证规则、全部数据、字段名、字段描述;返回 true 或错误字符串,方法名不能与内置规则冲突。

概念解释

复杂业务校验沉淀为验证器方法,规则串中按方法名引用。方法签名参数按需要选用后三个。

原理流程

  1. 编写 checkXxx($value, $rule, $data = []) 方法。
  2. 规则串引用自定义规则名。
  3. 验证器反射调用方法并传参。
  4. 返回通过标识或错误文案。

代码或图示

protected $rule = [
    'name' => 'checkName',
];

protected function checkName($value, $rule, $data = [])
{
    return $rule == $value ? true : '名称错误';
}

常见误区

  • 方法名与内置规则重名:覆盖/冲突,应避开。
  • 方法非驼峰命名:框架按约定查找不到。

追问

  • 自定义方法支持注入依赖吗?答:验证器方法以反射调用为主,复杂依赖可在验证器构造器注入或通过容器获取,具体支持程度以版本源码为准(待确认)。
  • 规则参数怎么传入方法?答:checkName:参数 形式挂在规则串后,方法第二参数接收。

06.5.2.7-011 独立验证(不建验证器类)怎么用?

一句话结论

通过 Validate::rule([...]) 或 Validate::checkRule(值, 规则) 直接校验,适合一次性、简单的数据校验;独立验证不支持场景概念。

概念解释

独立验证无需类文件,规则在调用点链式定义。场景仅对验证器类有效,独立验证用规则数组表达。

原理流程

  1. 引入 think\facade\Validate。
  2. rule() 定义字段规则。
  3. check($data) 校验或 checkRule() 校验单值。
  4. 取返回值/错误信息。

代码或图示

use think\facade\Validate;

Validate::checkRule('thinkphp@qq.com', 'email');

$validate = Validate::rule([
    'name'  => 'require|max:25',
    'email' => 'email',
]);
$validate->check($data);

常见误区

  • 对独立验证调用 scene():场景仅验证器类支持。
  • 多处复制同一套规则:应沉淀为验证器类复用。

追问

  • checkRule 返回什么?答:通过为 true,失败返回错误信息/ false,具体以版本方法签名为准(待确认)。
  • 独立验证能用自定义错误信息吗?答:可通过 message() 链式设置,方法名以手册为准。

06.5.2.7-012 常用内置规则有哪些?

一句话结论

常用规则包括 require(必须)、number(数字)、integer、max/min/between(长度/范围)、email、url、regex、in、date、mobile 等;规则名严格区分大小写。

概念解释

内置规则覆盖格式、长度、范围、枚举等通用校验。条件规则(requireIf/requireWith/requireWithout/requireCallback)处理依赖必填。

原理流程

  1. 规则串选用对应内置规则。
  2. 参数按规则语义解析。
  3. 验证器调用规则实现校验。
  4. 失败按规则生成定制/默认信息。

代码或图示

protected $rule = [
    'username' => 'require|alphaDash|max:20',
    'age'      => 'number|between:1,120',
    'role'     => 'in:user,admin,guest',
    'email'    => 'email',
];

常见误区

  • 规则名大小写错:规则匹配不到。
  • 用 number 校验手机号:应配合 mobile 或正则规则。

追问

  • 方法式调用 require 为什么要写 isRequire?答:require 是 PHP 保留字,静态方法调用使用 isRequire 或 must 方法名。
  • 8.0 新增了哪些规则?答:startWith/endWith/contain 等,以 8.0 更新日志为准。

06.5.2.7-013 唯一验证 unique 如何使用?

一句话结论

unique:表名,字段,排除主键,主键字段 校验字段值在表中唯一;编辑场景排除当前记录,复杂条件可用闭包/数组方式定义。

概念解释

唯一性校验防止重复用户名、邮箱等。排除主键参数用于更新时不把自身计入冲突。

原理流程

  1. 规则指定表名与字段。
  2. 验证器构造查询统计匹配记录。
  3. 排除参数过滤当前记录。
  4. 存在重复则返回错误。

代码或图示

protected $rule = [
    'email' => 'unique:user,email,' . $this->getUid() . ',id',
];

常见误区

  • 编辑时未排除自身:当前记录被判为重复。
  • 表名带前缀未按约定书写:查询表名错误。

追问

  • 复杂唯一条件怎么写?答:规则支持闭包或数组方式附加额外条件,具体形式以唯一规则文档为准(待确认)。
  • 唯一校验走模型还是 Db?答:验证组件通过数据库查询实现,表名/字段按数据库配置解析。

06.5.2.7-014 上传文件验证规则有哪些?

一句话结论

文件校验规则:fileSize(最大字节)、fileExt(后缀白名单)、fileMime(MIME 类型)、image(尺寸与类型);验证值为上传文件对象或数组。

概念解释

文件校验需同时限制大小、后缀与 MIME,单靠后缀可被绕过。多文件逐个或整体按规则校验。

原理流程

  1. file() 取上传对象。
  2. 规则串组合大小、后缀、MIME 校验。
  3. 验证器读取文件信息比对规则参数。
  4. 失败返回对应错误信息。

代码或图示

validate(['image' => 'fileSize:10240|fileExt:jpg,png|image:200,200,jpg'])
    ->check($files);

常见误区

  • 只校验后缀不校验 MIME:伪装文件可绕过。
  • fileSize 单位写错:参数为字节,不是 KB/MB。

追问

  • image 规则参数含义?答:宽、高、后缀等尺寸/类型约束,参数顺序以文件上传手册为准。
  • 多文件如何逐个校验?答:遍历文件数组分别验证,或按数组规则整体校验。

06.5.2.7-015 错误信息结构与 ValidateException 如何取?

一句话结论

验证失败抛 think\exception\ValidateException,getError() 返回错误信息(字符串或批量数组);处理器可按结构渲染字段级错误。

概念解释

错误结构随批量开关变化:单条为字符串/单字段信息,批量为字段到错误列表的映射。前端按结构渲染。

原理流程

  1. 规则校验失败记录错误。
  2. 抛出异常携带错误信息。
  3. 控制器/处理器调 getError() 取出。
  4. 包装为接口错误响应。

代码或图示

catch (\think\exception\ValidateException $e) {
    $errors = $e->getError();
    return json(['code' => 422, 'errors' => $errors], 422);
}

常见误区

  • 假设 getError() 一定是字符串:批量模式为数组。
  • 异常信息直接回显堆栈:只返回校验文案。

追问

  • 异常能取到错误字段名吗?答:8.1.0 起异常增加 getKey() 获取错误字段名,以更新日志为准。
  • 多语言错误信息如何切换?答:文案可挂语言包,按当前语言加载,具体集成方式以验证手册为准。

06.5.2.7-016 路由层验证如何绑定?

一句话结论

路由规则可通过 validate 参数绑定验证器类,匹配阶段先校验请求变量,不通过则不命中规则或抛验证异常;与控制器内验证粒度互补。

概念解释

路由验证在调度前拦截非法请求,适合请求变量格式校验;业务规则与写库前校验仍在控制器/服务层。

原理流程

  1. 规则链式 validate(验证器类)。
  2. 路由匹配阶段执行绑定验证器。
  3. 失败按配置跳过规则或抛异常。
  4. 通过后进入控制器动作。

代码或图示

Route::post('news/:id', 'News/save')
    ->validate(\app\validate\News::class);

常见误区

  • 把全部业务校验放路由层:路由层只接触请求变量,无法访问服务内规则。
  • 路由验证与控制器验证重复配置:明确分工避免双重维护。

追问

  • 路由验证支持场景吗?答:绑定形式以路由参数文档为准,场景细粒度校验通常在控制器验证器完成。
  • 验证失败响应谁来渲染?答:由异常处理器统一渲染,与控制器验证失败走同一收口。

06.5.2.7-017 表单令牌解决什么问题?

一句话结论

表单令牌(Token)用于防范 CSRF 与重复提交:会话生成一次性/会话级令牌,表单携带提交,服务端校验通过后失效或比对,防止跨站伪造与表单重复入库。

概念解释

令牌与会话绑定,攻击者无法跨站获取合法令牌。防重复提交要求同一令牌只消费一次,或在短时间内拦截重复请求。

原理流程

  1. 页面生成时向会话写入令牌。
  2. 表单隐藏域携带令牌值。
  3. 提交时中间件/验证规则校验令牌与会话匹配。
  4. 校验通过后按策略失效令牌或记录消费时间。

代码或图示

// 表单隐藏域示意(令牌输出方法以模板/请求手册为准)
// <input type="hidden" name="__token__" value="{$token}">

常见误区

  • 令牌只防重复不防 CSRF:二者原理相关但策略不同,按安全目标配置失效规则。
  • 令牌固定不变长期复用:失去一次性防护意义。

追问

  • API 无 Cookie 场景用什么防重?答:可结合幂等键(客户端生成唯一请求号 + 服务端去重),令牌方案依赖会话上下文。
  • 令牌存在哪里?答:Session 存储,需先注册 SessionInit 中间件。

06.5.2.7-018 FormTokenCheck 中间件与 token 规则如何配合?

一句话结论

内置 FormTokenCheck 中间件负责表单令牌校验,验证器规则中使用 token 规则也可校验当前请求令牌;二者按项目选择其一或分层配合,令牌字段名以配置为准。

概念解释

中间件在请求链统一拦截令牌缺失/不匹配;验证器规则在字段校验阶段检查 token 字段。Session 初始化是令牌校验的前提。

原理流程

  1. 注册 SessionInit 与 FormTokenCheck 中间件。
  2. 表单提交携带令牌字段。
  3. 中间件/规则比对会话令牌与提交值。
  4. 不匹配返回验证错误,通过后进入业务。

代码或图示

// app/middleware.php
return [
    \think\middleware\SessionInit::class,
    \think\middleware\FormTokenCheck::class,
];
protected $rule = [
    'name'  => 'require',
    '__token__' => 'token',
];

常见误区

  • 未初始化 Session 就校验令牌:会话为空,校验必然失败。
  • 前后端字段名不一致:按框架/配置约定的令牌字段名提交。

追问

  • 令牌字段名可配置吗?答:令牌字段名与规则配置以验证/中间件手册为准(待确认)。
  • 中间件与规则重复校验会怎样?答:同一令牌被校验两次,注意失效策略不要导致二次校验失败。

06.5.2.7-019 令牌如何生成与输出到表单?

一句话结论

令牌由 Session/令牌组件在页面渲染时生成并写入会话,模板通过标签或请求方法输出隐藏域;具体生成方法名与模板标签语法以当前版本手册为准(待确认项)。

概念解释

生成时机在响应页面时,提交时服务端从会话读取比对。开发时应核对框架提供的令牌助手/标签,避免自行实现绕过既有校验逻辑。

原理流程

  1. 渲染表单页前生成令牌存入会话。
  2. 模板输出令牌隐藏域。
  3. 提交请求携带该字段。
  4. 服务端按中间件/规则校验。

代码或图示

// 生成与读取入口以版本手册核对(示意)
$token = \think\facade\Session::get('__token__') ?: '';
// 模板:<input type="hidden" name="__token__" value="{$token}">

常见误区

  • 前端硬编码固定令牌值:无防护作用。
  • 多标签页共用同一令牌:一次性令牌在并发表单下可能互相失效。

追问

  • 如何核对生成 API?答:查阅验证章节“表单令牌”小节与 Request 门面方法清单,确认 token() 相关方法签名。
  • 令牌有效期如何控制?答:随会话生命周期,必要时按业务缩短会话/令牌过期时间。

06.5.2.7-020 字段别名与多语言错误信息如何组织?

一句话结论

错误信息中的字段名可通过别名/标题定义为友好名称;多语言项目把文案按语言包组织,按当前语言加载对应提示,校验规则本身不变。

概念解释

用户看到的是字段别名而非数据库字段名。多语言替换的是文案层,规则与校验逻辑与语言无关。

原理流程

  1. 定义字段别名映射(属性名以手册为准,待确认)。
  2. 错误信息模板引用别名。
  3. 按语言环境加载对应文案。
  4. 验证失败返回本地化提示。

代码或图示

protected $field = [
    'name'  => '名称',
    'email' => '邮箱地址',
];

protected $message = [
    'name.require' => '{$field}必须填写',
];

常见误区

  • 错误信息直接暴露英文数据库字段:面向用户应使用中文/本地别名。
  • 把规则参数写进面向用户文案:泄露内部校验细节。

追问

  • 别名属性名在不同版本是否一致?答:以当前版本验证器源码/手册为准,核对 $field 或对应别名属性。
  • 语言包如何与验证器结合?答:通过 Lang 组件按语言读取文案,集成方式以多语言手册为准。