构建一个简洁优雅的 PHP 参数验证器 —— php-schema-validator

在日常开发中,参数校验是绕不过的一道坎。我们常常需要确保用户传入的数据符合预期格式,比如必填字段、数据类型、最大长度、邮箱格式等等。虽然许多 PHP 框架都内置了验证器,但在开发轻量服务、非框架项目,或需要在业务中后端进行结构化数据校验时,我总觉得现有方案不够灵活、冗余较多。

于是,我动手写了一个开箱即用、易扩展、轻量级的参数验证器:php-schema-validator


为什么要造这个轮子?

虽然 PHP 社区有很多验证类库(如 Laravel 的 Validator、Respect\Validation、Opis JSON Schema 等),但它们往往:

  • 要么依赖框架,不方便独立使用;
  • 要么语法冗长,无法用简洁的规则表达复杂校验;
  • 要么扩展性差,自定义规则成本高。

我想要一个东西,既能用类似 JSON Schema 的方式表达规则,又能非常容易地扩展,同时尽量保持核心代码简洁明了。

于是这个项目诞生了。


核心设计理念

这个库的核心目标可以总结为三句话:

  1. 规则驱动 ------ 用数组描述你的字段规则,声明式更直观;
  2. 可扩展 ------ 每一个验证规则都是独立的类,插件化设计;
  3. 无依赖 ------ 不依赖框架,适用于任意 PHP 项目。

安装方式很简单:

bash 复制代码
composer require hejunjie/schema-validator

一个简单示例:

php 复制代码
use Hejunjie\SchemaValidator\Validator;
use Hejunjie\SchemaValidator\Exceptions\ValidationException;

$data = [
    'name'   => '张三',
    'age'    => 28,
    'email'  => 'invalid-email',
];

// 自定义扩展,返回 true 则规则通过,否则均视为不通过
Validator::extend('is_zh', function ($field, $value, $params = null) {
    if (preg_match('/^[\x{4e00}-\x{9fa5}]+$/u', $value)) {
        return true;
    }
});

try {
    Validator::validate($data, [
        'name'  => ['is_zh', 'string', 'minLength:2'],
        'age'   => ['integer', 'between:18,60'],
        'email' => ['required', 'email'],
    ]);
    echo "验证通过 ✅";
} catch (ValidationException $e) {
    echo "验证失败 ❌" . PHP_EOL;
    print_r($e->getErrors());  // 友好打印错误信息
}

输出类似:

csharp 复制代码
验证失败 ❌
Array
(
    [email] => Array
        (
            [0] => email
        )

)

支持的验证规则

目前内置了这些基础规则(并持续扩展中):

  • 类型类 :支持 string / integer / boolean / array / object / float / numeric
  • 比较类 :支持 min / max / between / length / min_length / max_length / gt / lt / gte / lte
  • 格式类 :支持 email / mobile / url / ip / json / alpha / alpha_num / alpha_dash
  • 布尔类 :支持 required / accepted / declined
  • 自定义类 :支持 starts_with / ends_with / contains

如何扩展一个自定义规则?

比如我想加一个 is_zh(只允许输入中文)规则:

php 复制代码
use Hejunjie\SchemaValidator\Validator;

// 在调用 Validator::validate 之前
Validator::extend('is_zh', function ($field, $value, $params = null) {
    if (preg_match('/^[\x{4e00}-\x{9fa5}]+$/u', $value)) {
        return true;
    }
});

然后就可以直接使用:

php 复制代码
use Hejunjie\SchemaValidator\Validator;
use Hejunjie\SchemaValidator\Exceptions\ValidationException;

try {
    Validator::validate($data, [
        'name'  => ['is_zh'],
    ]);
	// 验证成功
} catch (ValidationException $e) {
	// 验证失败
}

如果有常用自定义规则,建议在代码中封装 Validator::validate 方法,在调用 validate 之前通过 extend 方法注册自定义规则
在常驻内存的项目中,建议在项目运行初始化时全局注册,以减小性能开销


项目地址 & 使用方式

GitHub 仓库地址:

🔗 github.com/zxc7563598/...

欢迎 Star、提 Issue、提 PR!


下一步计划

我还在考虑以下几点:

  • 错误信息多语言支持
  • Laravel / Webman / Hyperf 插件适配
  • 添加更多内置规则(银行卡号、身份证号、UUID 等)
  • 将 schema 校验支持 YAML / JSON 文件描述

最后

这是一个"造轮子"项目,但也是一个"实践设计"的项目。如果你也曾因为参数验证的重复劳动而烦恼,不妨来试试这个轻量、可扩展的验证器。

如果这个库对你有帮助,欢迎 Star、提建议或一起共建 🚀

相关推荐
我是不会赢的16 分钟前
使用 decimal 包解决 go float 浮点数运算失真
开发语言·后端·golang·浮点数
yuqifang32 分钟前
写一个简单的Java示例
java·后端
Re27533 分钟前
分库分表后主键总“撞车”?5种全局唯一ID方案让你不再头疼
后端
陈随易1 小时前
VSCode v1.103发布,AI编程任务列表,可用GPT 5和Claude 4.1
前端·后端·程序员
中等生1 小时前
Python的隐形枷锁:GIL如何"绑架"了你的多线程梦想
后端·python
电商数据girl1 小时前
关于私域电商网站,接入电商API数据接口示例
运维·开发语言·网络·python·json·php
Pitayafruit1 小时前
【📕分布式锁通关指南 12】源码剖析redisson如何利用Redis数据结构实现Semaphore和CountDownLatch
redis·分布式·后端
哈基米喜欢哈哈哈2 小时前
Netty入门(二)——网络传输
java·开发语言·网络·后端