diff --git a/src/Symfony/Bundle/FrameworkBundle/Routing/Attribute/AsRoutingConditionService.php b/src/Symfony/Bundle/FrameworkBundle/Routing/Attribute/AsRoutingConditionService.php index d1f1a5f34a654..2bc4079785764 100644 --- a/src/Symfony/Bundle/FrameworkBundle/Routing/Attribute/AsRoutingConditionService.php +++ b/src/Symfony/Bundle/FrameworkBundle/Routing/Attribute/AsRoutingConditionService.php @@ -41,6 +41,10 @@ #[\Attribute(\Attribute::TARGET_CLASS)] class AsRoutingConditionService extends AutoconfigureTag { + /** + * @param string|null $alias The alias of the service to use it in routing condition expressions + * @param int $priority Defines a priority that allows the routing condition service to override a service with the same alias + */ public function __construct( string $alias = null, int $priority = 0, diff --git a/src/Symfony/Component/RemoteEvent/Attribute/AsRemoteEventConsumer.php b/src/Symfony/Component/RemoteEvent/Attribute/AsRemoteEventConsumer.php index 92d3c45384cc8..db08cba8b6c48 100644 --- a/src/Symfony/Component/RemoteEvent/Attribute/AsRemoteEventConsumer.php +++ b/src/Symfony/Component/RemoteEvent/Attribute/AsRemoteEventConsumer.php @@ -17,6 +17,9 @@ #[\Attribute(\Attribute::TARGET_CLASS)] class AsRemoteEventConsumer { + /** + * @param string $name The name of the remote event consumer, used to identify it when defining remote events + */ public function __construct( public string $name, ) { diff --git a/src/Symfony/Component/Routing/Attribute/Route.php b/src/Symfony/Component/Routing/Attribute/Route.php index 16900f626e93b..a53479428800b 100644 --- a/src/Symfony/Component/Routing/Attribute/Route.php +++ b/src/Symfony/Component/Routing/Attribute/Route.php @@ -26,9 +26,21 @@ class Route private array $schemes; /** - * @param array $requirements - * @param string[]|string $methods - * @param string[]|string $schemes + * @param string|array|null $path The route path (i.e. "/user/login") + * @param string|null $name The route name (i.e. "app_user_login") + * @param array $requirements Requirements for the route attributes, @see https://symfony.com/doc/current/routing.html#parameters-validation + * @param array $options Options for the route (i.e. ['prefix' => '/api']) + * @param array $defaults Default values for the route attributes and query parameters + * @param string|null $host The host for which this route should be active (i.e. "localhost") + * @param string|string[] $methods The list of HTTP methods allowed by this route + * @param string|string[] $schemes The list of schemes allowed by this route (i.e. "https") + * @param string|null $condition An expression that must evaluate to true for the route to be matched, @see https://symfony.com/doc/current/routing.html#matching-expressions + * @param int|null $priority The priority of the route if multiple ones are defined for the same path + * @param string|null $locale The locale accepted by the route + * @param string|null $format The format returned by the route (i.e. "json", "xml") + * @param bool|null $utf8 Whether the route accepts UTF-8 in its parameters + * @param bool|null $stateless Whether the route is defined as stateless or stateful, @see https://symfony.com/doc/current/routing.html#stateless-routes + * @param string|null $env The env in which the route is defined (i.e. "dev", "test", "prod") */ public function __construct( string|array $path = null, diff --git a/src/Symfony/Component/Scheduler/Attribute/AsCronTask.php b/src/Symfony/Component/Scheduler/Attribute/AsCronTask.php index 076d99169c74f..9b77c70cda8a8 100644 --- a/src/Symfony/Component/Scheduler/Attribute/AsCronTask.php +++ b/src/Symfony/Component/Scheduler/Attribute/AsCronTask.php @@ -19,6 +19,18 @@ #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)] class AsCronTask { + /** + * @param string $expression The cron expression to define the task schedule (i.e. "5 * * * *") + * @param string|null $timezone The timezone used with the cron expression + * @param int|null $jitter The cron jitter, in seconds; for example, if set to 60, the cron + * will randomly wait for a number of seconds between 0 and 60 before + * executing which allows to avoid load spikes that can happen when many tasks + * run at the same time + * @param array|string|null $arguments The arguments to pass to the cron task + * @param string $schedule The name of the schedule responsible for triggering the task + * @param string|null $method The method to run as the task when the attribute target is a class + * @param string[]|string|null $transports One or many transports through which the message scheduling the task will go + */ public function __construct( public readonly string $expression, public readonly ?string $timezone = null, diff --git a/src/Symfony/Component/Scheduler/Attribute/AsPeriodicTask.php b/src/Symfony/Component/Scheduler/Attribute/AsPeriodicTask.php index 560a36fb75b71..e962ecaaf1b08 100644 --- a/src/Symfony/Component/Scheduler/Attribute/AsPeriodicTask.php +++ b/src/Symfony/Component/Scheduler/Attribute/AsPeriodicTask.php @@ -19,6 +19,19 @@ #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)] class AsPeriodicTask { + /** + * @param string|int $frequency A string (i.e. "every hour") or an integer (the number of seconds) representing the frequency of the task + * @param string|null $from A string representing the start time of the periodic task (i.e. "08:00:00") + * @param string|null $until A string representing the end time of the periodic task (i.e. "20:00:00") + * @param int|null $jitter The cron jitter, in seconds; for example, if set to 60, the cron + * will randomly wait for a number of seconds between 0 and 60 before + * executing which allows to avoid load spikes that can happen when many tasks + * run at the same time + * @param array|string|null $arguments The arguments to pass to the cron task + * @param string $schedule The name of the schedule responsible for triggering the task + * @param string|null $method The method to run as the task when the attribute target is a class + * @param string[]|string|null $transports One or many transports through which the message scheduling the task will go + */ public function __construct( public readonly string|int $frequency, public readonly ?string $from = null, diff --git a/src/Symfony/Component/Scheduler/Attribute/AsSchedule.php b/src/Symfony/Component/Scheduler/Attribute/AsSchedule.php index 45854c1cd5abc..2f93dfcb255f2 100644 --- a/src/Symfony/Component/Scheduler/Attribute/AsSchedule.php +++ b/src/Symfony/Component/Scheduler/Attribute/AsSchedule.php @@ -19,6 +19,9 @@ #[\Attribute(\Attribute::TARGET_CLASS)] class AsSchedule { + /** + * @param string $name The name of the schedule that will be used when creating tasks + */ public function __construct( public string $name = 'default', ) {