Update phpdoc

src/Extension/Attribute/AsTwigExtension.php

@@ -1,8 +1,15 @@
 <?php
 
-namespace Twig\Extension\Attribute;
+/*
+ * This file is part of Twig.
+ *
+ * (c) Fabien Potencier
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
 
-use Twig\TwigFilter;
+namespace Twig\Extension\Attribute;
 
 /**
  * Identifies a class that uses PHP attributes to define filters, functions, or tests.

src/Extension/Attribute/AsTwigFilter.php

@@ -1,20 +1,36 @@
 <?php
 
+/*
+ * This file is part of Twig.
+ *
+ * (c) Fabien Potencier
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
 namespace Twig\Extension\Attribute;
 
 use Twig\TwigFilter;
 
 /**
  * Registers a method as template filter.
  *
+ * If the first argument of the method has Twig\Environment type-hint, the filter will receive the current environment.
+ * If the next argument of the method is named $context and has array type-hint, the filter will receive the current context.
+ * Additional arguments of the method come from the filter call.
+ *
+ *     #[AsTwigFilter('foo')]
+ *     function fooFilter(Environment $env, array $context, $string, $arg1 = null, ...) { ... }
+ *
  * @see TwigFilter
  */
 #[\Attribute(\Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
 class AsTwigFilter
 {
     public function __construct(
         /**
-         * The name of the filter in Twig
+         * The name of the filter in Twig.
          *
          * @var non-empty-string $name
          */

src/Extension/Attribute/AsTwigFunction.php

@@ -1,20 +1,36 @@
 <?php
 
+/*
+ * This file is part of Twig.
+ *
+ * (c) Fabien Potencier
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
 namespace Twig\Extension\Attribute;
 
 use Twig\TwigFunction;
 
 /**
  * Registers a method as template function.
  *
+ * If the first argument of the method has Twig\Environment type-hint, the function will receive the current environment.
+ * If the next argument of the method is named $context and has array type-hint, the function will receive the current context.
+ * Additional arguments of the method come from the function call.
+ *
+ *     #[AsTwigFunction('foo')]
+ *     function fooFunction(Environment $env, array $context, $string, $arg1 = null, ...) { ... }
+ *
  * @see TwigFunction
  */
 #[\Attribute(\Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
 class AsTwigFunction
 {
     public function __construct(
         /**
-         * The name of the function in Twig
+         * The name of the function in Twig.
          *
          * @var non-empty-string $name
          */

src/Extension/Attribute/AsTwigTest.php

@@ -1,12 +1,28 @@
 <?php
 
+/*
+ * This file is part of Twig.
+ *
+ * (c) Fabien Potencier
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
 namespace Twig\Extension\Attribute;
 
 use Twig\TwigTest;
 
 /**
  * Registers a method as template test.
  *
+ * If the first argument of the method has Twig\Environment type-hint, the test will receive the current environment.
+ * If the next argument of the method is named $context and has array type-hint, the test will receive the current context.
+ * The last argument of the method is the value to be tested, if any.
+ *
+ *     #[AsTwigTest('foo')]
+ *     public function fooTest(Environment $env, array $context, $value, $arg1 = null) { ... }
+ *
  * @see TwigTest
  */
 #[\Attribute(\Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]

src/Extension/AttributeExtension.php

@@ -98,7 +98,7 @@ private function initFromAttributes()
                 foreach ($method->getAttributes(AsTwigFilter::class) as $attribute) {
                     $attribute = $attribute->newInstance();
 
-                    $name = $attribute->name ?? $method->getName();
+                    $name = $attribute->name;
                     if (isset($filters[$name])) {
                         throw new \LogicException(sprintf('Multiple definitions of the "%s" filter.', $name));
                     }
@@ -127,7 +127,7 @@ private function initFromAttributes()
                 foreach ($method->getAttributes(AsTwigFunction::class) as $attribute) {
                     $attribute = $attribute->newInstance();
 
-                    $name = $attribute->name ?? $method->getName();
+                    $name = $attribute->name;
                     if (isset($functions[$name])) {
                         throw new \LogicException(sprintf('Multiple definitions of the "%s" function.', $name));
                     }
@@ -154,7 +154,7 @@ private function initFromAttributes()
                 foreach ($method->getAttributes(AsTwigTest::class) as $attribute) {
                     $attribute = $attribute->newInstance();
 
-                    $name = $attribute->name ?? $method->getName();
+                    $name = $attribute->name;
                     if (isset($tests[$name])) {
                         throw new \LogicException(sprintf('Multiple definitions of the "%s" test.', $name));
                     }