thinkphp 5.0 验证规则

﹏ヽ暗。殇╰゛Y 2022-07-16 08:11 125阅读 0赞

[官方文档 - 内置规则][-]  
系统内置的验证规则如下：

**格式验证类：**

<table> 
 <thead> 
  <tr> 
   <th>规则</th> 
   <th>说明</th> 
   <th>示例</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>require</td> 
   <td>验证某个字段必须</td> 
   <td>‘name’=&gt;’require’</td> 
  </tr> 
  <tr> 
   <td>number 或者 integer</td> 
   <td>验证某个字段的值是否为数字（采用filter_var验证）</td> 
   <td>‘num’=&gt;’number’</td> 
  </tr> 
  <tr> 
   <td>float</td> 
   <td>验证某个字段的值是否为浮点数字（采用filter_var验证）</td> 
   <td>‘num’=&gt;’float’</td> 
  </tr> 
  <tr> 
   <td>boolean</td> 
   <td>验证某个字段的值是否为布尔值（采用filter_var验证）</td> 
   <td>‘num’=&gt;’boolean’</td> 
  </tr> 
  <tr> 
   <td>email</td> 
   <td>验证某个字段的值是否为email地址（采用filter_var验证）</td> 
   <td>‘email’=&gt;’email’</td> 
  </tr> 
  <tr> 
   <td>array</td> 
   <td>验证某个字段的值是否为数组</td> 
   <td>‘info’=&gt;’array’</td> 
  </tr> 
  <tr> 
   <td>accepted</td> 
   <td>验证某个字段是否为为 yes, on, 或是 1。这在确认”服务条款”是否同意时很有用</td> 
   <td>‘accept’=&gt;’accepted’</td> 
  </tr> 
  <tr> 
   <td>date</td> 
   <td>验证值是否为有效的日期，会对日期值进行strtotime后进行判断</td> 
   <td>‘date’=&gt;’date’</td> 
  </tr> 
  <tr> 
   <td>alpha</td> 
   <td>验证某个字段的值是否为字母</td> 
   <td>‘name’=&gt;’alpha’</td> 
  </tr> 
  <tr> 
   <td>alphaNum</td> 
   <td>验证某个字段的值是否为字母和数字</td> 
   <td>‘name’=&gt;’alphaNum’</td> 
  </tr> 
  <tr> 
   <td>alphaDash</td> 
   <td>验证某个字段的值是否为字母和数字，下划线_及破折号-</td> 
   <td>‘name’=&gt;’alphaDash’</td> 
  </tr> 
  <tr> 
   <td>activeUrl</td> 
   <td>验证某个字段的值是否为有效的域名或者IP</td> 
   <td>‘host’=&gt;’activeUrl’</td> 
  </tr> 
  <tr> 
   <td>url</td> 
   <td>验证某个字段的值是否为有效的URL地址（采用filter_var验证）</td> 
   <td>‘url’=&gt;’url’</td> 
  </tr> 
  <tr> 
   <td>ip</td> 
   <td>验证某个字段的值是否为有效的IP地址（采用filter_var验证），支持验证ipv4和ipv6格式的IP地址</td> 
   <td>‘ip’=&gt;’ip’</td> 
  </tr> 
  <tr> 
   <td>dateFormat:format</td> 
   <td>验证某个字段的值是否为指定格式的日期</td> 
   <td>‘create_time’=&gt;’dateFormat:y-m-d’</td> 
  </tr> 
 </tbody> 
</table>

**长度和区间验证类：**

