PHPUnit 中使用严格引用比较模拟方法参数的正确方式

本文介绍如何在 phpunit 测试中对 mock 对象的方法参数进行严格引用（===）比对，避免因对象值相等但实例不同导致误判，并推荐使用 `identicalto()` 等内置约束器替代冗长的自定义回调。

在编写单元测试时，我们常借助 PHPUnit 的 mock 功能验证某个方法是否被以预期参数调用。默认情况下，->with($hosting) 使用的是值相等（==）语义——即只要传入对象与 $hosting 具有相同属性和值（且实现了合理的 __toString() 或可序列化），即使不是同一实例，断言也会通过。这在多数场景下足够，但在涉及实体生命周期、状态变更或唯一性校验（如 Doctrine EntityManager 的 persist()）时，必须确保传入的是原始对象引用本身，否则测试将失去意义。

例如以下代码看似合理，实则存在隐患：

$hosting = new Hosting(); $this->entityManager     ->expects($this->once())     ->method('persist')     ->with($hosting); // ❌ 仅做 == 比较，new Hosting() 也能通过  $this->persister->persist(new Hosting()); // 测试意外通过！

为实现严格的引用一致性（===）校验，你无需手动编写闭包回调。phpUnit 提供了专门的约束器（Constraint），其中 self::identicalTo($expected) 是最简洁、语义最清晰的解决方案：

$this->entityManager     ->expects($this->once())     ->method('persist')     ->with(self::identicalTo($hosting)); // ✅ 严格引用比较，仅当 $parameter === $hosting 时匹配

该约束器底层直接使用 === 运算符，性能高效且意图明确。它属于 PHPUnit 的 PHPUnitFrameworkConstraint 命名空间，可通过 self:: 静态调用（在测试类中）或 PHPUnitFrameworkConstraintIsIdentical::create() 显式构造。

立即学习“PHP免费学习笔记（深入）”；

此外，PHPUnit 还提供其他实用的内置约束器，适用于不同场景：

• self::equalTo($value)：宽松值比较（默认行为，等价于 ==）
• self::isInstanceOf($className)：检查对象类型
• self::isType($type)：检查变量类型（如 ‘string’, ‘Array’）
• self::logicalAnd(…), self::logicalOr(…)：组合多个约束条件

⚠️ 注意事项：

• identicalTo() 对 NULL、true、false 和标量值同样有效，但对浮点数需谨慎（因精度问题，建议优先用 equalTo()）；
• 若需调试匹配失败原因，PHPUnit 会在错误信息中清晰指出“Expected identical Object, got different instance”；
• 不要混淆 identicalTo() 与 equalTo() —— 后者会触发 __toString() 或数组递归比较，前者只认内存地址。

总结：当你需要确保 mock 方法接收的是完全相同的对象实例时，请始终选用 self::identicalTo($object)。它比手写 callback() 更安全、更可读、更符合 PHPUnit 最佳实践，是提升测试可靠性的关键一环。