php怎么使用Wave Validation_php如何对输入数据进行链式规则校验-php教程-PHP中文网

wave validation 是某国产低代码平台或项目私有封装的链式校验工具，并非 php 官方或主流开源组件；其核心是通过方法返回 $this 实现链式调用，规则延迟至 validate() 才执行，强调可复用与组合性。

php怎么使用wave validation_php如何对输入数据进行链式规则校验

Wave Validation 是什么，它和 PHP 原生校验有啥区别

Wave Validation 不是 PHP 官方组件，也不是 Composer 上广泛使用的主流库（比如 respect/validation 或 symfony/validator），目前没有稳定、被广泛收录的开源包叫这个名字。搜 Wave Validation，常见结果是某国产低代码平台的私有校验模块，或个别项目内部封装的工具类，没有统一接口规范。

如果你在某份文档、框架文档或同事代码里看到 Wave Validation，大概率是指一个自定义的、支持链式调用的校验器类，类似这样：$v->required()->email()->max(255)。它本身不是语言特性，而是开发者写的封装逻辑。

怎么自己写一个轻量链式校验器（PHP 8.0+）

真要实现链式规则校验，不用依赖未知第三方，几行代码就能搭出可用骨架。核心是让每个校验方法返回 $this，并把错误信息存起来，最后统一判断。

常见错误现象：Fatal error: Uncaught Error: Call to a member function email() on null —— 没有在每个方法末尾写 return $this;；或者忘了初始化错误数组，导致 validate() 返回空却没报错。

校验方法必须返回 $this，否则链式中断
所有规则只做“登记”，不立即执行；validate($data) 才真正跑一遍
注意 isset() 和 empty() 的语义差异：required() 应该检查 array_key_exists() + !is_null()，而不是简单用 empty()
字符串长度用 mb_strlen()，避免中文算成多个字符

class WaveValidator {
    private array $rules = [];
    private array $errors = [];

    public function required(): self {
        $this->rules[] = fn($v) => isset($v) && !is_null($v) ?: '必填';
        return $this;
    }

    public function email(): self {
        $this->rules[] = fn($v) => filter_var($v, FILTER_VALIDATE_EMAIL) ?: '邮箱格式错误';
        return $this;
    }

    public function max(int $len): self {
        $this->rules[] = fn($v) => is_string($v) && mb_strlen($v) errors = [];
        foreach ($this->rules as $rule) {
            $result = $rule($value);
            if ($result !== true) $this->errors[] = $result;
        }
        return empty($this->errors);
    }

    public function getErrors(): array {
        return $this->errors;
    }
}