<table> 
 <thead> 
  <tr> 
   <th>规则</th> 
   <th>说明</th> 
   <th>示例</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>in</td> 
   <td>验证某个字段的值是否在某个范围</td> 
   <td>‘num’=&gt;’in:1,2,3’</td> 
  </tr> 
  <tr> 
   <td>notIn</td> 
   <td>验证某个字段的值不在某个范围</td> 
   <td>‘num’=&gt;’notIn:1,2,3’</td> 
  </tr> 
  <tr> 
   <td>between</td> 
   <td>验证某个字段的值是否在某个区间</td> 
   <td>‘num’=&gt;’between:1,10’</td> 
  </tr> 
  <tr> 
   <td>notBetween</td> 
   <td>验证某个字段的值不在某个范围</td> 
   <td>‘num’=&gt;’notBetween:1,10’</td> 
  </tr> 
  <tr> 
   <td>length:num1,num2</td> 
   <td>验证某个字段的值的长度是否在某个范围，或者指定长度。<br>*如果验证的数据是数组，则判断数组的长度。<br>如果验证的数据是File对象，则判断文件的大小。</td> 
   <td>‘name’=&gt;’length:4,25’<br>’name’=&gt;’length:4’</td> 
  </tr> 
  <tr> 
   <td>max:number</td> 
   <td>验证某个字段的值的最大长度 <br>*如果验证的数据是数组，则判断数组的长度。<br>如果验证的数据是File对象，则判断文件的大小。</td> 
   <td>‘name’=&gt;’max:25’</td> 
  </tr> 
  <tr> 
   <td>min:number</td> 
   <td>验证某个字段的值的最小长度<br>*如果验证的数据是数组，则判断数组的长度。<br>如果验证的数据是File对象，则判断文件的大小。</td> 
   <td>‘name’=&gt;’min:5’</td> 
  </tr> 
  <tr> 
   <td>after:日期</td> 
   <td>验证某个字段的值是否在某个日期之后</td> 
   <td>‘begin_time’ =&gt; ‘after:2016-3-18’,</td> 
  </tr> 
  <tr> 
   <td>before:日期</td> 
   <td>验证某个字段的值是否在某个日期之前</td> 
   <td>‘end_time’ =&gt; ‘before:2016-10-01’,</td> 
  </tr> 
  <tr> 
   <td>expire:开始时间,结束时间</td> 
   <td>验证当前操作（注意不是某个值）是否在某个有效日期之内</td> 
   <td>‘expire_time’ =&gt; ‘expire:2016-2-1,2016-10-01’,</td> 
  </tr> 
  <tr> 
   <td>allowIp:allow1,allow2,…</td> 
   <td>验证当前请求的IP是否在某个范围，该规则可以用于某个后台的访问权限</td> 
   <td>‘name’ =&gt; ‘allowIp:114.45.4.55’,</td> 
  </tr> 
  <tr> 
   <td>denyIp:allow1,allow2,…</td> 
   <td>验证当前请求的IP是否禁止访问</td> 
   <td>‘name’ =&gt; ‘denyIp:114.45.4.55’,</td> 
  </tr> 
 </tbody> 
</table>

**字段比较类：**

<table> 
 <thead> 
  <tr> 
   <th>规则</th> 
   <th>说明</th> 
   <th>示例</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>confirm</td> 
   <td>验证某个字段是否和另外一个字段的值一致</td> 
   <td>‘repassport’=&gt;’require</td> 
  </tr> 
  <tr> 
   <td>different</td> 
   <td>验证某个字段是否和另外一个字段的值不一致</td> 
   <td>‘name’=&gt;’require</td> 
  </tr> 
  <tr> 
   <td>egt 或者 &gt;=</td> 
   <td>验证是否大于等于某个值</td> 
   <td>‘score’=&gt;’egt:60’<br>’num’=&gt;’&gt;=:100’</td> 
  </tr> 
  <tr> 
   <td>gt 或者 &gt;</td> 
   <td>验证是否大于某个值</td> 
   <td>‘score’=&gt;’gt:60’<br>’num’=&gt;’&gt;:100’</td> 
  </tr> 
  <tr> 
   <td>elt 或者 &lt;=</td> 
   <td>验证是否小于等于某个值</td> 
   <td>‘score’=&gt;’elt:100’<br>’num’=&gt;’&lt;=:100’</td> 
  </tr> 
  <tr> 
   <td>lt 或者 &lt;</td> 
   <td>验证是否小于某个值</td> 
   <td>‘score’=&gt;’lt:100’<br>’num’=&gt;’&lt;:100’</td> 
  </tr> 
  <tr> 
   <td>eq 或者 = 或者 same</td> 
   <td>验证是否等于某个值</td> 
   <td>‘score’=&gt;’eq:100’<br>’num’=&gt;’=:100’<br>’num’=&gt;’same:100’</td> 
  </tr> 
 </tbody> 
