Closes #5811

Author: sebastianbergmann

ChangeLog-11.2.md

@@ -8,6 +8,7 @@ All notable changes of the PHPUnit 11.2 release series are documented in this fi
 
 * [#5799](https://github.com/sebastianbergmann/phpunit/issues/5799): `#[CoversTrait]` and `#[UsesTrait]` attributes
 * [#5804](https://github.com/sebastianbergmann/phpunit/pull/5804): Support doubling `readonly` classes
+* [#5811](https://github.com/sebastianbergmann/phpunit/issues/5811): `assertObjectNotEquals()`
 
 ### Deprecated
 

src/Framework/Assert.php

@@ -468,6 +468,20 @@ final public static function assertObjectEquals(object $expected, object $actual
         );
     }
 
+    /**
+     * @throws ExpectationFailedException
+     */
+    final public static function assertObjectNotEquals(object $expected, object $actual, string $method = 'equals', string $message = ''): void
+    {
+        static::assertThat(
+            $actual,
+            static::logicalNot(
+                static::objectEquals($expected, $method),
+            ),
+            $message,
+        );
+    }
+
     /**
      * Asserts that a variable is empty.
      *

src/Framework/Assert/Functions.php

@@ -484,6 +484,20 @@ function assertObjectEquals(object $expected, object $actual, string $method = '
     }
 }
 
+if (!function_exists('PHPUnit\Framework\assertObjectNotEquals')) {
+    /**
+     * @throws ExpectationFailedException
+     *
+     * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
+     *
+     * @see Assert::assertObjectNotEquals
+     */
+    function assertObjectNotEquals(object $expected, object $actual, string $method = 'equals', string $message = ''): void
+    {
+        Assert::assertObjectNotEquals(...func_get_args());
+    }
+}
+
 if (!function_exists('PHPUnit\Framework\assertEmpty')) {
     /**
      * Asserts that a variable is empty.

tests/unit/Framework/AssertTest.php

@@ -2282,6 +2282,19 @@ public function testTwoObjectsCanBeAssertedToBeEqualUsingComparisonMethod(): voi
         $this->fail();
     }
 
+    public function testTwoObjectsCanBeAssertedToNotBeEqualUsingComparisonMethod(): void
+    {
+        $this->assertObjectNotEquals(new ValueObject(1), new ValueObject(2));
+
+        try {
+            $this->assertObjectNotEquals(new ValueObject(1), new ValueObject(1));
+        } catch (AssertionFailedError) {
+            return;
+        }
+
+        $this->fail();
+    }
+
     public function testObjectHasPropertyCanBeAsserted(): void
     {
         $objectWithProperty              = new stdClass;