add AsTwig* attributes

Author: Fan2Shrek

quick_tour/the_architecture.rst

@@ -159,32 +159,24 @@ Twig Extension & Autoconfiguration
 Thanks to Symfony's service handling, you can *extend* Symfony in many ways, like
 by creating an event subscriber or a security voter for complex authorization
 rules. Let's add a new filter to Twig called ``greet``. How? Create a class
-that extends ``AbstractExtension``::
+and use ``AsTwigFilter``::
 
     // src/Twig/GreetExtension.php
     namespace App\Twig;
 
-    use App\GreetingGenerator;
-    use Twig\Extension\AbstractExtension;
-    use Twig\TwigFilter;
+    use Twig\Attribute\AsTwigFilter;
 
-    class GreetExtension extends AbstractExtension
+    class GreetExtension
     {
         public function __construct(
             private GreetingGenerator $greetingGenerator,
         ) {
         }
 
-        public function getFilters(): array
-        {
-            return [
-                new TwigFilter('greet', [$this, 'greetUser']),
-            ];
-        }
-
+        #[AsTwigFilter('greet')]
         public function greetUser(string $name): string
         {
-            $greeting =  $this->greetingGenerator->getRandomGreeting();
+            $greeting = $this->greetingGenerator->getRandomGreeting();
 
             return "$greeting $name!";
         }

templates.rst

@@ -1553,24 +1553,17 @@ as currency:
     {# pass in the 3 optional arguments #}
     {{ product.price|price(2, ',', '.') }}
 
-Create a class that extends ``AbstractExtension`` and fill in the logic::
+Create a class and fill in the logic::
 
     // src/Twig/AppExtension.php
     namespace App\Twig;
 
-    use Twig\Extension\AbstractExtension;
-    use Twig\TwigFilter;
+    use Twig\Attribute\AsTwigTest;
 
-    class AppExtension extends AbstractExtension
+    class AppExtension
     {
-        public function getFilters(): array
-        {
-            return [
-                new TwigFilter('price', [$this, 'formatPrice']),
-            ];
-        }
-
-        public function formatPrice(float $number, int $decimals = 0, string $decPoint = '.', string $thousandsSep = ','): string
+        #[AsTwigFilter('price')]
+        public static function formatPrice(float $number, int $decimals = 0, string $decPoint = '.', string $thousandsSep = ','): string
         {
             $price = number_format($number, $decimals, $decPoint, $thousandsSep);
             $price = '$'.$price;
@@ -1579,30 +1572,45 @@ Create a class that extends ``AbstractExtension`` and fill in the logic::
         }
     }
 
-If you want to create a function instead of a filter, define the
-``getFunctions()`` method::
+If you want to create a function instead of a filter, use the
+``AsTwigFunction`` attribute::
 
     // src/Twig/AppExtension.php
     namespace App\Twig;
 
-    use Twig\Extension\AbstractExtension;
-    use Twig\TwigFunction;
+    use Twig\Attribute\AsTwigFunction;
 
-    class AppExtension extends AbstractExtension
+    class AppExtension
     {
-        public function getFunctions(): array
+        #[AsTwigFunction('area')]
+        public static function calculateArea(int $width, int $length): int
         {
-            return [
-                new TwigFunction('area', [$this, 'calculateArea']),
-            ];
+            return $width * $length;
         }
+    }
+
+You can also create a test using the ``AsTwigTest`` attribute::
 
-        public function calculateArea(int $width, int $length): int
+    // src/Twig/AppExtension.php
+    namespace App\Twig;
+
+    use Twig\Attribute\AsTwigTest;
+
+    class AppExtension
+    {
+        #[AsTwigTest('even')]
+        public static function isEven(int $number): bool
         {
-            return $width * $length;
+            return $number % 2 === 0;
         }
     }
 
+.. versionadded:: 7.3
+
+    The ``AsTwigFilter``, ``AsTwigFunction`` and ``AsTwigTest`` attributes were introduced in Symfony 7.3.
+    Before Symfony 7.3, you had to implement the ``getFilters()``, ``getFunctions()`` methods.
+    See the `Twig Extensions`_ for more information.
+
 .. tip::
 
     Along with custom filters and functions, you can also register
@@ -1616,7 +1624,7 @@ using the :ref:`default services.yaml configuration <service-container-services-
 you're done! Symfony will automatically know about your new service and add the tag.
 
 You can now start using your filter in any Twig template. Optionally, execute
-this command to confirm that your new filter was successfully registered:
+this command to confirm that your new filter was successfully registeredstatic :
 
 .. code-block:: terminal
 
@@ -1636,6 +1644,11 @@ is the simplest way to create extensions. However, Twig must initialize all
 extensions before rendering any template, even if the template doesn't use an
 extension.
 
+.. note::
+
+   When using the ``AsTwigFilter``, ``AsTwigFunction`` or ``AsTwigTest`` attributes,
+   lazy loading is performed automatically..
+
 If extensions don't define dependencies (i.e. if you don't inject services in
 them) performance is not affected. However, if extensions define lots of complex
 dependencies (e.g. those making database connections), the performance loss can