chore: add PHPStan deprecation rules

CHANGELOG.md

@@ -8,6 +8,8 @@ See [keep a changelog] for information about writing changes to this log.
 
 ## [Unreleased]
 
+- [PR-78](https://github.com/itk-dev/event-database-api/pull/78)
+  Add PHPStan deprecation rules (ignore the API Platform 4.4 `#[ApiFilter]` deprecations)
 - [PR-77](https://github.com/itk-dev/event-database-api/pull/77)
   Update Symfony Flex recipes
 - [PR-76](https://github.com/itk-dev/event-database-api/pull/76)

composer.json

@@ -45,6 +45,7 @@
         "pb30/phpstan-composer-analysis": "^1.1",
         "phpstan/extension-installer": "^1.4",
         "phpstan/phpstan": "^2.1",
+        "phpstan/phpstan-deprecation-rules": "^2.0",
         "phpstan/phpstan-strict-rules": "^2.0",
         "phpstan/phpstan-symfony": "^2.0",
         "phpunit/phpunit": "^13",

phpstan.dist.neon

@@ -17,6 +17,13 @@ parameters:
         - identifier: missingType.iterableValue
         # The ID properties are set reflectively by API Platform.
         - '#Property App\\Api\\Dto\\[^\\]+::\$id is unused#'
+        # API Platform 4.4 deprecates #[ApiFilter] and replaces it with #[QueryParameter]. #[ApiFilter] is removed
+        # in API Platform 6.0. The change needs application code changes (the DTOs, and AbstractProvider::getFilters(),
+        # which reads the #[ApiFilter] attributes through api_platform.filter_locator). Remove this rule after the change.
+        -
+            identifier: attribute.deprecated
+            message: '#^Attribute class ApiPlatform\\Metadata\\ApiFilter is deprecated#'
+            path: src/Api/Dto/*
     # pb30/phpstan-composer-analysis: report packages used directly but only installed transitively ("shadow
     # dependencies") and dev packages used in production code. Unused/misplaced checks are off: bundles and
     # extensions are used through config, not class references, so they would all be false positives.