🧪 Form Test · Validate 类优化 3 表单集中联测页

覆盖：全字段类型（text/number/email/tel/radio/checkbox/select/textarea/file） · 验证器写法 A/B/C 零破坏 · 新增 file_upload 统一验证器必填/选填 · 三层 params 回退优先级

当前环境信息：

当前页面 ID（post_exists 验证源）：488
AJAX URL / Action 名 / Nonce：由插件统一注入 window.hzt_form（L17-19 注释：模板不得自定义兜底）
前端提交入口：HztForms.submit(formDOM, opt) / 预热：HztForms.prefetch()（唯一 API）
主题钩子文件：inc/hzt-theme-hooks.php（已注册 3 个测试表单：test_all_fields / test_new_file_upload / test_three_layer_priority）

表单 A test_all_fields · 全字段类型 + 验证器写法 A/B/C

覆盖全部前台 HTML 控件类型 + 老验证器 3 种写法零破坏联测。

写法A（完整callback数组）：A-姓名（not_empty + params=1 + msg）
写法B（纯字符串别名）：A-邮箱（not_empty + is_email）
写法C（callback字符串+自定义params/msg）：A-年龄（ctype_digit 整数校验）
文件字段：A-头像（老3个独立文件验证器链路：not_empty → type → size，完全不传 params，走三层回退兜底 = ≤2MB JPG/PNG/PDF）

A-姓名 (text · 写法A)* 写法A：完整 [callback,params,msg] 数组，not_empty 单参数旧链路

A-邮箱 (email · 写法B)* 写法B：纯字符串别名（not_empty / is_email），单参数旧链路

A-年龄 (number · 写法C · 整数)* 写法C：callback='ctype_digit' + params=1 + msg

A-手机号 (tel · is_phone)* is_phone 内建验证器

A-性别 (radio 单选)*

男女其他

A-爱好 (checkbox 多选 · 至少1个)* 值将以逗号 implode 存储（后端 string 类型）

阅读音乐运动编程旅行

A-城市 (select 单选)*

A-技能 (select 多选 · 至少1个)* 按住 Ctrl/Cmd 多选，后端以逗号分隔存储

A-留言 (textarea)* sanitize_textarea_field 多行文本专用消毒

A-头像文件 (file · 老3验证器链路)* 老3独立验证器：check_file_not_empty → check_file_type → check_file_size（完全不传 params → 兜底=≤2MB JPG/PNG/PDF）

A-证件照片 (多file · 1~3张 · 单张≤2MB JPG/PNG/PDF)* 多文件字段：PHP name 末尾必须写 []；后端 max_files=3 拦截超过的；内容 md5 按上传顺序预计算，同 N 个文件同顺序提交会被 5 分钟窗口去重命中

（等待提交...）

💡 对照测试：① 全部留空提交 → 应返回多个"不能为空"（stopOnError=false 一次返回所有错误）；② 正确填完 + 合法 JPG/PNG/PDF ≤2MB → 成功 JSON。

表单 B test_new_file_upload · 新增 file_upload 统一验证器（必填/选填/严格）

集中测试新增的 file_upload BUILTIN 别名（反射多参数新链路，validate_file_upload($file, $config)）。

B-简历：必填 + 默认参数（≤2MB，JPG/PNG/PDF）→ 等同于老 3 验证器兜底行为
B-封面图：选填（required=false）→ 不传文件 直接通过；传了就要求 ≤1MB 且 JPG/PNG
B-报告：严格参数（≤512KB 且仅 PDF）

B-公司名 (text · 非必填 · 仅消毒) validators 为空数组，允许空值通过

B-简历 (必填 · 默认 ≤2MB JPG/PNG/PDF)* file_upload: required=true，其余 null → 过滤器/兜底

B-封面图 (选填 · 不传直接过 · 传则≤1MB JPG/PNG) file_upload: required=false + max_size=1MB + MIME=JPG/PNG

B-报告 (必填 · 严格仅PDF ≤512KB)* file_upload: required=true + max_size=524288 + MIME=application/pdf

（等待提交...）

💡 对照测试：① 不传 B-简历 + 不传 B-封面图 + 传 B-报告合法512KB内 PDF → 简历会报必填错；② B-简历合法 + 完全不传 B-封面图 + B-报告合法 → 应该全部通过（验证 required=false 生效）；③ 传 JPG 到 B-报告 → 报 "报告须为 PDF 格式且 ≤ 512KB"。

表单 C test_three_layer_priority · 两层 params_config 回退优先级对照（已废弃全局过滤器）

对照测试 check_file_size / check_file_type 的【两层参数回退模型】： 优先级1（单字段 params_config 显式声明） > 优先级2（插件内置统一默认值=≤2MB / JPG+PNG+PDF）。
【2026-08-10 架构调整 · 安全红线】：apply_filters('hzt_validate_default_max_filesize/mimes') 全局过滤器已彻底废弃 （消除"其他插件/被黑代码隐式改动全站默认上传限制"的结构性安全面，避免全局跨表单隐式污染）。如需整站统一限制，请在主题侧封装 my_file_defaults(required) helper 函数显式传 P1 params_config，不要依赖全局钩子——显式配置可 Grep 追溯、可移植、不会被第三方静默覆盖。

C-size 优先级1：params_config = 65536（64KB）→ 超过 64KB 一定拦截（优先级1最高，覆盖内置 2MB 默认）
C-type 优先级1：params_config = ['image/gif'] → 除 GIF 外全部拦截
C-size+type 兜底：完全不传 params_config → 行为=插件内置统一默认值 2MB / JPG+PNG+PDF（两层模型对照组，无任何全局钩子能修改）

C-测试场景备注 (text · 非必填) 如 "优先级1-64KB 兜底2MB"，方便后台记录对照

C-size 优先级1 (≤64KB · 自定义 params_config)* check_file_size params_config=65536（优先级1，覆盖内置默认 2MB）。100KB+文件一定超

C-type 优先级1 (仅 GIF · 自定义 params_config)* check_file_type params_config=['image/gif']（优先级1，覆盖内置默认 JPG/PNG/PDF）。JPG/PNG 上传一定报类型错

C-size+type 兜底 (≤2MB · JPG/PNG/PDF · 内置默认)* 完全不传 params_config → 直接走插件内置统一默认值，无任何全局钩子可修改

（等待提交...）

💡 对照测试（两层模型，无任何全局钩子影响）：① 准备 3 个文件：100KB JPG、100KB GIF、3MB PDF；② 第一次：C-size=100KB JPG + C-type=100KB GIF + C-fallback=500KB JPG → 预期 C-size 报 "超过64KB（优先级1 params_config 生效）"，其余通过；③ 把 C-type 换成 JPG 再提交 → 预期报 "只允许 GIF 图片（优先级1 params_config 生效）"；④ 把 C-fallback 传 3MB PDF 再提交 → 预期同时报大小超 + 类型错（兜底=2MB/JPG+PNG+PDF，PDF 类型对但大小超，所以只报大小超；传 1.5MB ZIP → 才报类型错），验证兜底限制真实=2MB/JPG+PNG+PDF 且不可被外部钩子修改。