</table>

**filter验证：**

<table> 
 <thead> 
  <tr> 
   <th>规则</th> 
   <th>说明</th> 
   <th>示例</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td></td> 
   <td>支持使用filter_var进行验证</td> 
   <td>‘ip’=&gt;’filter:validate_ip’</td> 
  </tr> 
 </tbody> 
</table>

**正则验证：**

<table> 
 <thead> 
  <tr> 
   <th>规则</th> 
   <th>说明</th> 
   <th>示例</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td></td> 
   <td>支持直接使用正则验证</td> 
   <td>‘zip’=&gt;’\d{6}’,<br>// 或者<br>’zip’=&gt;’regex:\d{6}’,</td> 
  </tr> 
 </tbody> 
</table>

**上传验证：**

<table> 
 <thead> 
  <tr> 
   <th>规则</th> 
   <th>说明</th> 
   <th>示例</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>file</td> 
   <td>验证是否是一个上传文件</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>image:width,height,type</td> 
   <td>验证是否是一个图像文件，width height和type都是可选，width和height必须同时定义。</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>fileExt:允许的文件后缀</td> 
   <td>验证上传文件后缀</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>fileMime:允许的文件类型</td> 
   <td>验证上传文件类型</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>fileSize:允许的文件字节大小</td> 
   <td>验证上传文件大小</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

**行为验证：**

<table> 
 <thead> 
  <tr> 
   <th>规则</th> 
   <th>说明</th> 
   <th>示例</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td></td> 
   <td>使用行为验证数据</td> 
   <td>‘data’=&gt;’behavior:\app\index\behavior\Check’</td> 
  </tr> 
 </tbody> 
</table>

**其它验证：**

<table> 
 <thead> 
  <tr> 
   <th>规则</th> 
   <th>说明</th> 
   <th>示例</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>unique:table,field,except,pk</td> 
   <td>验证当前请求的字段值是否为唯一的</td> 
   <td>// 表示验证name字段的值是否在user表（不包含前缀）中唯一<br>’name’ =&gt; ‘unique:user’,<br>// 验证其他字段<br>’name’ =&gt; ‘unique:user,account’,<br>// 排除某个主键值<br>’name’ =&gt; ‘unique:user,account,10’,<br>// 指定某个主键值排除<br>’name’ =&gt; ‘unique:user,account,10,user_id’,<br><br>如果需要对复杂的条件验证唯一，可以使用下面的方式：<br>// 多个字段验证唯一验证条件<br>’name’ =&gt; ‘unique:user,status^account’,<br>// 复杂验证条件<br>’name’ =&gt; ‘unique:user,status=1&amp;account=’.$data[‘account’],</td> 
  </tr> 
  <tr> 
   <td>requireIf:field,value</td> 
   <td>验证某个字段的值等于某个值的时候必须</td> 
   <td>// 当account的值等于1的时候 password必须<br>’password’=&gt;’requireIf:account,1’</td> 
  </tr> 
  <tr> 
   <td>requireWith:field</td> 
   <td>验证某个字段有值的时候必须</td> 
   <td>// 当account有值的时候password字段必须<br>’password’=&gt;’requireWith:account’</td> 
  </tr> 
 </tbody> 
</table>

[-]: http://www.kancloud.cn/manual/thinkphp5/129319