feat(doctrine): ComparisonFilter decorator for range filtering

[soyuka]

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

Decorator-based ComparisonFilter that composes with equality filters (ExactFilter, UuidFilter) to add gt, gte, lt, lte operators. Follows the same pattern as OrFilter by injecting $context['operator'].

[Copilot]

Pull request overview

Adds a decorator-style ComparisonFilter for Doctrine ORM/ODM to enable range-style query parameters by composing with existing equality filters (e.g., ExactFilter, UUID filters) via a context-provided comparison operator.

Changes:

• Introduces new ORM/ODM ComparisonFilter implementations and wires them into fixtures (Chicken + FilteredDateParameter) for functional coverage.
• Extends ORM ExactFilter and AbstractUuidFilter, plus ODM ExactFilter, to honor a comparison operator/method coming from filter context.
• Adds DateTime casting support for castToNativeType parameters and new functional tests validating comparison behavior and OpenAPI parameter exposure.

Reviewed changes

Copilot reviewed 14 out of 14 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
tests/Functional/Parameters/DateFilterTest.php	Adds scenarios for date range filtering via the new ComparisonFilter.
tests/Functional/Parameters/ComparisonFilterTest.php	New functional test validating gt/gte/lt/lte behavior and OpenAPI parameter names.
tests/Fixtures/TestBundle/Entity/FilteredDateParameter.php	Registers createdAtComparison QueryParameter using ComparisonFilter(ExactFilter) and native casting.
tests/Fixtures/TestBundle/Entity/Chicken.php	Adds idComparison QueryParameter using ComparisonFilter(ExactFilter).
tests/Fixtures/TestBundle/Document/FilteredDateParameter.php	ODM equivalent of createdAtComparison QueryParameter.
tests/Fixtures/TestBundle/Document/Chicken.php	ODM equivalent of idComparison QueryParameter.
src/State/Parameter/ValueCaster.php	Adds a DateTime caster intended for parameter native-type casting.
src/Metadata/Resource/Factory/ParameterResourceMetadataCollectionFactory.php	Auto-selects DateTime cast function when castToNativeType is enabled and the underlying property is DateTimeInterface.
src/Doctrine/Orm/Filter/ExactFilter.php	Allows a context-provided DQL operator (validated) instead of hardcoded =.
src/Doctrine/Orm/Filter/ComparisonFilter.php	New decorator filter that expands `{key}[gt
src/Doctrine/Orm/Filter/AbstractUuidFilter.php	Allows a context-provided DQL operator (validated) for UUID comparisons and respects whereClause.
src/Doctrine/Odm/Filter/ExactFilter.php	Adds a context-provided comparison method (validated) for non-reference fields.
src/Doctrine/Odm/Filter/ComparisonFilter.php	New ODM decorator filter expanding `{key}[gt
src/Doctrine/Odm/Extension/ParameterExtension.php	Preserves/restores prior context['filters'] around per-parameter filter application.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[soyuka]

Thanks @KDederichs for the idea ! This replaces #4689 documentation is being worked on at api-platform/docs#2258

[KDederichs]

Haha you're welcome :)
Just glad I don't have to copy my implementation around anymore when I need this :D