PHP filter_var 回调过滤器怎么传入额外选项

先给结论：filter_var() 使用 FILTER_CALLBACK 时，第三个参数不是“给回调传多个参数”的位置，而是一个配置容器；真正的回调必须放在 ['options' => $callable] 中。需要额外规则时，用闭包的 use 捕获配置，或用带属性的可调用对象保存配置，最后仍由回调接收一个被过滤值。

官方参考：https://www.php.net/manual/en/function.filter-var.php　https://www.php.net/manual/en/filter.constants.callback.php

问题现场：回调需要规则，但 filter_var 只给一个值

例如，项目想过滤一个用户名：必须去掉首尾空格、加统一前缀，还要拒绝过短的值。很多人会尝试把多个参数直接写进 options，结果得到“无效 callback”或回调根本没有拿到配置。

原因在于 filter_var($value, $filter, $options) 的第三参数属于过滤器 API。对于 FILTER_CALLBACK，它需要的是一个名为 options 的字段，字段值再被当作 callable 调用。回调的输入只有当前值，额外规则要在 callable 外层准备好。

正确传法：用闭包捕获额外选项

闭包最适合一次请求或一次批处理中的固定规则。先准备业务配置，再用 use 捕获它们；回调内部只处理一个字符串，并返回清洗后的值或 null。

 $callback,
]);

var_dump($result); // string(10) "usr_alice7"
?>

这里的“额外选项”是 $prefix 和 $minLength，它们不需要出现在 filter_var() 的参数列表里。若回调返回 null，调用方就能把它作为业务校验失败处理；若返回字符串，过滤结果就是该字符串。

规则要复用：用工厂或可调用对象保存配置

如果同一套规则会被多个字段或多个请求重复使用，可以把配置封装起来。工厂函数返回闭包，调用方不需要知道闭包捕获了哪些变量；可调用对象则更适合规则较多、需要独立测试的场景。

 $filter]);
var_dump($result); // string(13) "member_tom007"
?>

不要写成 ['options' => ['makeUserFilter', 'member_', 6]]。PHP 的 callable 数组通常只能表达对象与方法、类与静态方法等形式，不能把任意多个业务实参附在后面。需要对象风格时，可实现 __invoke(string $value): ?string，再把对象本身作为 options 的值。

排查第三参数：先分清 callback、flags 和返回值

官方手册还特别说明：自定义过滤器的回调签名接收一个字符串值，回调返回值会原样成为过滤结果。若需要过滤数组，应先确认结构化 flags 与当前 PHP 版本的行为；不要把数组配置和 callback 混在同一个层级里。

常见问题

能不能让 FILTER_CALLBACK 直接接收两个参数？

不能依赖这种调用方式。把额外数据放进闭包的 use、对象属性或工厂函数中，让回调保持一个输入参数。

回调返回 false 时会自动变成 null 吗？

不会把自定义回调的返回值自动改写成另一种失败值。需要区分失败原因时，建议约定返回 null，或在回调外捕获异常并记录上下文。

什么时候应该不用 filter_var？

当规则需要多个输入字段、依赖外部服务或要返回丰富错误信息时，直接调用领域校验器通常更清晰；FILTER_CALLBACK 更适合单值、轻量、可组合的清洗或校验。

记住这一层关系就不容易写错：filter_var() 的第三参数负责描述过滤器配置，FILTER_CALLBACK 的 options 负责承载一个 callable，而额外业务选项由 callable 自己捕获或持有。