CakePHP中用compare规则校验两字段相等，需设operator为'==='、指定compareField，它动态比对字段值；equalTo仅支持静态值，无法读取另一字段。
用 compare 规则实现两个字段值相等校验
CakePHP 的表单字段比对验证，最直接的方式是使用内置的 compare 验证器，它专为“字段 A 必须等于字段 B”这类需求设计，不需要手写回调或自定义函数。
常见错误是误用 equalTo（它只比对固定字符串）或在 rule 中传入闭包但漏掉 $context 参数导致取不到另一个字段值。
-
compare必须配合operator选项使用，校验相等就设为'=='或'==='（后者更严格，推荐） - 目标字段名通过
compareField指定，比如确认密码要和password字段比，就写'compareField' => 'password' - 该规则默认不处理空值 —— 如果两个字段都为空，
compare默认会通过；如需“都空也报错”，得额外加'allowEmpty' => false到被校验字段上
示例（在 src/Model/Table/UsersTable.php 的 validationDefault 方法中）：
$validator
->requirePresence('password_confirm', 'create')
->notEmptyString('password_confirm')
->add('password_confirm', [
'compare' => [
'rule' => ['compare', '===', 'password'],
'message' => '确认密码与密码不一致',
],
]);
为什么不用 equalTo？
equalTo 是静态值比对器，只接受一个硬编码字符串或数字，不能动态读取另一个字段的值。写成 ['equalTo' => $this->password] 是无效的 —— 验证规则定义阶段 $this 还没绑定到具体请求数据，且验证器不支持这种变量插值。
立即学习“PHP免费学习笔记（深入）”；
典型误用现象：equalTo 校验始终失败，或控制台报 Notice: Undefined property，就是因为试图在规则定义里访问运行时才有的数据。
-
equalTo适合：手机号必须等于'13800138000'这类固定规则 -
compare才适合：两次输入的邮箱、新旧密码、开始结束时间等字段间动态比对 - 如果真要用
equalTo实现动态效果，必须改用闭包规则并手动从$context['data']取值，但这就绕过了内置优化，还容易漏处理null和类型转换
前端提交空字段时 compare 的行为细节
当用户没填任一比对字段（比如 password 和 password_confirm 都为空），compare 默认不会触发 —— 因为它只在被校验字段（这里是 password_confirm）有值时才执行比对逻辑。这常导致“留空跳过校验”的意外放行。
- 解决方法是在字段级加
'allowEmpty' => false，强制非空，再让compare负责“非空前提下的相等性” - 注意
allowEmpty和requirePresence的区别：requirePresence检查键是否存在，allowEmpty检查值是否为空字符串/null/空数组；两者通常一起用 - 如果业务允许某字段为空，但一旦填了就必须和其他字段一致，那就保留
allowEmpty => true，并在compare规则里加'on' => 'create'或自定义条件闭包来控制触发时机
自定义比较逻辑（比如忽略大小写或 trim 后比对）
内置 compare 是严格值比对，不做任何预处理。如果需要“密码确认忽略首尾空格”或“邮箱比对不区分大小写”，就得换用闭包规则，手动取值、清洗、再比较。
- 闭包里必须从
$context['data']读取原始提交数据，而不是$value（那是当前字段值） - 记得显式返回
true或false，返回字符串或null会被当成true - 性能上无明显差异，但代码可读性下降；除非有明确清洗需求，否则优先用
compare
示例（trim 后比对）：
$validator
->add('password_confirm', 'trimCompare', [
'rule' => function ($value, $context) {
$rawPass = $context['data']['password'] ?? '';
return trim($value) === trim($rawPass);
},
'message' => '确认密码与密码不一致（已忽略首尾空格）',
]);
实际项目里，字段清洗最好前置到 Marshaller 或 Form 层，而不是塞进验证规则里做临时处理。
