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() 助手调用。
概念解释
验证器把校验规则从控制器抽成可复用类。规则按字段组织,错误信息按“字段.规则”键定制。
原理流程
- 新建验证器类继承
think\Validate。 - 声明
$rule、$message、$scene属性。 - 控制器传入验证器类名执行
check()。 - 验证失败抛
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);字段为键,规则串为值,也可用数组形式定义规则。
概念解释
每条规则对应一种校验能力,参数按规则含义解析。数组形式便于附加闭包规则或多规则组合。
原理流程
- 字段名作为数组键。
- 规则串按
|拆分为规则列表。 - 每条规则按
:拆规则名与参数。 - 验证器按顺序执行规则校验。
代码或图示
protected $rule = [
'name' => 'require|max:25',
'age' => 'number|between:1,120',
'email' => ['require', 'email'],
];
常见误区
- 规则参数逗号写成其他分隔符:参数解析错误。
- 规则名大小写写错:规则严格区分大小写。
追问
- 一条规则多个参数怎么传?答:规则名后
:接逗号分隔参数,如between:1,120。 - 闭包规则与字符串规则能同字段混用吗?答:使用闭包规则后该字段不再支持多条字符串规则,以手册说明为准。
06.5.2.7-003 $message 错误信息如何定制?
一句话结论
错误信息数组以 字段.规则 为键、提示文案为值;只定制需要覆盖的条目,未覆盖使用系统默认信息;也可按字段整体定义。
概念解释
定制信息面向最终用户,避免暴露规则细节。多语言项目可按语言包替换文案。
原理流程
- 验证失败定位字段与规则。
- 查
$message是否有对应键。 - 命中返回定制文案,否则取默认信息。
- 批量验证时错误按字段聚合。
代码或图示
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() 获取。
概念解释
验证器默认失败抛异常(按配置/调用方式);独立验证场景可判断返回值后取错误信息。错误信息可为字符串或数组。
原理流程
- 组装待验证数据数组。
- 调用
check($data)触发规则校验。 - 失败:读取
getError()或捕获异常。 - 通过后进入业务处理。
代码或图示
$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();也可直接传规则数组做独立验证。
概念解释
助手函数简化验证器实例获取,内部经容器解析。控制器中按场景链式配置后执行检查。
原理流程
- 调用
validate(User::class)实例化验证器。 - 链式指定场景、批量等选项。
check($data)执行校验。- 失败按异常/返回值处理。
代码或图示
validate(\app\validate\User::class)
->scene('edit')
->batch(true)
->check($request->param());
常见误区
- 忘记调
check():只配置规则未执行校验。 - 把请求对象直接传给
check():应传参数数组。
追问
validate()不传参数怎样?答:返回验证器实例后用rule()方法定义规则,做独立验证。- 验证器实例可复用吗?答:每次调用建议按请求新建,避免上一次错误状态残留。
06.5.2.7-006 场景验证如何定义与调用?
一句话结论
$scene 数组声明场景对应字段列表,调用时 scene('edit') 指定场景;场景只验证列出的字段,不同用例复用同一验证器的不同规则子集。
概念解释
新增与编辑字段要求不同(如编辑不需要再次校验密码唯一),场景在同一验证器内区分数据子集。
原理流程
$scene定义场景名到字段数组的映射。- 调用
scene('edit')切换场景。 - 验证器只校验场景内字段。
- 场景方法可进一步增删规则。
代码或图示
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() 追加规则;多次移除同一字段规则需数组或 | 一次性传。
概念解释
场景方法在字段列表基础上精细调整规则:编辑场景追加长度规则、移除唯一性规则等。
原理流程
- 定义
sceneEdit()方法。 only()声明本场景字段。remove()删除部分规则,append()追加规则。- 框架按调整后的规则集校验。
代码或图示
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) 收集全部字段错误后一次性返回,错误信息为包含字段与提示的数组。
概念解释
批量验证适合表单一次性展示全部错误,提升前端体验;默认短路校验适合接口快速失败。
原理流程
- 调用
batch(true)开启批量模式。 - 逐字段执行规则,失败记录但不中断。
- 汇总错误数组。
- 抛异常或
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 用系统错误信息,返回字符串则以该串为错误提示。
概念解释
闭包规则承载简单内联校验,无需新建自定义规则方法。使用闭包后该字段不再叠加多条字符串规则。
原理流程
- 规则值写为闭包。
- 验证器传入值与全量数据。
- 闭包返回布尔或错误字符串。
- 按返回值判定通过/失败。
代码或图示
$validate = \think\facade\Validate::rule([
'name' => function ($value, $data) {
return strtolower($value) === 'thinkphp' ? true : '用户名错误';
},
]);
常见误区
- 闭包内抛异常代替返回 false:异常会中断验证流程,应返回错误标识。
- 闭包规则与
|规则混用:该字段不再支持多规则组合。
追问
- 闭包能做数据库查询校验吗?答:可以,但复杂可复用规则应抽自定义规则方法或验证器场景。
- 闭包第二参数一定有吗?答:可选参数,只声明值参数也可运行。
06.5.2.7-010 自定义规则方法如何定义?
一句话结论
在验证器类中定义驼峰方法(如 checkName),参数依次为验证值、验证规则、全部数据、字段名、字段描述;返回 true 或错误字符串,方法名不能与内置规则冲突。
概念解释
复杂业务校验沉淀为验证器方法,规则串中按方法名引用。方法签名参数按需要选用后三个。
原理流程
- 编写
checkXxx($value, $rule, $data = [])方法。 - 规则串引用自定义规则名。
- 验证器反射调用方法并传参。
- 返回通过标识或错误文案。
代码或图示
protected $rule = [
'name' => 'checkName',
];
protected function checkName($value, $rule, $data = [])
{
return $rule == $value ? true : '名称错误';
}
常见误区
- 方法名与内置规则重名:覆盖/冲突,应避开。
- 方法非驼峰命名:框架按约定查找不到。
追问
- 自定义方法支持注入依赖吗?答:验证器方法以反射调用为主,复杂依赖可在验证器构造器注入或通过容器获取,具体支持程度以版本源码为准(待确认)。
- 规则参数怎么传入方法?答:
checkName:参数形式挂在规则串后,方法第二参数接收。
06.5.2.7-011 独立验证(不建验证器类)怎么用?
一句话结论
通过 Validate::rule([...]) 或 Validate::checkRule(值, 规则) 直接校验,适合一次性、简单的数据校验;独立验证不支持场景概念。
概念解释
独立验证无需类文件,规则在调用点链式定义。场景仅对验证器类有效,独立验证用规则数组表达。
原理流程
- 引入
think\facade\Validate。 rule()定义字段规则。check($data)校验或checkRule()校验单值。- 取返回值/错误信息。
代码或图示
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)处理依赖必填。
原理流程
- 规则串选用对应内置规则。
- 参数按规则语义解析。
- 验证器调用规则实现校验。
- 失败按规则生成定制/默认信息。
代码或图示
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:表名,字段,排除主键,主键字段 校验字段值在表中唯一;编辑场景排除当前记录,复杂条件可用闭包/数组方式定义。
概念解释
唯一性校验防止重复用户名、邮箱等。排除主键参数用于更新时不把自身计入冲突。
原理流程
- 规则指定表名与字段。
- 验证器构造查询统计匹配记录。
- 排除参数过滤当前记录。
- 存在重复则返回错误。
代码或图示
protected $rule = [
'email' => 'unique:user,email,' . $this->getUid() . ',id',
];
常见误区
- 编辑时未排除自身:当前记录被判为重复。
- 表名带前缀未按约定书写:查询表名错误。
追问
- 复杂唯一条件怎么写?答:规则支持闭包或数组方式附加额外条件,具体形式以唯一规则文档为准(待确认)。
- 唯一校验走模型还是 Db?答:验证组件通过数据库查询实现,表名/字段按数据库配置解析。
06.5.2.7-014 上传文件验证规则有哪些?
一句话结论
文件校验规则:fileSize(最大字节)、fileExt(后缀白名单)、fileMime(MIME 类型)、image(尺寸与类型);验证值为上传文件对象或数组。
概念解释
文件校验需同时限制大小、后缀与 MIME,单靠后缀可被绕过。多文件逐个或整体按规则校验。
原理流程
file()取上传对象。- 规则串组合大小、后缀、MIME 校验。
- 验证器读取文件信息比对规则参数。
- 失败返回对应错误信息。
代码或图示
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() 返回错误信息(字符串或批量数组);处理器可按结构渲染字段级错误。
概念解释
错误结构随批量开关变化:单条为字符串/单字段信息,批量为字段到错误列表的映射。前端按结构渲染。
原理流程
- 规则校验失败记录错误。
- 抛出异常携带错误信息。
- 控制器/处理器调
getError()取出。 - 包装为接口错误响应。
代码或图示
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 参数绑定验证器类,匹配阶段先校验请求变量,不通过则不命中规则或抛验证异常;与控制器内验证粒度互补。
概念解释
路由验证在调度前拦截非法请求,适合请求变量格式校验;业务规则与写库前校验仍在控制器/服务层。
原理流程
- 规则链式
validate(验证器类)。 - 路由匹配阶段执行绑定验证器。
- 失败按配置跳过规则或抛异常。
- 通过后进入控制器动作。
代码或图示
Route::post('news/:id', 'News/save')
->validate(\app\validate\News::class);
常见误区
- 把全部业务校验放路由层:路由层只接触请求变量,无法访问服务内规则。
- 路由验证与控制器验证重复配置:明确分工避免双重维护。
追问
- 路由验证支持场景吗?答:绑定形式以路由参数文档为准,场景细粒度校验通常在控制器验证器完成。
- 验证失败响应谁来渲染?答:由异常处理器统一渲染,与控制器验证失败走同一收口。
06.5.2.7-017 表单令牌解决什么问题?
一句话结论
表单令牌(Token)用于防范 CSRF 与重复提交:会话生成一次性/会话级令牌,表单携带提交,服务端校验通过后失效或比对,防止跨站伪造与表单重复入库。
概念解释
令牌与会话绑定,攻击者无法跨站获取合法令牌。防重复提交要求同一令牌只消费一次,或在短时间内拦截重复请求。
原理流程
- 页面生成时向会话写入令牌。
- 表单隐藏域携带令牌值。
- 提交时中间件/验证规则校验令牌与会话匹配。
- 校验通过后按策略失效令牌或记录消费时间。
代码或图示
// 表单隐藏域示意(令牌输出方法以模板/请求手册为准)
// <input type="hidden" name="__token__" value="{$token}">
常见误区
- 令牌只防重复不防 CSRF:二者原理相关但策略不同,按安全目标配置失效规则。
- 令牌固定不变长期复用:失去一次性防护意义。
追问
- API 无 Cookie 场景用什么防重?答:可结合幂等键(客户端生成唯一请求号 + 服务端去重),令牌方案依赖会话上下文。
- 令牌存在哪里?答:Session 存储,需先注册
SessionInit中间件。
06.5.2.7-018 FormTokenCheck 中间件与 token 规则如何配合?
一句话结论
内置 FormTokenCheck 中间件负责表单令牌校验,验证器规则中使用 token 规则也可校验当前请求令牌;二者按项目选择其一或分层配合,令牌字段名以配置为准。
概念解释
中间件在请求链统一拦截令牌缺失/不匹配;验证器规则在字段校验阶段检查 token 字段。Session 初始化是令牌校验的前提。
原理流程
- 注册
SessionInit与FormTokenCheck中间件。 - 表单提交携带令牌字段。
- 中间件/规则比对会话令牌与提交值。
- 不匹配返回验证错误,通过后进入业务。
代码或图示
// 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/令牌组件在页面渲染时生成并写入会话,模板通过标签或请求方法输出隐藏域;具体生成方法名与模板标签语法以当前版本手册为准(待确认项)。
概念解释
生成时机在响应页面时,提交时服务端从会话读取比对。开发时应核对框架提供的令牌助手/标签,避免自行实现绕过既有校验逻辑。
原理流程
- 渲染表单页前生成令牌存入会话。
- 模板输出令牌隐藏域。
- 提交请求携带该字段。
- 服务端按中间件/规则校验。
代码或图示
// 生成与读取入口以版本手册核对(示意)
$token = \think\facade\Session::get('__token__') ?: '';
// 模板:<input type="hidden" name="__token__" value="{$token}">
常见误区
- 前端硬编码固定令牌值:无防护作用。
- 多标签页共用同一令牌:一次性令牌在并发表单下可能互相失效。
追问
- 如何核对生成 API?答:查阅验证章节“表单令牌”小节与
Request门面方法清单,确认token()相关方法签名。 - 令牌有效期如何控制?答:随会话生命周期,必要时按业务缩短会话/令牌过期时间。
06.5.2.7-020 字段别名与多语言错误信息如何组织?
一句话结论
错误信息中的字段名可通过别名/标题定义为友好名称;多语言项目把文案按语言包组织,按当前语言加载对应提示,校验规则本身不变。
概念解释
用户看到的是字段别名而非数据库字段名。多语言替换的是文案层,规则与校验逻辑与语言无关。
原理流程
- 定义字段别名映射(属性名以手册为准,待确认)。
- 错误信息模板引用别名。
- 按语言环境加载对应文案。
- 验证失败返回本地化提示。
代码或图示
protected $field = [
'name' => '名称',
'email' => '邮箱地址',
];
protected $message = [
'name.require' => '{$field}必须填写',
];
常见误区
- 错误信息直接暴露英文数据库字段:面向用户应使用中文/本地别名。
- 把规则参数写进面向用户文案:泄露内部校验细节。
追问
- 别名属性名在不同版本是否一致?答:以当前版本验证器源码/手册为准,核对
$field或对应别名属性。 - 语言包如何与验证器结合?答:通过 Lang 组件按语言读取文案,集成方式以多语言手册为准。