CakePHP验证器将数字0视为空值，因isEmpty()默认对整型0返回true，导致notEmpty()和requirePresence()等规则误判；正确做法是拆解存在性与值合法性校验，结合requirePresence()、自定义rule及类型归一化处理。
CakePHP 验证器把数字 0 当成空值，是因为默认启用了 allowEmpty 的宽松语义。它不区分 0、"0"、null、""，统一按“空”处理——这在表单提交场景下极容易误判，尤其当字段合法值包含 0（如状态码、数量、开关）时。
为什么 notEmpty() 和 requirePresence() 都会吃掉 0
这两个方法底层都依赖 isEmpty() 判定逻辑，而 CakePHP 的 isEmpty() 默认对整型 0 返回 true（兼容 PHP empty() 行为）。这不是 bug，是设计选择，但业务上常需绕过。
-
notEmpty('status')→ 传['status' => 0]会直接报错“status 不能为空” -
requirePresence('status')→ 同样失败，因为它只检查键是否存在，不校验值；但后续若叠加allowEmpty(false)，仍会触发isEmpty(0) === true - 即使写
add('status', 'notZero', ['rule' => function ($value) { return $value !== 0; }])，也得先确保验证流程走到这一步——而notEmpty已提前中断了
正确做法：用 requirePresence() + notEmptyString() 或自定义 rule
想让 0 被接受，又拒绝 null、""、"0" 等非法空值，必须拆解“存在性”和“值合法性”两层校验：
- 先用
requirePresence('status')确保字段被提交（避免前端漏传） - 再用
add('status', 'isInt', ['rule' => 'naturalNumber'])或更准的add('status', 'isZeroOrPositive', ['rule' => function ($value) { return is_int($value) && $value >= 0; }]) - 如果字段可能来自表单（即字符串），别信
$_POST['status']是 int，先做类型归一：->add('status', 'toInt', ['rule' => function ($value) { return filter_var($value, FILTER_VALIDATE_INT) !== false; }]) - 避免混用
allowEmpty(true)—— 它会让整个字段跳过所有后续规则，包括你刚写的自定义判断
模型层验证中 $validate 数组的坑
老式数组写法（如 'status' => 'numeric'）同样受 isEmpty() 影响。CakePHP 2.x/3.x 中，numeric 规则内部会先调 isEmpty()，所以 0 直接被拦。
立即学习“PHP免费学习笔记（深入）”；
- 改用显式 rule 数组：
'status' => ['rule' => 'naturalNumber', 'allowEmpty' => false]（naturalNumber接受 0 和正整数） - 或彻底放弃内置 rule，写闭包：
'status' => ['rule' => function ($value) { return is_int($value) || (is_string($value) && ctype_digit($value)); }, 'message' => '状态必须为非负整数'] - 注意：在
validationDefault()方法里返回的规则数组，若含'allowEmpty' => true，哪怕只写一次，整个字段验证链就断了
最易忽略的一点：请求数据来源决定值类型
你看到的 0 很可能根本不是 int。表单提交的 <input name="status" value="0"> 到达控制器时是字符串 "0"，JSON 请求体里的 {"status": 0} 经 $this->request->getData() 解析后才是 int —— 但前提是你的 JSON 解析配置没关掉 convertKeysToCamelCase 等干扰项。
- 调试时加一句：
debug(gettype($this->request->getData('status')));，确认真实类型 - 不要在验证前用
(int)强转，它会把"abc"变成0，造成假合法 - 推荐用
filter_var($value, FILTER_VALIDATE_INT, ['options' => ['min_range' => 0]])，它只对合法非负整数返回 int，其余一律 false
