yiiy/argus

轻量级PHP数据验证器

1.0.0 2024-03-04 22:32 UTC

This package is auto-updated.

Last update: 2024-09-05 12:13:32 UTC


README

Tests Total Downloads License

轻量级PHP数据验证器

Argus是一个PHP包,旨在简化并优化您的应用程序中的数据验证任务。它提供了一套全面的验证规则,以确保数据的完整性和准确性。

特性

  • 常见验证:对必填字段、电子邮件格式、字符串值、数值值和长度限制进行检查。
  • 范围验证:确保数值数据在特定范围内。
  • 定制:轻松定义自定义验证规则以满足您的特定需求。
  • 错误报告:获取清晰且具有信息性的错误消息以识别无效数据点。

安装

您可以使用Composer安装此包

composer require yiiy/argus

用法

该包提供了一个简单直观的API用于数据验证。以下是一个基本示例

<?php

require 'vendor/autoload.php';

use Yi\Argus\Validator;

$data = [
    'name'  => 'John Doe',
    'email' => 'invalid_email',
    'age'   => 30,
];

$rules = [
    'name'  => ['required', 'string', 'length:2:255'],
    'email' => ['required', 'email'],
    'age'   => ['required', 'numeric', 'between:18:120'],
];

$validator = new Validator();
$errors = $validator->validate($data, $rules);

if (empty($errors)) {
    echo 'Data is valid!';
} else {
    echo 'Validation errors:' . PHP_EOL;
    foreach ($errors as $field => $errorMessages) {
        echo "  * $field: " . implode(', ', $errorMessages) . PHP_EOL;
    }
}

支持的验证

  • required 检查字段是否存在且不为空。
  • string 检查字段值是否为字符串。
  • numeric 检查字段值是否为数值。
  • email 检查字段值是否为有效的电子邮件地址。
  • length:min:max 检查字段值长度是否在指定的范围内(min和max是整数)。
  • between:min:max 检查数值字段值是否在指定的范围内(min和max是整数)。

许可证

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