einlinuus/php-validator

最小化的库,用于验证和转换用户输入

1.0.0 2024-02-24 19:22 UTC

This package is auto-updated.

Last update: 2024-09-24 20:43:36 UTC


README

功能

  • 检查数据类型
  • 检查长度/数量
  • 检查正则表达式
  • 检查数组中的最小/最大条目数
  • 检查数组中的唯一条目
  • 清理字符串(移除空格、缩进等)
  • 检查有效的电子邮件格式
  • 检查有效的URL格式
  • 检查特定的数组形状
  • 自定义验证函数
  • 自定义转换函数

用例

  • 验证用户输入
  • 验证API输入
  • 转换输入(例如将ID转换为对象)

安装

此软件包可以通过composer安装

composer require einlinuus/php-validator

初识composer?

composer是PHP的依赖管理器。composer可以从packagist.org注册表安装此软件包。安装后,您将在项目中找到一个vendor目录。

您可以通过导入由composer创建的autoload.php文件来导入所有必需的文件: require_once __DIR__ . "/vendor/autoload.php"; 将包含自动加载文件的project项目,您现在可以访问此软件包提供的所有类和函数。

用法

简单创建一个Validator类的新实例,并将输入数据传递给构造函数。

接下来,在try-catch块内链式调用验证方法。如果任何验证方法失败,将抛出ValidatorException。

在验证方法之后,您可以通过调用get()方法获取输出数据。输出数据是经过转换方法转换的输入数据。如果没有使用转换方法,输出数据将与输入数据相同。

$input = "hello world";

$v = new Validator($input);
try {
    $v->isString("Input must be a string")
        ->isLowercase("Input must be lowercase")
        ->min(3, "Input must be at least 3 characters long")
        ->max(12, "Input must be at most 10 characters long");
} catch (ValidatorException $e) {
    die("Invalid: " . $e->getMessage());
}

$validated = $v->get();
var_dump($validated); // string(11) "hello world"

您可以在examples文件夹中找到更多示例。