From d8902fa3d56587a48d64cca64bb32b51e067f73d Mon Sep 17 00:00:00 2001
From: Vincent Amstoutz <vincent.amstoutz@les-tilleuls.coop>
Date: Thu, 14 Nov 2024 16:21:58 +0100
Subject: [PATCH] refactor(doctrine): reference order filters constants from
 interface

---
 core/filters.md | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/core/filters.md b/core/filters.md
index 98615da0f31..6808f359bbb 100644
--- a/core/filters.md
+++ b/core/filters.md
@@ -1050,13 +1050,13 @@ App\Entity\Offer:
 When the property used for ordering can contain `null` values, you may want to specify how `null` values are treated in
 the comparison:
 
-| Description                          | Strategy to set                                                                          |
-| ------------------------------------ | ---------------------------------------------------------------------------------------- |
-| Use the default behavior of the DBMS | `null`                                                                                   |
-| Consider items as smallest           | `ApiPlatform\Doctrine\Orm\Filter\OrderFilter::NULLS_SMALLEST` (`nulls_smallest`)         |
-| Consider items as largest            | `ApiPlatform\Doctrine\Orm\Filter\OrderFilter::NULLS_LARGEST` (`nulls_largest`)           |
-| Order items always first             | `ApiPlatform\Doctrine\Orm\Filter\OrderFilter::NULLS_ALWAYS_FIRST` (`nulls_always_first`) |
-| Order items always last              | `ApiPlatform\Doctrine\Orm\Filter\OrderFilter::NULLS_ALWAYS_LAST` (`nulls_always_last`)   |
+| Description                          | Strategy to set                                                                                   |
+| ------------------------------------ |---------------------------------------------------------------------------------------------------|
+| Use the default behavior of the DBMS | `null`                                                                                            |
+| Consider items as smallest           | `ApiPlatform\Doctrine\Common\Filter\OrderFilterInterface::NULLS_SMALLEST` (`nulls_smallest`)      |
+| Consider items as largest            | `ApiPlatform\Doctrine\Common\Filter\OrderFilterInterface::NULLS_LARGEST` (`nulls_largest`)           |
+| Order items always first             | `ApiPlatform\Doctrine\Common\Filter\OrderFilterInterface::NULLS_ALWAYS_FIRST` (`nulls_always_first`) |
+| Order items always last              | `ApiPlatform\Doctrine\Common\Filter\OrderFilterInterface::NULLS_ALWAYS_LAST` (`nulls_always_last`)   |
 
 For instance, treat entries with a property value of `null` as the smallest, with the following service definition:
 
@@ -1067,12 +1067,13 @@ For instance, treat entries with a property value of `null` as the smallest, wit
 // api/src/Entity/Offer.php
 namespace App\Entity;
 
+use ApiPlatform\Doctrine\Common\Filter\OrderFilterInterface;
 use ApiPlatform\Metadata\ApiFilter;
 use ApiPlatform\Metadata\ApiResource;
 use ApiPlatform\Doctrine\Orm\Filter\OrderFilter;
 
 #[ApiResource]
-#[ApiFilter(OrderFilter::class, properties: ['validFrom' => ['nulls_comparison' => OrderFilter::NULLS_SMALLEST, 'default_direction' => 'DESC']])]
+#[ApiFilter(OrderFilter::class, properties: ['validFrom' => ['nulls_comparison' => OrderFilterInterface::NULLS_SMALLEST, 'default_direction' => 'DESC']])]
 class Offer
 {
     // ...