## 表单验证

一般通来模型来进行自动验证，也可以在控制器进行表单验证。

### 条件常量

在设置验证规则时，需要用到以下常量 ：

```php
const IF_MUST = 1;  // 必须(默认)
const IF_VALUE = 2; // 有值
const IF_EMPTY = 3; // 空值
const IF_ISSET = 4; // 有字段
const IF_UNSET = 5; // 无字段
```

### 验证示例

```php
// 验证规则：'表单字段', '验证规则[|...]', '错误提示[|...]', '[条件常量]'
$rule = [
    ['email', 'email', '邮箱错误', IF_MUST]
];
$data = ['email' => 'abc@163']; // 验证的数据
$result = validate($rule, $data); // 验证结果
$result->show(); //失败调用Error::_406
$result->getError(); //失败返回错误，通过返回空数组
$result->isFail(); //失败返回true
```

### 验证必填

| 规则 | 说明 |
| ------ | ------ |
| required | 必填 |
| required_if:field,value | 当field值为value时必填 |
| required_with:field,field... | 任一field有值时必填 |
| required_with_all:field,field... | 所有field有值时必填 |
| required_without:field,field... | 任一field无值时必填 |
| required_without_all:field,field... | 所有field无值时必填 |

### 验证格式

| 规则 | 说明 |
| ---- | --- |
|alpha|纯字母|
|alpha_num|字母 数字|
|alpha_dash|字母 数字 - _ |
|chs|纯汉字|
|chs_alpha|汉字 字母|
|chs_alpha_num|汉字 字母 数字|
|chs_dash|汉字 字母 数字 - _ |
|number|纯数字(0~n) 不包含负数和小数点|
|int_id|大于0整型(如id,page)|
|regex:[pattern]|正则验证 如：regex:/^\d{5,20}$/|
|float       				|验证浮点数(filter_var验证)|
|int         				|验证数字(filter_var验证)|
|boolean						|可转成布尔值：true false 1 0 '1' '0' |
|url         				|验证url(filter_var验证)|
|email       				|验证邮箱(filter_var验证)|
|ip          				|验证ip(filter_var验证)|
| start\_with:aphp_			|验证前置字符串|
| end\_with:.php				|验证后置字符串|
|contains:aphp				|验证是否包含字符串|
|confirmed:[field]			|必须与另一个字段的值相同|
|different:[field]			|必须与另一个字段的值不同|
|in:1,2,3					|在...之中|
|not_in:1,2					|不在...之中|
|between:1,10				|在n到m之间|
|not_between:1,10			|不在n到m之间|
|length:4,25					|长度设置|
|length:4					|指定长度|
|min:5						|最小值|
|max:25						|最大值|
|eq:值(=:值)				   |等于 如：=:abc|
|eq:_[字段]				   |等于字段，如：eq:_password	|
|neq:10(!=:10)				|不等于|
|gt:10(>:10)					|大于|
|egt:10(>=:10)				|大于等于|
|lt:10(<:10)					|小于|
|elt:10(<=:10)				|小于等于|
|after:2024-10-01			|是否在某个日期之后|
|before:2024-10-01			|是否在某个日期之前|

### 操作有效期

```php
expire:2024-01-01,2024-10-01	// 不是验证值
```

### 验证码

```php
captcha     // 内置验证码扩展验证
```

### 数据库验证

```php
unique:[table.pk,column,where] // 唯一(存在时不通过) 
exists:[table.pk,column,where] // 存在(不存在时不通过)
```

### 特殊规则

```php
/^\d{5,20}$/   // 正则表达式 
fn($i)=>($i>1) // 闭包函数
```

### 内置函数

可使用自定义函数或PHP内置函数进行验证，如：

```php
is_numeric // PHP内置函数
```

### 自定规则

可以在 `config/validate.php` 文件中定义自已的正则验证规则，如： 

```
'username' => '/^\w{4,20}$/', //用户4-20位
'password' => '/^\w{6,12}$/', //密码6-12位
'mobile' => '/^1[3-9]\d{9}$/', //手机号
'qq' => '/^[1-9][0-9]{4,12}$/', //QQ号
'id_card' => '/^(\d{15}$|^\d{18}$|^\d{17}(\d|X|x))$/', //身份证号
'bankcard' => '/^[1-9][0-9]{18}$/', //银行卡号
'money' => '/^\d+\.?\d*$/', //金额
```

###  验证示例 

```php
$rule = [
    ['name', 'required|unique:user.id,name', 'name必须|name已存在', IF_VALUE], // 有值时
    ['pwd', '/^\w{5,12}$/', '密码5~12位', IF_VALUE], // 有值时
    ['mobile', 'mobile', '手机号错误', IF_MUST], // 必须
    ['email', 'email', '邮箱错误', IF_ISSET], // 有字段时
    ['age', fn($val)=>($val>=18 && $val<=60), '年龄18~60'], // 必须
];
$data = ['name'=>'', 'pwd'=>'123', 'mobile'=>'x12323332333', 'age'=>12];
//$data['email'] = 'aaa';
$errors = validate($rule, $data, true)->getError();
dump($errors);
```

---

本文档由 [AphpDoc](https://doc.aphp.top) 生成，更新于：2025-05-04 09:32:31