PHP数据类型校验混乱、重复？phpexperts/datatype-validator助你实现高效、灵活的数据验证

<code class="bash">composer require phpexperts/datatype-validator</code>

<pre class="brush:php;toolbar:false;"><?php

require 'vendor/autoload.php';

use PhpExperts\DataTypeValidator\DataTypeValidator;
use PhpExperts\DataTypeValidator\IsAStrictDataType;
use PhpExperts\DataTypeValidator\IsAFuzzyDataType;

// 严格模式：'1' 不是 int，1 也不是 string
$strictValidator = new DataTypeValidator(new IsAStrictDataType());
var_dump($strictValidator->isType('1', 'int'));    // false
var_dump($strictValidator->isType(1, 'string'));   // false
echo "\n";

// 宽松模式：'1' 可以是 int，1 可以是 string
$fuzzyValidator = new DataTypeValidator(new IsAFuzzyDataType());
var_dump($fuzzyValidator->isType('1', 'int'));     // true
var_dump($fuzzyValidator->isType(1, 'string'));    // true

<pre class="brush:php;toolbar:false;"><?php

require 'vendor/autoload.php';

use PhpExperts\DataTypeValidator\DataTypeValidator;
use PhpExperts\DataTypeValidator\IsAStrictDataType;
use PhpExperts\DataTypeValidator\InvalidDataTypeException;

$validator = new DataTypeValidator(new IsAStrictDataType());

// 使用 isType() 进行条件判断
if ($validator->isType('hello world', 'string')) {
    echo "'hello world' 是字符串。\n";
}

// 使用 assertIsType() 直接断言，不符合则抛出异常
try {
    $validator->assertIsType(123, 'string'); // 这会抛出异常
} catch (InvalidDataTypeException $e) {
    echo "捕获到异常: " . $e->getMessage() . "\n"; // 输出：123 is not a valid string
}

<pre class="brush:php;toolbar:false;"><?php

require 'vendor/autoload.php';

use Carbon\Carbon; // 假设你已经安装了 Carbon 库
use PhpExperts\DataTypeValidator\DataTypeValidator;
use PhpExperts\DataTypeValidator\IsAStrictDataType;
use PhpExperts\DataTypeValidator\InvalidDataTypeException;

$validator = new DataTypeValidator(new IsAStrictDataType());

$userData = [
    'name'     => '张三',
    'age'      => 30,
    'email'    => 'zhangsan@example.com',
    'birthday' => Carbon::parse('1993-01-01'), // Carbon 对象
    'tags'     => ['php', 'composer', 'web'], // 字符串数组
    'isActive' => true,
    'avatar'   => null, // 可空字段，当前为 null
    'createdAt' => Carbon::now(), // 另一个 Carbon 对象
];

$rules = [
    'name'      => 'string',
    'age'       => 'int',
    'email'     => 'string',
    'birthday'  => 'Carbon\Carbon', // 期望是 Carbon\Carbon 类的实例
    'tags'      => 'string[]',      // 期望是字符串数组
    'isActive'  => 'bool',
    'avatar'    => '?string',       // 期望是字符串或 null
    'createdAt' => 'Carbon',        // 也可以使用短类名，如果已 use Carbon
    'address'   => '?string',       // 规则中存在但数据中没有的字段，如果可空则忽略
];

try {
    $validator->validate($userData, $rules);
    echo "用户数据校验成功！\n\n";
} catch (InvalidDataTypeException $e) {
    echo "用户数据校验失败！\n";
    print_r($e->getReasons()); // 打印详细的失败原因
}

// 制造一些校验失败的场景
$invalidUserData = [
    'name'     => '李四',
    'age'      => '二十五', // 错误：age 应该是 int，这里是字符串
    'email'    => 'lisi@example.com',
    'birthday' => '1998-05-10', // 错误：birthday 应该是 Carbon 对象，这里是字符串
    'tags'     => [1, 'java'], // 错误：tags 应该是 string[]，这里包含了 int
    'isActive' => 'yes', // 错误：isActive 应该是 bool
    'avatar'   => 123, // 错误：avatar 应该是 string 或 null
];

echo "--- 尝试校验无效数据 ---\n";
try {
    $validator->validate($invalidUserData, $rules);
} catch (InvalidDataTypeException $e) {
    echo "发现以下校验问题：\n";
    print_r($e->getReasons());
    /*
    输出示例：
    Array
    (
        [0] => age is not a valid int
        [1] => birthday is not a valid Carbon\Carbon
        [2] => tags is not a valid string[]
        [3] => isActive is not a valid bool
        [4] => avatar is not a valid ?string
    )
    */
}