feat(doctrine): ne (not equal) operator for ComparisonFilter

| Q             | A
| ------------- | ---
| Branch?       | main
| Tickets       | ∅
| License       | MIT
| Doc PR        | ∅

* Add `ne` operator to ORM (`!=`) and ODM (`notEqual`) ComparisonFilter
* Add functional tests for both backends

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: soyuka

src/Doctrine/Odm/Filter/ComparisonFilter.php

@@ -44,6 +44,7 @@ final class ComparisonFilter implements FilterInterface, OpenApiParameterFilterI
         'gte' => 'gte',
         'lt' => 'lt',
         'lte' => 'lte',
+        'ne' => 'notEqual',
     ];
 
     public function __construct(private readonly FilterInterface $filter)
@@ -91,6 +92,7 @@ public function getOpenApiParameters(Parameter $parameter): array
             new OpenApiParameter(name: "{$key}[gte]", in: $in),
             new OpenApiParameter(name: "{$key}[lt]", in: $in),
             new OpenApiParameter(name: "{$key}[lte]", in: $in),
+            new OpenApiParameter(name: "{$key}[ne]", in: $in),
         ];
     }
 
@@ -108,6 +110,7 @@ public function getSchema(Parameter $parameter): array
                 'gte' => $innerSchema,
                 'lt' => $innerSchema,
                 'lte' => $innerSchema,
+                'ne' => $innerSchema,
             ],
         ];
     }

src/Doctrine/Orm/Filter/ComparisonFilter.php

@@ -45,6 +45,7 @@ final class ComparisonFilter implements FilterInterface, OpenApiParameterFilterI
         'gte' => '>=',
         'lt' => '<',
         'lte' => '<=',
+        'ne' => '!=',
     ];
 
     public const ALLOWED_DQL_OPERATORS = ['=', '>', '>=', '<', '<=', '!=', '<>'];
@@ -91,6 +92,7 @@ public function getOpenApiParameters(Parameter $parameter): array
             new OpenApiParameter(name: "{$key}[gte]", in: $in),
             new OpenApiParameter(name: "{$key}[lt]", in: $in),
             new OpenApiParameter(name: "{$key}[lte]", in: $in),
+            new OpenApiParameter(name: "{$key}[ne]", in: $in),
         ];
     }
 
@@ -108,6 +110,7 @@ public function getSchema(Parameter $parameter): array
                 'gte' => $innerSchema,
                 'lt' => $innerSchema,
                 'lte' => $innerSchema,
+                'ne' => $innerSchema,
             ],
         ];
     }

tests/Functional/Parameters/ComparisonFilterTest.php

@@ -98,6 +98,24 @@ public function testCombinedGtAndLt(): void
         $this->assertSame(['Bravo', 'Charlie'], $names);
     }
 
+    public function testNe(): void
+    {
+        // ne "Bravo": all names except "Bravo" → Alpha, Charlie, Delta
+        $response = self::createClient()->request('GET', '/chickens?nameComparison[ne]=Bravo');
+        $this->assertResponseIsSuccessful();
+        $names = array_map(static fn ($c) => $c['name'], $response->toArray()['member']);
+        sort($names);
+        $this->assertSame(['Alpha', 'Charlie', 'Delta'], $names);
+    }
+
+    public function testNeNoMatch(): void
+    {
+        // ne "Unknown": no chicken has that name, so all are returned
+        $response = self::createClient()->request('GET', '/chickens?nameComparison[ne]=Unknown&itemsPerPage=10');
+        $this->assertResponseIsSuccessful();
+        $this->assertCount(4, $response->toArray()['member']);
+    }
+
     public function testGtNoResults(): void
     {
         // gt "ZZZZ": no name is alphabetically after "ZZZZ"
@@ -125,7 +143,7 @@ public function testOpenApiDocumentation(): void
         $parameters = $openApiDoc['paths']['/chickens']['get']['parameters'];
         $parameterNames = array_column($parameters, 'name');
 
-        foreach (['nameComparison[gt]', 'nameComparison[gte]', 'nameComparison[lt]', 'nameComparison[lte]'] as $expectedName) {
+        foreach (['nameComparison[gt]', 'nameComparison[gte]', 'nameComparison[lt]', 'nameComparison[lte]', 'nameComparison[ne]'] as $expectedName) {
             $this->assertContains($expectedName, $parameterNames, \sprintf('Expected parameter "%s" in OpenAPI documentation', $expectedName));
         }