PHPUnit 新增 assertObjectNotEquals 方法解析

背景介绍

PHPUnit 作为 PHP 生态中最流行的单元测试框架，一直在不断完善其断言方法库。在之前的版本中，PHPUnit 已经提供了 assertObjectEquals() 方法用于比较两个对象的相等性，这在测试值对象(Value Objects)时非常有用。

方法功能

assertObjectNotEquals() 是 assertObjectEquals() 的逆方法，用于验证两个对象不相等。它的实现逻辑很简单：

public static function assertObjectNotEquals(object $expected, object $actual, string $method = 'equals', string $message = ''): void
{
    self::assertThat(
        $actual,
        self::logicalNot(self::objectEquals($expected, $method)),
        $message,
    );
}

工作原理

该方法与 assertObjectEquals() 共享相同的验证机制：

1. 检查 $actual 对象上是否存在名为 $method 的方法
2. 验证该方法必须接受且仅接受一个参数
3. 该参数必须有明确的类型声明
4. $expected 对象必须与该参数类型兼容
5. 方法必须有明确的 bool 返回类型声明

如果以上任何条件不满足，或者 $actual->$method($expected) 返回 false，则断言失败。

使用场景

这个方法特别适合以下场景：

1. 测试值对象的非等同性：当需要验证两个值对象不相等时
2. 边界条件测试：确保某些操作不会产生意外的对象相等
3. 数据验证测试：验证不同输入不会产生相同的输出对象

开发者考量

虽然开发者可以自行通过 assertFalse($actual->equals($expected)) 实现类似功能，但提供标准化的断言方法有以下优势：

1. 一致性：与框架其他断言方法保持一致的命名和使用方式
2. 错误信息：自动生成更友好的错误信息
3. 代码可读性：使测试代码更清晰表达意图

实现细节

值得注意的是，这个方法并不是简单地对 assertObjectEquals() 的结果取反。它继承了相同的严格类型检查机制，确保只有在所有前提条件都满足的情况下才会进行对象比较。

总结

assertObjectNotEquals() 的加入完善了 PHPUnit 的对象比较断言工具集，为开发者提供了更全面的测试手段。虽然实现简单，但它遵循了 PHPUnit 一贯的设计原则，提供了类型安全且表达力强的测试方式。