flysquare/php-input-validation

一个轻量级的PHP库,用于简单有效的数据验证。

v1.0.0 2024-09-16 18:36 UTC

This package is auto-updated.

Last update: 2024-09-16 18:42:48 UTC


README

这是一个简单的PHP库,根据预定义的规则验证用户输入。它支持多种验证方法,例如必填字段、字符串长度、匹配字段、电子邮件格式、数值、以及其他许多。

安装

您可以通过 Composer 安装此库。

通过Composer安装

composer require flysquare/php-input-validation

手动安装

  1. 克隆此仓库或下载 Validator.php 文件。
  2. 在您的项目中包含 Validator.php 文件。
require_once 'Validator.php';

使用

初始设置

通过传递规则和要验证的数据来创建 Validator 类的实例

use PHPInputValidation\Validator;

$rules = [
    'name' => 'required|min:3|max:20',
    'email' => 'required|email',
    'password' => 'required|min:6',
    'confirm_password' => 'same:password'
];

$data = [
    'name' => 'John Doe',
    'email' => 'john@example.com',
    'password' => 'password123',
    'confirm_password' => 'password123'
];

$validator = new Validator($rules, $data);
if ($validator->validate()) {
    // Validation passed
} else {
    // Validation failed
    print_r($validator->errors());
}

支持的验证规则

  • required: 字段不能为空。
  • min:n: 字段必须至少有 n 个字符。
  • max:n: 字段最多只能有 n 个字符。
  • same:field: 字段必须匹配给定的 field
  • email: 字段必须是一个有效的电子邮件地址。
  • url: 字段必须是一个有效的URL。
  • numeric: 字段必须是数值。
  • integer: 字段必须是一个整数。
  • between:min,max: 字段必须在给定的最小值和最大值之间。
  • alpha_num: 字段必须是字母数字。
  • starts_with:value: 字段必须以给定的值开头。
  • ends_with:value: 字段必须以给定的值结尾。
  • distinct: 字段必须包含不同的值(对于数组)。
  • json: 字段必须是一个有效的JSON字符串。

错误处理

errors() 方法返回一个包含验证错误的数组

$errors = $validator->errors();
print_r($errors);

每个字段的错误将存储在错误数组中对应的字段名下。

许可证

本项目采用MIT许可证。有关详细信息,请参阅LICENSE文件。