Skip to content

feat(doctrine): deprecate the legacy SearchFilter/Boolean/Numeric/BackedEnum/OrderFilter#8341

Merged
soyuka merged 1 commit into
api-platform:mainfrom
soyuka:deprecate-doctrine-legacy-filters
Jun 22, 2026
Merged

feat(doctrine): deprecate the legacy SearchFilter/Boolean/Numeric/BackedEnum/OrderFilter#8341
soyuka merged 1 commit into
api-platform:mainfrom
soyuka:deprecate-doctrine-legacy-filters

Conversation

@soyuka

@soyuka soyuka commented Jun 22, 2026

Copy link
Copy Markdown
Member

Part of the 4.4 filter-deprecation series (follows #8330 AbstractFilter and #8340 Date/Range/Exists extends-form).

These multi-strategy and type-specific Doctrine filters are superseded by the canonical QueryParameter-based filter set and are removed in 6.0:

Legacy filter Replacement
SearchFilter per strategy → ExactFilter (exact), PartialSearchFilter (partial), StartSearchFilter (start), EndSearchFilter (end); relation properties matched by IRI → IriFilter
BooleanFilter ExactFilter + boolean nativeType
NumericFilter ExactFilter + numeric nativeType
BackedEnumFilter ExactFilter + backed-enum nativeType
OrderFilter SortFilter

Adds @deprecated notes (ORM + ODM; BackedEnumFilter is ORM-only) pointing at the replacement. URL syntax is unchanged for every replacement.

PHPDoc-only, no runtime trigger — the wiring-level deprecation triggers (#[ApiFilter], Operation::$filters) land in a separate PR.

…kedEnum/OrderFilter

These multi-strategy and type-specific filters are superseded by the
canonical QueryParameter-based set and are removed in 6.0:

- SearchFilter  -> ExactFilter / PartialSearchFilter / StartSearchFilter / EndSearchFilter (per strategy)
- BooleanFilter -> ExactFilter + boolean nativeType
- NumericFilter -> ExactFilter + numeric nativeType
- BackedEnumFilter -> ExactFilter + backed-enum nativeType
- OrderFilter   -> SortFilter

Add @deprecated notes (ORM + ODM; BackedEnumFilter is ORM-only) pointing at
the replacement. PHPDoc-only, no runtime trigger - the wiring-level triggers
(#[ApiFilter], Operation::$filters) land separately.
@soyuka soyuka force-pushed the deprecate-doctrine-legacy-filters branch from 22a1260 to 0f5d95c Compare June 22, 2026 10:03
@soyuka soyuka merged commit 9b1a58f into api-platform:main Jun 22, 2026
3 of 94 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant