Respect\Validation 技术文档

1. 安装指南

使用 Composer 安装

Respect\Validation 可以通过 Composer 进行安装。首先，确保你已经安装了 Composer。然后在终端中运行以下命令：

composer require respect/validation

安装完成后，你可以在项目中使用 Respect\Validation 进行数据验证。

2. 项目的使用说明

基本使用

Respect\Validation 提供了简单且强大的验证规则。你可以使用链式调用来创建复杂的验证规则。例如：

use Respect\Validation\Validator as v;

$input = 150;

$isValid = v::numericVal()->positive()->between(1, 255)->validate($input);

if ($isValid) {
    echo "输入有效";
} else {
    echo "输入无效";
}

验证方法

Respect\Validation 提供了多种验证方法，包括 validate()、assert() 和 check()。这些方法的区别在于它们如何处理验证失败的情况：

• validate()：返回布尔值，表示验证是否成功。
• assert()：在验证失败时抛出异常。
• check()：在验证失败时抛出异常，但只抛出第一个错误。

粒度控制

Respect\Validation 允许你控制验证的粒度。你可以使用 group() 方法来获取所有验证错误，或者使用 firstError() 方法来获取第一个错误。

try {
    v::numericVal()->positive()->between(1, 255)->assert($input);
} catch (Respect\Validation\Exceptions\ValidationException $e) {
    echo $e->getFullMessage();
}

3. 项目API使用文档

常用API

• v::numericVal()：验证输入是否为数值。
• v::positive()：验证输入是否为正数。
• v::between($min, $max)：验证输入是否在指定范围内。
• v::email()：验证输入是否为有效的电子邮件地址。
• v::length($min, $max)：验证输入字符串的长度是否在指定范围内。

自定义规则

你可以通过继承 Respect\Validation\Rules\AbstractRule 来创建自定义验证规则。例如：

use Respect\Validation\Rules\AbstractRule;

class MyCustomRule extends AbstractRule
{
    public function validate($input)
    {
        return $input === 'custom';
    }
}

$validator = new MyCustomRule();
$isValid = $validator->validate('custom');

4. 项目安装方式

Respect\Validation 的安装方式非常简单，只需通过 Composer 进行安装即可。具体步骤如下：

1. 打开终端或命令行工具。

2. 运行以下命令：

   composer require respect/validation
   

3. 安装完成后，你可以在项目中使用 Respect\Validation 进行数据验证。

通过以上步骤，你可以轻松地将 Respect\Validation 集成到你的 PHP 项目中，并开始使用其强大的验证功能。