chore: remove @experimental flag from parameters (#7357)

soyuka · web-flow · commit 4dae0562127c · 2025-09-05T10:12:26.000+02:00
diff --git a/src/Doctrine/Odm/State/LinksHandlerInterface.php b/src/Doctrine/Odm/State/LinksHandlerInterface.php
@@ -16,9 +16,6 @@
 use ApiPlatform\Metadata\Operation;
 use Doctrine\ODM\MongoDB\Aggregation\Builder;
 
-/**
- * @experimental
- */
 interface LinksHandlerInterface
 {
     /**
diff --git a/src/Doctrine/Orm/State/LinksHandlerInterface.php b/src/Doctrine/Orm/State/LinksHandlerInterface.php
@@ -17,9 +17,6 @@
 use ApiPlatform\Metadata\Operation;
 use Doctrine\ORM\QueryBuilder;
 
-/**
- * @experimental
- */
 interface LinksHandlerInterface
 {
     /**
diff --git a/src/Metadata/ApiProperty.php b/src/Metadata/ApiProperty.php
@@ -51,7 +51,7 @@ final class ApiProperty
      * @param string[]|null                                                                                                                               $types                   the RDF types of this property
      * @param string[]|null                                                                                                                               $iris
      * @param LegacyType[]|null                                                                                                                           $builtinTypes
-     * @param string|null                                                                                                                                 $uriTemplate             (experimental) whether to return the subRessource collection IRI instead of an iterable of IRI
+     * @param string|null                                                                                                                                 $uriTemplate             whether to return the subRessource collection IRI instead of an iterable of IRI
      * @param string|null                                                                                                                                 $property                The property name
      * @param Context|Groups|Ignore|SerializedName|SerializedPath|MaxDepth|array<array-key, Context|Groups|Ignore|SerializedName|SerializedPath|MaxDepth> $serialize               Serializer attributes
      * @param Type|null                                                                                                                                   $nativeType              The internal PHP type
@@ -650,8 +650,6 @@ public function withGenId(bool $genId): static
 
     /**
      * Whether to return the subRessource collection IRI instead of an iterable of IRI.
-     *
-     * @experimental
      */
     public function getUriTemplate(): ?string
     {
diff --git a/src/Metadata/HeaderParameter.php b/src/Metadata/HeaderParameter.php
@@ -13,9 +13,6 @@
 
 namespace ApiPlatform\Metadata;
 
-/**
- * @experimental
- */
 #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::IS_REPEATABLE)]
 class HeaderParameter extends Parameter implements HeaderParameterInterface
 {
diff --git a/src/Metadata/HeaderParameterInterface.php b/src/Metadata/HeaderParameterInterface.php
@@ -14,7 +14,7 @@
 namespace ApiPlatform\Metadata;
 
 /**
- * @experimental
+ * A HTTP header parameter.
  */
 interface HeaderParameterInterface
 {
diff --git a/src/Metadata/Metadata.php b/src/Metadata/Metadata.php
@@ -73,9 +73,6 @@ public function __construct(
         protected $provider = null,
         protected $processor = null,
         protected ?OptionsInterface $stateOptions = null,
-        /*
-         * @experimental
-         */
         array|Parameters|null $parameters = null,
         protected mixed $rules = null,
         protected ?string $policy = null,
diff --git a/src/Metadata/Parameter.php b/src/Metadata/Parameter.php
@@ -18,9 +18,6 @@
 use ApiPlatform\State\ParameterProviderInterface;
 use Symfony\Component\TypeInfo\Type;
 
-/**
- * @experimental
- */
 abstract class Parameter
 {
     /**
diff --git a/src/Metadata/QueryParameter.php b/src/Metadata/QueryParameter.php
@@ -13,9 +13,6 @@
 
 namespace ApiPlatform\Metadata;
 
-/**
- * @experimental
- */
 #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::IS_REPEATABLE)]
 class QueryParameter extends Parameter implements QueryParameterInterface
 {
diff --git a/src/Metadata/QueryParameterInterface.php b/src/Metadata/QueryParameterInterface.php
@@ -14,7 +14,7 @@
 namespace ApiPlatform\Metadata;
 
 /**
- * @experimental
+ * A parameter in the HTTP request query string.
  */
 interface QueryParameterInterface
 {
diff --git a/src/Metadata/Resource/Factory/ParameterResourceMetadataCollectionFactory.php b/src/Metadata/Resource/Factory/ParameterResourceMetadataCollectionFactory.php
@@ -38,8 +38,6 @@
 
 /**
  * Prepares Parameters documentation by reading its filter details and declaring an OpenApi parameter.
- *
- * @experimental
  */
 final class ParameterResourceMetadataCollectionFactory implements ResourceMetadataCollectionFactoryInterface
 {
diff --git a/src/Serializer/Parameter/SerializerFilterParameterProvider.php b/src/Serializer/Parameter/SerializerFilterParameterProvider.php
@@ -20,9 +20,6 @@
 use ApiPlatform\State\Util\RequestAttributesExtractor;
 use Psr\Container\ContainerInterface;
 
-/**
- * @experimental
- */
 final class SerializerFilterParameterProvider implements ParameterProviderInterface
 {
     public function __construct(private readonly ?ContainerInterface $filterLocator)
diff --git a/src/State/CreateProvider.php b/src/State/CreateProvider.php
@@ -29,8 +29,6 @@
  *
  * @author Antoine Bluchet <soyuka@gmail.com>
  *
- * @experimental
- *
  * @internal
  */
 final class CreateProvider implements ProviderInterface
diff --git a/src/State/ObjectProvider.php b/src/State/ObjectProvider.php
@@ -20,8 +20,6 @@
  * An ItemProvider that just creates a new object.
  *
  * @author Antoine Bluchet <soyuka@gmail.com>
- *
- * @experimental
  */
 final class ObjectProvider implements ProviderInterface
 {
diff --git a/src/State/ParameterNotFound.php b/src/State/ParameterNotFound.php
@@ -14,7 +14,7 @@
 namespace ApiPlatform\State;
 
 /**
- * @experimental
+ * Represents a query or header parameter that was not present during this request.
  */
 final class ParameterNotFound
 {
diff --git a/src/State/ParameterProviderInterface.php b/src/State/ParameterProviderInterface.php
@@ -18,8 +18,6 @@
 
 /**
  * Optionnaly transforms request parameters and provides modification to the current Operation.
- *
- * @experimental
  */
 interface ParameterProviderInterface
 {
diff --git a/src/State/Provider/ParameterProvider.php b/src/State/Provider/ParameterProvider.php
@@ -31,8 +31,6 @@
  * Loops over parameters to:
  *   - compute its values set as extra properties from the Parameter object (`_api_values`)
  *   - call the Parameter::provider if any and updates the Operation
- *
- * @experimental
  */
 final class ParameterProvider implements ProviderInterface, StopwatchAwareInterface
 {
diff --git a/src/Symfony/Validator/State/ParameterValidatorProvider.php b/src/Symfony/Validator/State/ParameterValidatorProvider.php
@@ -29,8 +29,6 @@
 
 /**
  * Validates parameters using the Symfony validator.
- *
- * @experimental
  */
 final class ParameterValidatorProvider implements ProviderInterface
 {
diff --git a/src/Validator/Metadata/Resource/Factory/ParameterValidationResourceMetadataCollectionFactory.php b/src/Validator/Metadata/Resource/Factory/ParameterValidationResourceMetadataCollectionFactory.php
@@ -23,9 +23,6 @@
 use ApiPlatform\Validator\Util\ParameterValidationConstraints;
 use Psr\Container\ContainerInterface;
 
-/**
- * @experimental
- */
 final class ParameterValidationResourceMetadataCollectionFactory implements ResourceMetadataCollectionFactoryInterface
 {
     use ParameterValidationConstraints;
diff --git a/src/Validator/Util/ParameterValidationConstraints.php b/src/Validator/Util/ParameterValidationConstraints.php
@@ -39,8 +39,6 @@
 
 /**
  * Helper to get a set of validation constraints for a given Parameter.
- *
- * @experimental
  */
 trait ParameterValidationConstraints
 {

Original file line number	Diff line number	Diff line change
`@@ -16,9 +16,6 @@`
`16`	`16`	`use ApiPlatform\Metadata\Operation;`
`17`	`17`	`use Doctrine\ODM\MongoDB\Aggregation\Builder;`
`18`	`18`
`19`		`-/**`
`20`		`- * @experimental`
`21`		`- */`
`22`	`19`	`interface LinksHandlerInterface`
`23`	`20`	`{`
`24`	`21`	`/**`
Original file line number	Diff line number	Diff line change
`@@ -17,9 +17,6 @@`
`17`	`17`	`use ApiPlatform\Metadata\Operation;`
`18`	`18`	`use Doctrine\ORM\QueryBuilder;`
`19`	`19`
`20`		`-/**`
`21`		`- * @experimental`
`22`		`- */`
`23`	`20`	`interface LinksHandlerInterface`
`24`	`21`	`{`
`25`	`22`	`/**`
Original file line number	Diff line number	Diff line change
`@@ -13,9 +13,6 @@`
`13`	`13`
`14`	`14`	`namespace ApiPlatform\Metadata;`
`15`	`15`
`16`		`-/**`
`17`		`- * @experimental`
`18`		`- */`
`19`	`16`	`#[\Attribute(\Attribute::TARGET_CLASS \| \Attribute::IS_REPEATABLE)]`
`20`	`17`	`class HeaderParameter extends Parameter implements HeaderParameterInterface`
`21`	`18`	`{`
Original file line number	Diff line number	Diff line change
`@@ -14,7 +14,7 @@`
`14`	`14`	`namespace ApiPlatform\Metadata;`
`15`	`15`
`16`	`16`	`/**`
`17`		`- * @experimental`
	`17`	`+ * A HTTP header parameter.`
`18`	`18`	`*/`
`19`	`19`	`interface HeaderParameterInterface`
`20`	`20`	`{`
Original file line number	Diff line number	Diff line change
`@@ -18,9 +18,6 @@`
`18`	`18`	`use ApiPlatform\State\ParameterProviderInterface;`
`19`	`19`	`use Symfony\Component\TypeInfo\Type;`
`20`	`20`
`21`		`-/**`
`22`		`- * @experimental`
`23`		`- */`
`24`	`21`	`abstract class Parameter`
`25`	`22`	`{`
`26`	`23`	`/**`
Original file line number	Diff line number	Diff line change
`@@ -38,8 +38,6 @@`
`38`	`38`
`39`	`39`	`/**`
`40`	`40`	`* Prepares Parameters documentation by reading its filter details and declaring an OpenApi parameter.`
`41`		`- *`
`42`		`- * @experimental`
`43`	`41`	`*/`
`44`	`42`	`final class ParameterResourceMetadataCollectionFactory implements ResourceMetadataCollectionFactoryInterface`
`45`	`43`	`{`