spiral / framework

src/AuthHttp/src/Middleware/AuthMiddleware.php

Braces +10 added lines, -5 removed lines

@@ -70,14 +70,17 @@ 
 
     private function initContext(Request $request, AuthContextInterface $authContext): AuthContextInterface
     {
-        foreach ($this->transportRegistry->getTransports() as $name => $transport) {
+        foreach ($this->transportRegistry->getTransports() as $name => $transport)
+        {
             $tokenID = $transport->fetchToken($request);
-            if ($tokenID === null) {
+            if ($tokenID === null)
+            {
                 continue;
             }
 
             $token = $this->tokenStorage->load($tokenID);
-            if ($token === null) {
+            if ($token === null)
+            {
                 continue;
             }
 
@@ -91,13 +94,15 @@ 
 
     private function closeContext(Request $request, Response $response, AuthContextInterface $authContext): Response
     {
-        if ($authContext->getToken() === null) {
+        if ($authContext->getToken() === null)
+        {
             return $response;
         }
 
         $transport = $this->transportRegistry->getTransport($authContext->getTransport());
 
-        if ($authContext->isClosed()) {
+        if ($authContext->isClosed())
+        {
             $this->tokenStorage->delete($authContext->getToken());
 
             return $transport->removeToken(

src/Csrf/src/Middleware/CsrfMiddleware.php

Spacing +6 added lines, -6 removed lines

@@ -45,9 +45,9 @@ 
     public function process(Request $request, RequestHandlerInterface $handler): Response
     {
         $cookie = null;
-        if (isset($request->getCookieParams()[$this->config->getCookie()])) {
+        if (isset($request->getCookieParams()[$this->config->getCookie()])){
             $token = $request->getCookieParams()[$this->config->getCookie()];
-        } else {
+        }else{
             //Making new token
             $token = $this->random($this->config->getTokenLength());
 
@@ -58,7 +58,7 @@ 
         //CSRF issues must be handled by Firewall middleware
         $response = $handler->handle($request->withAttribute(static::ATTRIBUTE, $token));
 
-        if (!empty($cookie)) {
+        if (!empty($cookie)){
             return $response->withAddedHeader('Set-Cookie', $cookie);
         }
 
@@ -89,11 +89,11 @@ 
      */
     private function random(int $length = 32): string
     {
-        try {
-            if (empty($string = random_bytes($length))) {
+        try{
+            if (empty($string = random_bytes($length))){
                 throw new RuntimeException('Unable to generate random string');
             }
-        } catch (Throwable $e) {
+        }catch (Throwable $e){
             throw new RuntimeException('Unable to generate random string', $e->getCode(), $e);
         }
 

Braces +14 added lines, -6 removed lines

@@ -45,9 +45,12 @@ 
     public function process(Request $request, RequestHandlerInterface $handler): Response
     {
         $cookie = null;
-        if (isset($request->getCookieParams()[$this->config->getCookie()])) {
+        if (isset($request->getCookieParams()[$this->config->getCookie()]))
+        {
             $token = $request->getCookieParams()[$this->config->getCookie()];
-        } else {
+        }
+        else
+        {
             //Making new token
             $token = $this->random($this->config->getTokenLength());
 
@@ -58,7 +61,8 @@ 
         //CSRF issues must be handled by Firewall middleware
         $response = $handler->handle($request->withAttribute(static::ATTRIBUTE, $token));
 
-        if (!empty($cookie)) {
+        if (!empty($cookie))
+        {
             return $response->withAddedHeader('Set-Cookie', $cookie);
         }
 
@@ -89,11 +93,15 @@ 
      */
     private function random(int $length = 32): string
     {
-        try {
-            if (empty($string = random_bytes($length))) {
+        try
+        {
+            if (empty($string = random_bytes($length)))
+            {
                 throw new RuntimeException('Unable to generate random string');
             }
-        } catch (Throwable $e) {
+        }
+        catch (Throwable $e)
+        {
             throw new RuntimeException('Unable to generate random string', $e->getCode(), $e);
         }
 

src/Csrf/src/Middleware/CsrfFirewall.php

Spacing +4 added lines, -4 removed lines

@@ -56,11 +56,11 @@ 
     {
         $token = $request->getAttribute(CsrfMiddleware::ATTRIBUTE);
 
-        if (empty($token)) {
+        if (empty($token)){
             throw new LogicException('Unable to apply CSRF firewall, attribute is missing');
         }
 
-        if ($this->isRequired($request) && !hash_equals($token, $this->fetchToken($request))) {
+        if ($this->isRequired($request) && !hash_equals($token, $this->fetchToken($request))){
             return $this->responseFactory->createResponse(412, 'Bad CSRF Token');
         }
 
@@ -80,12 +80,12 @@ 
      */
     protected function fetchToken(Request $request): string
     {
-        if ($request->hasHeader(self::HEADER)) {
+        if ($request->hasHeader(self::HEADER)){
             return $request->getHeaderLine(self::HEADER);
         }
 
         $data = $request->getParsedBody();
-        if (is_array($data) && isset($data[self::PARAMETER]) && is_string($data[self::PARAMETER])) {
+        if (is_array($data) && isset($data[self::PARAMETER]) && is_string($data[self::PARAMETER])){
             return $data[self::PARAMETER];
         }
 

Braces +8 added lines, -4 removed lines

@@ -56,11 +56,13 @@ 
     {
         $token = $request->getAttribute(CsrfMiddleware::ATTRIBUTE);
 
-        if (empty($token)) {
+        if (empty($token))
+        {
             throw new LogicException('Unable to apply CSRF firewall, attribute is missing');
         }
 
-        if ($this->isRequired($request) && !hash_equals($token, $this->fetchToken($request))) {
+        if ($this->isRequired($request) && !hash_equals($token, $this->fetchToken($request)))
+        {
             return $this->responseFactory->createResponse(412, 'Bad CSRF Token');
         }
 
@@ -80,12 +82,14 @@ 
      */
     protected function fetchToken(Request $request): string
     {
-        if ($request->hasHeader(self::HEADER)) {
+        if ($request->hasHeader(self::HEADER))
+        {
             return $request->getHeaderLine(self::HEADER);
         }
 
         $data = $request->getParsedBody();
-        if (is_array($data) && isset($data[self::PARAMETER]) && is_string($data[self::PARAMETER])) {
+        if (is_array($data) && isset($data[self::PARAMETER]) && is_string($data[self::PARAMETER]))
+        {
             return $data[self::PARAMETER];
         }
 

src/Scaffolder/src/helpers.php

Spacing +7 added lines, -7 removed lines

@@ -11,7 +11,7 @@ 
 
 namespace Spiral\Scaffolder;
 
-if (!function_exists('trimPostfix')) {
+if (!function_exists('trimPostfix')){
     /**
      * @param string $name
      * @param string $postfix
@@ -26,7 +26,7 @@ 
     }
 }
 
-if (!function_exists('isAssociativeArray')) {
+if (!function_exists('isAssociativeArray')){
     /**
      * @param array $array
      * @return bool
@@ -35,12 +35,12 @@ 
     function isAssociativeArray(array $array): bool
     {
         $keys = [];
-        foreach ($array as $key => $_) {
-            if (!is_int($key)) {
+        foreach ($array as $key => $_){
+            if (!is_int($key)){
                 return true;
             }
 
-            if ($key !== count($keys)) {
+            if ($key !== count($keys)){
                 return true;
             }
 
@@ -51,7 +51,7 @@ 
     }
 }
 
-if (!function_exists('defineArrayType')) {
+if (!function_exists('defineArrayType')){
     /**
      * @param array  $array
      * @param string|null $failureType
@@ -60,7 +60,7 @@ 
      */
     function defineArrayType(array $array, string $failureType = null): ?string
     {
-        $types = array_map(static fn ($value): string => gettype($value), $array);
+        $types = array_map(static fn ($value) : string => gettype($value), $array);
 
         $types = array_unique($types);
 

src/SendIt/src/Bootloader/MailerBootloader.php

Spacing +5 added lines, -5 removed lines

@@ -69,7 +69,7 @@ 
 
     public function start(Container $container): void
     {
-        if ($container->has(JobRegistry::class)) {
+        if ($container->has(JobRegistry::class)){
             // Will be removed since v3.0
             $registry = $container->get(JobRegistry::class);
             $registry->setHandler(MailQueue::JOB_NAME, MailJob::class);
@@ -77,16 +77,16 @@ 
             $container->bindSingleton(
                 MailerInterface::class,
                 static function (MailerConfig $config) use ($container) {
-                    if ($config->getQueueConnection() === 'sync') {
+                    if ($config->getQueueConnection() === 'sync'){
                         $queue = $container->get(ShortCircuit::class);
-                    } else {
+                    }else{
                         $queue = $container->get(QueueInterface::class);
                     }
 
                     return new MailQueue($config, $queue);
                 }
             );
-        } else {
+        }else{
             $container->bindSingleton(
                 MailerInterface::class,
                 static fn (MailerConfig $config, QueueConnectionProviderInterface $provider) => new MailQueue(
@@ -96,7 +96,7 @@ 
             );
         }
 
-        if ($container->has(HandlerRegistryInterface::class)) {
+        if ($container->has(HandlerRegistryInterface::class)){
             $registry = $container->get(HandlerRegistryInterface::class);
             $registry->setHandler(MailQueue::JOB_NAME, MailJob::class);
         }

Braces +14 added lines, -6 removed lines

@@ -69,24 +69,31 @@ 
 
     public function start(Container $container): void
     {
-        if ($container->has(JobRegistry::class)) {
+        if ($container->has(JobRegistry::class))
+        {
             // Will be removed since v3.0
             $registry = $container->get(JobRegistry::class);
             $registry->setHandler(MailQueue::JOB_NAME, MailJob::class);
             $registry->setSerializer(MailQueue::JOB_NAME, MessageSerializer::class);
             $container->bindSingleton(
                 MailerInterface::class,
-                static function (MailerConfig $config) use ($container) {
-                    if ($config->getQueueConnection() === 'sync') {
+                static function (MailerConfig $config) use ($container)
+                {
+                    if ($config->getQueueConnection() === 'sync')
+                    {
                         $queue = $container->get(ShortCircuit::class);
-                    } else {
+                    }
+                    else
+                    {
                         $queue = $container->get(QueueInterface::class);
                     }
 
                     return new MailQueue($config, $queue);
                 }
             );
-        } else {
+        }
+        else
+        {
             $container->bindSingleton(
                 MailerInterface::class,
                 static fn (MailerConfig $config, QueueConnectionProviderInterface $provider) => new MailQueue(
@@ -96,7 +103,8 @@ 
             );
         }
 
-        if ($container->has(HandlerRegistryInterface::class)) {
+        if ($container->has(HandlerRegistryInterface::class))
+        {
             $registry = $container->get(HandlerRegistryInterface::class);
             $registry->setHandler(MailQueue::JOB_NAME, MailJob::class);
         }

src/Cache/src/Bootloader/CacheBootloader.php

Spacing +2 added lines, -2 removed lines

@@ -54,7 +54,7 @@ 
     {
         $manager = new CacheManager($config, $container);
 
-        foreach ($config->getAliases() as $alias => $storageName) {
+        foreach ($config->getAliases() as $alias => $storageName){
             $container->bind($alias, static fn (CacheManager $manager) => $manager->storage($storageName));
         }
 
@@ -74,7 +74,7 @@ 
                     ],
                     'file' => [
                         'type' => 'file',
-                        'path' => $dirs->get('runtime') . 'cache',
+                        'path' => $dirs->get('runtime').'cache',
                     ],
                 ],
                 'typeAliases' => [

Braces +2 added lines, -1 removed lines

@@ -54,7 +54,8 @@
     {
         $manager = new CacheManager($config, $container);
 
-        foreach ($config->getAliases() as $alias => $storageName) {
+        foreach ($config->getAliases() as $alias => $storageName)
+        {
             $container->bind($alias, static fn (CacheManager $manager) => $manager->storage($storageName));
         }
 

src/Config/src/Loader/PhpLoader.php

Spacing +2 added lines, -2 removed lines

@@ -33,9 +33,9 @@
      */
     public function loadFile(string $section, string $filename): array
     {
-        try {
+        try{
             return ContainerScope::runScope($this->container, fn () => require $filename);
-        } catch (Throwable $e) {
+        }catch (Throwable $e){
             throw new LoaderException($e->getMessage(), $e->getCode(), $e);
         }
     }

Braces +5 added lines, -2 removed lines

@@ -33,9 +33,12 @@
      */
     public function loadFile(string $section, string $filename): array
     {
-        try {
+        try
+        {
             return ContainerScope::runScope($this->container, fn () => require $filename);
-        } catch (Throwable $e) {
+        }
+        catch (Throwable $e)
+        {
             throw new LoaderException($e->getMessage(), $e->getCode(), $e);
         }
     }

src/Attributes/src/Internal/DoctrineAnnotationReader.php

Spacing +7 added lines, -7 removed lines

@@ -52,7 +52,7 @@ 
 
         yield from $this->filter($name, $result);
 
-        foreach ($class->getTraits() as $trait) {
+        foreach ($class->getTraits() as $trait){
             yield from $this->getClassMetadata($trait, $name);
         }
     }
@@ -62,7 +62,7 @@ 
      */
     public function getFunctionMetadata(ReflectionFunctionAbstract $function, string $name = null): iterable
     {
-        if ($function instanceof ReflectionMethod) {
+        if ($function instanceof ReflectionMethod){
             $result = $this->wrapDoctrineExceptions(fn () => $this->reader->getMethodAnnotations($function));
 
             return $this->filter($name, $result);
@@ -104,10 +104,10 @@ 
 
     private function wrapDoctrineExceptions(Closure $then): iterable
     {
-        try {
+        try{
             return $then();
-        } catch (AnnotationException $e) {
-            switch (true) {
+        }catch (AnnotationException $e){
+            switch (true){
                 case \str_starts_with($e->getMessage(), '[Syntax Error]'):
                 case \str_starts_with($e->getMessage(), '[Type Error]'):
                     $class = SyntaxAttributeException::class;
@@ -129,14 +129,14 @@ 
     private function bootAnnotations(): void
     {
         // doctrine/annotations ^1.0 compatibility.
-        if (\method_exists(AnnotationRegistry::class, 'registerLoader')) {
+        if (\method_exists(AnnotationRegistry::class, 'registerLoader')){
             AnnotationRegistry::registerLoader('\\class_exists');
         }
     }
 
     private function checkAvailability(): void
     {
-        if ($this->isAvailable()) {
+        if ($this->isAvailable()){
             return;
         }
 

Braces +15 added lines, -7 removed lines

@@ -52,7 +52,8 @@ 
 
         yield from $this->filter($name, $result);
 
-        foreach ($class->getTraits() as $trait) {
+        foreach ($class->getTraits() as $trait)
+        {
             yield from $this->getClassMetadata($trait, $name);
         }
     }
@@ -62,7 +63,8 @@ 
      */
     public function getFunctionMetadata(ReflectionFunctionAbstract $function, string $name = null): iterable
     {
-        if ($function instanceof ReflectionMethod) {
+        if ($function instanceof ReflectionMethod)
+        {
             $result = $this->wrapDoctrineExceptions(fn () => $this->reader->getMethodAnnotations($function));
 
             return $this->filter($name, $result);
@@ -104,10 +106,14 @@ 
 
     private function wrapDoctrineExceptions(Closure $then): iterable
     {
-        try {
+        try
+        {
             return $then();
-        } catch (AnnotationException $e) {
-            switch (true) {
+        }
+        catch (AnnotationException $e)
+        {
+            switch (true)
+            {
                 case \str_starts_with($e->getMessage(), '[Syntax Error]'):
                 case \str_starts_with($e->getMessage(), '[Type Error]'):
                     $class = SyntaxAttributeException::class;
@@ -129,14 +135,16 @@ 
     private function bootAnnotations(): void
     {
         // doctrine/annotations ^1.0 compatibility.
-        if (\method_exists(AnnotationRegistry::class, 'registerLoader')) {
+        if (\method_exists(AnnotationRegistry::class, 'registerLoader'))
+        {
             AnnotationRegistry::registerLoader('\\class_exists');
         }
     }
 
     private function checkAvailability(): void
     {
-        if ($this->isAvailable()) {
+        if ($this->isAvailable())
+        {
             return;
         }
 

src/Attributes/src/ReaderInterface.php

Indentation +119 added lines, -119 removed lines

@@ -20,151 +20,151 @@
 interface ReaderInterface
 {
     /**
-    * Gets a list of attributes and/or annotations applied to a class.
-    *
-    * @template T
-    *
-    * @param ReflectionClass $class The reflection instance of the class from
-    *      which the class annotations should be read.
-    * @param class-string<T>|null $name The class name of the annotation
-    *      and/or attribute.
-    *
-    * @return iterable<T> A list of class annotations and/or attributes.
-    */
+     * Gets a list of attributes and/or annotations applied to a class.
+     *
+     * @template T
+     *
+     * @param ReflectionClass $class The reflection instance of the class from
+     *      which the class annotations should be read.
+     * @param class-string<T>|null $name The class name of the annotation
+     *      and/or attribute.
+     *
+     * @return iterable<T> A list of class annotations and/or attributes.
+     */
     public function getClassMetadata(ReflectionClass $class, string $name = null): iterable;
 
     /**
-    * Gets the attribute or annotation applied to a class.
-    *
-    * @template T
-    *
-    * @param ReflectionClass $class The reflection instance of the class from
-    *       which the class annotations should be read.
-    * @param class-string<T> $name The class name of the annotation
-    *      and/or attribute.
-    *
-    * @return T|null The annotation/attribute or {@see null}, if the requested
-    *      annotation does not exist.
-    */
+     * Gets the attribute or annotation applied to a class.
+     *
+     * @template T
+     *
+     * @param ReflectionClass $class The reflection instance of the class from
+     *       which the class annotations should be read.
+     * @param class-string<T> $name The class name of the annotation
+     *      and/or attribute.
+     *
+     * @return T|null The annotation/attribute or {@see null}, if the requested
+     *      annotation does not exist.
+     */
     public function firstClassMetadata(ReflectionClass $class, string $name): ?object;
 
     /**
-    * Gets a list of attributes and/or annotations applied to a function
-    * or method.
-    *
-    * @template T
-    *
-    * @param ReflectionFunctionAbstract $function The reflection instance of
-    *       the function or method from which the function annotations should
-    *       be read.
-    * @param class-string<T>|null $name The class name of the annotation
-    *      and/or attribute.
-    *
-    * @return iterable<T> A list of function annotations and/or attributes.
-    */
+     * Gets a list of attributes and/or annotations applied to a function
+     * or method.
+     *
+     * @template T
+     *
+     * @param ReflectionFunctionAbstract $function The reflection instance of
+     *       the function or method from which the function annotations should
+     *       be read.
+     * @param class-string<T>|null $name The class name of the annotation
+     *      and/or attribute.
+     *
+     * @return iterable<T> A list of function annotations and/or attributes.
+     */
     public function getFunctionMetadata(ReflectionFunctionAbstract $function, string $name = null): iterable;
 
     /**
-    * Gets the attribute or annotation applied to a function or method.
-    *
-    * @template T
-    *
-    * @param ReflectionFunctionAbstract $function The reflection instance of
-    *       the function or method from which the function annotations should
-    *       be read.
-    * @param class-string<T> $name The class name of the annotation and/or
-    *      attribute.
-    *
-    * @return T|null The annotation/attribute or {@see null}, if the requested
-    *      annotation does not exist.
-    */
+     * Gets the attribute or annotation applied to a function or method.
+     *
+     * @template T
+     *
+     * @param ReflectionFunctionAbstract $function The reflection instance of
+     *       the function or method from which the function annotations should
+     *       be read.
+     * @param class-string<T> $name The class name of the annotation and/or
+     *      attribute.
+     *
+     * @return T|null The annotation/attribute or {@see null}, if the requested
+     *      annotation does not exist.
+     */
     public function firstFunctionMetadata(ReflectionFunctionAbstract $function, string $name): ?object;
 
     /**
-    * Gets a list of attributes and/or annotations applied to a class property.
-    *
-    * @template T
-    *
-    * @param ReflectionProperty $property The reflection instance of the
-    *       property from which the property annotations should be read.
-    * @param class-string<T>|null $name The class name of the annotation
-    *      and/or attribute.
-    *
-    * @return iterable<T> A list of property annotations and/or attributes.
-    */
+     * Gets a list of attributes and/or annotations applied to a class property.
+     *
+     * @template T
+     *
+     * @param ReflectionProperty $property The reflection instance of the
+     *       property from which the property annotations should be read.
+     * @param class-string<T>|null $name The class name of the annotation
+     *      and/or attribute.
+     *
+     * @return iterable<T> A list of property annotations and/or attributes.
+     */
     public function getPropertyMetadata(ReflectionProperty $property, string $name = null): iterable;
 
     /**
-    * Gets the attribute or annotation applied to a property.
-    *
-    * @template T
-    *
-    * @param ReflectionProperty $property The reflection instance of the
-    *       property from which the property annotations should be read.
-    * @param class-string<T> $name The class name of the annotation and/or
-    *      attribute.
-    *
-    * @return T|null The annotation/attribute or {@see null}, if the requested
-    *      annotation does not exist.
-    */
+     * Gets the attribute or annotation applied to a property.
+     *
+     * @template T
+     *
+     * @param ReflectionProperty $property The reflection instance of the
+     *       property from which the property annotations should be read.
+     * @param class-string<T> $name The class name of the annotation and/or
+     *      attribute.
+     *
+     * @return T|null The annotation/attribute or {@see null}, if the requested
+     *      annotation does not exist.
+     */
     public function firstPropertyMetadata(ReflectionProperty $property, string $name): ?object;
 
     /**
-    * Gets a list of attributes and/or annotations applied to a class constant.
-    *
-    * @template T
-    *
-    * @param ReflectionClassConstant $constant The reflection instance of the
-    *       class constant from which the constant annotations should be read.
-    * @param class-string<T>|null $name The class name of the annotation
-    *      and/or attribute.
-    *
-    * @return iterable<T> A list of constant annotations and/or attributes.
-    */
+     * Gets a list of attributes and/or annotations applied to a class constant.
+     *
+     * @template T
+     *
+     * @param ReflectionClassConstant $constant The reflection instance of the
+     *       class constant from which the constant annotations should be read.
+     * @param class-string<T>|null $name The class name of the annotation
+     *      and/or attribute.
+     *
+     * @return iterable<T> A list of constant annotations and/or attributes.
+     */
     public function getConstantMetadata(ReflectionClassConstant $constant, string $name = null): iterable;
 
     /**
-    * Gets the attribute or annotation applied to a class constant.
-    *
-    * @template T
-    *
-    * @param ReflectionClassConstant $constant The reflection instance of the
-    *       class constant from which the constant annotations should be read.
-    * @param class-string<T> $name The class name of the annotation and/or
-    *      attribute.
-    *
-    * @return T|null The annotation/attribute or {@see null}, if the requested
-    *      annotation does not exist.
-    */
+     * Gets the attribute or annotation applied to a class constant.
+     *
+     * @template T
+     *
+     * @param ReflectionClassConstant $constant The reflection instance of the
+     *       class constant from which the constant annotations should be read.
+     * @param class-string<T> $name The class name of the annotation and/or
+     *      attribute.
+     *
+     * @return T|null The annotation/attribute or {@see null}, if the requested
+     *      annotation does not exist.
+     */
     public function firstConstantMetadata(ReflectionClassConstant $constant, string $name): ?object;
 
     /**
-    * Gets a list of attributes and/or annotations applied to a parameter of
-    * a function or method.
-    *
-    * @template T
-    *
-    * @param ReflectionParameter $parameter The reflection instance of the
-    *       parameter from which the parameter annotations should be read.
-    * @param class-string<T>|null $name The class name of the annotation
-    *      and/or attribute.
-    *
-    * @return iterable<T> A list of parameter annotations and/or attributes.
-    */
+     * Gets a list of attributes and/or annotations applied to a parameter of
+     * a function or method.
+     *
+     * @template T
+     *
+     * @param ReflectionParameter $parameter The reflection instance of the
+     *       parameter from which the parameter annotations should be read.
+     * @param class-string<T>|null $name The class name of the annotation
+     *      and/or attribute.
+     *
+     * @return iterable<T> A list of parameter annotations and/or attributes.
+     */
     public function getParameterMetadata(ReflectionParameter $parameter, string $name = null): iterable;
 
     /**
-    * Gets the attribute or annotation applied to a function's parameter.
-    *
-    * @template T
-    *
-    * @param ReflectionParameter $parameter The reflection instance of the
-    *       parameter from which the parameter annotations should be read.
-    * @param class-string<T> $name The class name of the annotation and/or
-    *      attribute.
-    *
-    * @return T|null The annotation/attribute or {@see null}, if the requested
-    *      annotation does not exist.
-    */
+     * Gets the attribute or annotation applied to a function's parameter.
+     *
+     * @template T
+     *
+     * @param ReflectionParameter $parameter The reflection instance of the
+     *       parameter from which the parameter annotations should be read.
+     * @param class-string<T> $name The class name of the annotation and/or
+     *      attribute.
+     *
+     * @return T|null The annotation/attribute or {@see null}, if the requested
+     *      annotation does not exist.
+     */
     public function firstParameterMetadata(ReflectionParameter $parameter, string $name): ?object;
 }