TP8.0 验证器自定义规则编写全攻略【保姆级】

老辰小哥_6659

老辰小哥_6659

2026-07-09

927人浏览

原创

ThinkPHP 8.0 中自定义验证规则需通过 init() 方法或控制器动态注册,手机号校验需支持国际区号参数、身份证校验须预加载省份码避免实时查库,场景校验必须正确定义 $scene 属性否则规则失效。

tp8.0 验证器自定义规则编写全攻略【保姆级】

在 ThinkPHP 8.0 中为手机号加国际区号校验、为身份证号做末位校验、为密码强制要求含大小写字母和数字——这些不能靠内置规则解决的业务逻辑,必须写自定义验证规则,否则验证器直接报错或跳过校验。

注册自定义规则的两种入口

方法一:在验证器类的 init() 方法中注册(推荐)
打开 app/validate/UserValidate.php,在 init() 方法里调用 $this->extend(),传入别名和回调函数或方法名字符串。

方法二:在控制器中动态注册
创建验证器实例后,立即调用 $validate->extend(),适用于临时、一次性、不复用的规则,但无法被缓存复用,且无法参与场景(scene)校验。

【别名必须全局唯一】 若两个验证器都注册了 'id_card' 别名,后注册的会覆盖前一个,导致不可预期的校验行为。

写一个带参数的手机号校验规则

第一步:在 UserValidate 类的 init() 方法中注册闭包

$this->extend('isMobile', function($value, $rule) {
  $prefix = is_string($rule) ? $rule : ($rule[0] ?? '86');
  $pattern = match($prefix) {
    '86' => '/^1[3-9]\d{9}$/u',
    '852' => '/^([2-9]\d{7}|[2-9]\d{3}-\d{4})$/u',
    default => '/^\+' . preg_quote($prefix) . '\d{10,15}$/u';
  };
  return (bool) preg_match($pattern, $value);
});

第二步:在 $rule 中使用带参写法

'mobile' => 'isMobile:86' 或 'mobile' => 'isMobile:852',注意冒号后不要加空格。

第三步:在 $message 中配提示语

'mobile.isMobile' => ':attribute 必须是有效的 :rule 区号手机号',其中 :rule 会自动替换为传入的参数值(如 86)。

这一步操作起来很简单,直接把文件拖进去就行。但若漏掉 u 修饰符,中文或 emoji 输入时正则会匹配失败,且错误无提示,只返回 false。

写一个查库类的身份证校验规则

先在 __construct() 中预加载合法省份码,避免每次验证都查库:

$this->validProvinces = Cache::remember('idcard_provinces', 3600, function () {
  return Db::name('province_code')->column('code');
});

ThinkPHP5.1企业站点快速开发-源码课件
ThinkPHP5.1企业站点快速开发-源码课件

ThinkPHP5.1企业站点快速开发

下载

再定义校验方法,签名必须完整:

public function checkIdCard($value, $rule = '', $data = [], $field = '') {
  if (!is_string($value) || strlen($value) !== 18) {
    return '身份证长度必须为18位';
  }
  $provinceCode = substr($value, 0, 2) . '00';
  if (!in_array($provinceCode, $this->validProvinces)) {
    return '身份证归属地代码无效';
  }
  // 末位校验略(实际需补全)
  return true;
}

最后在 init() 中注册别名:

$this->extend('id_card', 'checkIdCard');

【禁止在回调里实时查库】 若此处直接写 Db::name('idcard_check')->where(...)->find(),高并发下数据库连接池会迅速耗尽,QPS 断崖式下跌。

验证器中启用场景并绑定规则

① 在验证器类中声明 $scene 属性,例如:

protected $scene = [
  'login' => ['username', 'password'],
  'register' => ['username', 'password', 'mobile', 'id_card'],
];

② 控制器中调用时指定场景名:

$result = $validate->scene('register')->check($data);

③ 场景字段可叠加额外规则:

protected $scene = [
  'register' => ['username', 'password', 'mobile', 'id_card'],
];
protected $pattern = [
  'username' => '/^[a-zA-Z][a-zA-Z0-9_]{4,19}$/u',
];

若未定义 $scene,调用 scene('xxx') 不会报错,但规则完全不生效,数据直接穿透过去——这个坑没有任何日志提示,只能靠断点确认。

相关文章

热门游戏推荐
热门游戏推荐

海量精品小游戏合集,无需安装即点即玩,休闲益智、动作闯关应有尽有,秒开即玩,轻松解压,快乐停不下来

下载

相关标签:

thinkphp

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

140

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

100

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

80

15

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

160

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

140

13

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

2026.11.06

120

10

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

2026.11.05

120

12

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

2026.11.05

100

12

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。

2026.11.04

120

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程