InputFilter 必须显式调用 setData() 注入数据才能验证，否则 isValid() 恒返回 true；嵌套结构需用子 InputFilter 实现，不支持点号路径；错误消息需在 isValid() 为 false 后立即调用 getMessages() 获取。
InputFilter 构造时必须显式绑定数据，否则验证永远返回 true
很多人调用 isValid() 却发现不报错、不拦截非法数据，根本原因是没传入待验证的原始数据。Laminas 的 InputFilter 不会自动读取 $_POST 或请求体，它完全被动——你给什么，它验什么。
常见错误现象：isValid() 返回 true，哪怕传的是空数组或 null；字段定义了 Required = true，但没传值也不报错。
- 必须在调用
isValid()前，用setData($data)显式注入数据（$data应是普通 PHP 数组） - 如果表单嵌套深（比如
user[profile][email]），需提前用laminas-filter或自定义逻辑展平为关联数组，InputFilter 本身不解析点号或方括号语法 - 不要在构造后反复复用同一个
InputFilter实例验证不同数据——setData()会覆盖内部状态，但错误信息不会自动清空，建议每次新建实例或手动调用clearMessages()
嵌套结构得靠 InputFilterInterface 子类，不能只靠 add() 加字段
想验证类似 ['address' => ['street' => 'xx', 'city' => 'yy']] 这种二维结构，直接对主 filter 调用 add() 加 address.street 是无效的——InputFilter 不支持“点号路径”字段名，它只认一级键名。
正确做法是把 address 定义成一个独立的 InputFilter 类（实现 InputFilterInterface），再作为子 filter 挂载进去。
立即学习“PHP免费学习笔记（深入）”；
- 子 filter 必须实现
InputFilterInterface，通常继承Laminas\InputFilter\InputFilter - 主 filter 中用
add($subFilter, 'address')，第二个参数是数组键名，不是字段路径 - 验证时，主 filter 的
setData(['address' => [...]])会自动把address子数组交给子 filter 处理 - 错误消息默认扁平化到顶层，如
address.street字段出错，getMessages()返回的 key 是address.street，但这是靠命名约定拼出来的，不是自动解析的
required=false + allow_empty=true 组合容易误判空字符串
当字段允许为空但又不能是纯空白时，仅设 required => false 不够——它会让空字符串、null、'' 全部跳过验证，连 trim 都不执行。
典型场景：用户可不填“公司名称”，但如果填了，就不能只输空格。
-
required => false表示字段可缺失（key 不存在），不控制值内容 -
allow_empty => true表示字段存在时，接受''、null、[]等空值，且跳过后续所有过滤器和验证器 - 真正需要的是：
required => false+ 自定义验证器（如NotEmpty+StringLength::MIN），或用filters先StripTags再StringTrim，再配NotEmpty - 注意
NotEmpty默认把' '当非空——必须配合StringTrim过滤器才能正确识别“只有空格”为无效
validate() 返回 bool，但 getMessages() 必须在之后立刻取
isValid() 内部会调用 validate()，但它的返回值只是总开关；具体哪条规则失败、为什么失败，全靠 getMessages()。而这个方法有状态依赖——它只返回上一次 isValid() 或 validate() 的结果。
常见坑：先调 isValid()，中间插入日志、数据库操作或异常处理，再调 getMessages()，结果返回空数组。
- 务必在
isValid()返回false后**立即**调用getMessages() - 返回结构是嵌套数组：
['field_name' => ['validator_name' => 'error_message']]，不是扁平列表 - 若需统一格式（如转成 JSON API 错误），别直接遍历
getMessages()，先用getInvalidInput()拿到触发失败的具体输入项，再结合getMessages()定位上下文 - 子 filter 的错误消息不会自动合并到父级，需手动递归提取——
getMessages()只返回当前 filter 层级的错误
address.city 的报错自动挂到前端对应 DOM 节点上，这部分得自己桥接。 
