PHPackages                             aqqwiwng/php-form-validator - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Validation & Sanitization](/categories/validation)
4. /
5. aqqwiwng/php-form-validator

ActiveLibrary[Validation & Sanitization](/categories/validation)

aqqwiwng/php-form-validator
===========================

PHP表单验证器

v3.0.3(1mo ago)124Apache-2.0PHPPHP >=8.0.0

Since Jul 16Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/aqqwiwng/php-form-validator)[ Packagist](https://packagist.org/packages/aqqwiwng/php-form-validator)[ Docs](https://github.com/aqqwiwng/php-form-validator)[ RSS](/packages/aqqwiwng-php-form-validator/feed)WikiDiscussions master Synced today

READMEChangelog (6)DependenciesVersions (8)Used By (0)

PHP 表单验证器
=========

[](#php-表单验证器)

一个功能强大、灵活易用的 PHP 表单验证库，支持多种验证规则、多语言错误消息和场景验证。

功能特性
----

[](#功能特性)

- ✅ **多种验证规则**：必填、类型检查、正则表达式、范围验证、枚举、确认验证等
- ✅ **多语言支持**：内置中文（zh\_CN）和英文（en\_US）错误消息
- ✅ **场景验证**：不同场景使用不同的验证规则
- ✅ **批量验证**：收集所有字段的错误信息
- ✅ **自定义验证**：支持自定义验证函数和闭包
- ✅ **链式调用**：流畅的 API 设计
- ✅ **轻量无依赖**：仅依赖 PHP 内置扩展

环境要求
----

[](#环境要求)

- PHP 8.0+
- ext-json
- ext-intl

安装
--

[](#安装)

### Composer 安装

[](#composer-安装)

```
composer require aqqwiwng/php-form-validator
```

### 手动安装

[](#手动安装)

1. 下载源码并复制 `src` 目录到项目
2. 引入 `vendor/autoload.php` 或直接加载类文件

快速开始
----

[](#快速开始)

```
require_once 'vendor/autoload.php';

use Validator\Validator;

$validator = new Validator();

$validator->setRules([
    'username' => [
        'label' => '用户名',
        'rules' => [
            'required' => true,
            'type' => 'string',
            'regex' => '/^[a-zA-Z][a-zA-Z0-9_]{5,19}$/'
        ]
    ],
    'email' => [
        'label' => '邮箱',
        'rules' => [
            'required' => true,
            'type' => 'email'
        ]
    ],
    'password' => [
        'label' => '密码',
        'rules' => [
            'required' => true,
            'type' => 'strong_pwd'
        ]
    ]
]);

$data = [
    'username' => 'test_user123',
    'email' => 'test@example.com',
    'password' => 'Test@123456'
];

$validator->failException(false);
if (!$validator->check($data)) {
    echo $validator->getError();
} else {
    echo '验证通过';
}
```

验证规则
----

[](#验证规则)

### 规则配置结构

[](#规则配置结构)

```
$validator->setRules([
    '字段名' => [
        'label' => '显示名称',
        'rules' => [
            '规则名称' => 规则值,
            // ... 更多规则
        ]
    ]
]);
```

### 必填验证 (required)

[](#必填验证-required)

```
'username' => [
    'label' => '用户名',
    'rules' => [
        'required' => true
    ]
]
```

### 类型验证 (type)

[](#类型验证-type)

支持以下类型：

类型说明示例`string`字符串`'test'``int`整数`123``number`数字`123`, `1.5``float`浮点数`1.5``bool`布尔值`true`, `false``array`数组`['a', 'b']``object`对象`(object)['a'=>1]``email`电子邮箱`test@example.com``mobile`手机号`13800138000``url`网址`https://example.com``date`日期`2024-01-01``timestamp`时间戳`1704067200``id_card`身份证号`110101199001011234``chinese`中文`中文内容``pwd`密码（6-18位，不能全为字母、数字或特殊字符）`Test@123``weak_pwd`弱密码（6-18位字母、数字或特殊字符）`weak123``strong_pwd`强密码（至少8位，含大小写字母、数字和特殊字符）`Test@123456````
'email' => [
    'label' => '邮箱',
    'rules' => [
        'type' => 'email'
    ]
],
'phone' => [
    'label' => '手机号',
    'rules' => [
        'type' => 'mobile'
    ]
]
```

### 正则验证 (regex)

[](#正则验证-regex)

```
'username' => [
    'label' => '用户名',
    'rules' => [
        'regex' => '/^[a-zA-Z][a-zA-Z0-9_]{5,19}$/'
    ]
]
```

### 枚举验证 (enum)

[](#枚举验证-enum)

```
'status' => [
    'label' => '状态',
    'rules' => [
        'enum' => ['pending', 'approved', 'rejected']
    ]
]
```

### 范围验证 (min/max/between)

[](#范围验证-minmaxbetween)

```
'age' => [
    'label' => '年龄',
    'rules' => [
        'min' => 18,
        'max' => 100
    ]
]

'quantity' => [
    'label' => '数量',
    'rules' => [
        'between' => ['min' => 1, 'max' => 100]  // 或分开写 min 和 max
    ]
]
```

### 确认验证 (confirm)

[](#确认验证-confirm)

用于确认密码等场景：

```
'password' => [
    'label' => '密码',
    'rules' => [
        'required' => true,
        'type' => 'strong_pwd'
    ]
],
'confirm_password' => [
    'label' => '确认密码',
    'rules' => [
        'required' => true,
        'confirm' => 'password'  // 指定要确认的字段名
    ]
]
```

### 自定义验证函数 (validateFunction)

[](#自定义验证函数-validatefunction)

```
$validator->setRules([
    'age' => [
        'label' => '年龄',
        'rules' => [
            'required' => true,
            'validateFunction' => function($rule, $value, $data) {
                if ($value < 18 || $value > 100) {
                    return '年龄必须在18-100岁之间';
                }
                return true;
            }
        ]
    ]
]);

// 或使用方法名
class CustomValidator extends Validator {
    protected function validateAge(array $rule, mixed $value, mixed $data): ?string {
        if ($value < 18 || $value > 100) {
            return $rule['label'] . '必须在18-100岁之间';
        }
        return null;
    }
}
```

API 参考
------

[](#api-参考)

### 链式调用方法

[](#链式调用方法)

方法说明示例`setRules($rules)`设置验证规则`->setRules([...])``setScenes($scenes)`设置场景配置`->setScenes([...])``scene($name)`选择验证场景`->scene('login')``batch($enable)`启用/禁用批量验证`->batch(true)``failException($enable)`设置是否抛出异常`->failException(false)``setLang($lang)`设置语言`->setLang('en_US')`### 验证方法

[](#验证方法)

方法说明`check($data)`执行验证，返回 bool`getError()`获取错误信息### 高级方法

[](#高级方法)

方法说明`only($fields)`仅验证指定字段`append($field, $rule)`添加字段规则`remove($field, $ruleName)`删除字段规则使用示例
----

[](#使用示例)

### 基本验证

[](#基本验证)

```
$validator = new Validator();
$validator->setRules([
    'username' => [
        'label' => '用户名',
        'rules' => [
            'required' => true,
            'type' => 'string',
            'regex' => '/^[a-zA-Z]\w{5,19}$/'
        ]
    ],
    'email' => [
        'label' => '邮箱',
        'rules' => [
            'required' => true,
            'type' => 'email'
        ]
    ]
]);

try {
    $validator->check($data);
    echo '验证通过';
} catch (ValidateException $e) {
    echo '验证失败：' . $e->getMessage();
}
```

### 批量验证

[](#批量验证)

```
$validator->batch(true)->failException(false);
$result = $validator->check($data);

if (!$result) {
    $errors = $validator->getError();
    foreach ($errors as $field => $error) {
        echo "$field: $error\n";
    }
}
```

### 场景验证

[](#场景验证)

```
$validator->setRules([
    'username' => ['label' => '用户名', 'rules' => ['required' => true]],
    'password' => ['label' => '密码', 'rules' => ['required' => true, 'type' => 'pwd']],
    'email' => ['label' => '邮箱', 'rules' => ['required' => true, 'type' => 'email']]
]);

$validator->setScenes([
    'login' => ['username', 'password'],
    'register' => ['username', 'password', 'email']
]);

// 登录场景
$validator->scene('login');
$validator->check($loginData);

// 注册场景
$validator->scene('register');
$validator->check($registerData);
```

### 自定义验证器,包含函数定义验证场景，自定义验证函数

[](#自定义验证器包含函数定义验证场景自定义验证函数)

```