[TwigBundle] Enable #[AsTwigFilter], #[AsTwigFunction] and #[AsTwigTest]

quick_tour/the_architecture.rst

@@ -165,8 +165,8 @@ that extends ``AbstractExtension``::
     namespace App\Twig;
 
     use App\GreetingGenerator;
+    use Twig\Attribute\AsTwigFilter;
     use Twig\Extension\AbstractExtension;
-    use Twig\TwigFilter;
 
     class GreetExtension extends AbstractExtension
     {
@@ -175,13 +175,7 @@ that extends ``AbstractExtension``::
         ) {
         }
 
-        public function getFilters(): array
-        {
-            return [
-                new TwigFilter('greet', [$this, 'greetUser']),
-            ];
-        }
-
+        #[AsTwigFilter('greet')]
         public function greetUser(string $name): string
         {
             $greeting =  $this->greetingGenerator->getRandomGreeting();

reference/attributes.rst

@@ -123,6 +123,8 @@ Twig
 ~~~~
 
 * :ref:`Template <templates-template-attribute>`
+* :ref:`AsTwigFilter <templates-twig-filter-attribute>`
+* :ref:`AsTwigFunction <templates-twig-function-attribute>`
 
 Symfony UX
 ~~~~~~~~~~

templates.rst

@@ -1553,23 +1553,19 @@ as currency:
     {# pass in the 3 optional arguments #}
     {{ product.price|price(2, ',', '.') }}
 
+.. _templates-twig-filter-attribute:
+
 Create a class that extends ``AbstractExtension`` and fill in the logic::
 
     // src/Twig/AppExtension.php
     namespace App\Twig;
 
+    use Twig\Attribute\AsTwigFilter;
     use Twig\Extension\AbstractExtension;
-    use Twig\TwigFilter;
 
     class AppExtension extends AbstractExtension
     {
-        public function getFilters(): array
-        {
-            return [
-                new TwigFilter('price', [$this, 'formatPrice']),
-            ];
-        }
-
+        #[AsTwigFilter('price')]
         public function formatPrice(float $number, int $decimals = 0, string $decPoint = '.', string $thousandsSep = ','): string
         {
             $price = number_format($number, $decimals, $decPoint, $thousandsSep);
@@ -1579,24 +1575,20 @@ 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::
+.. _templates-twig-function-attribute:
+
+If you want to create a function instead of a filter, use the
+``AsTwigFunction`` attribute::
 
     // src/Twig/AppExtension.php
     namespace App\Twig;
 
+    use Twig\Attribute\AsTwigFunction;
     use Twig\Extension\AbstractExtension;
-    use Twig\TwigFunction;
 
     class AppExtension extends AbstractExtension
     {
-        public function getFunctions(): array
-        {
-            return [
-                new TwigFunction('area', [$this, 'calculateArea']),
-            ];
-        }
-
+        #[AsTwigFunction('area')]
         public function calculateArea(int $width, int $length): int
         {
             return $width * $length;
@@ -1608,6 +1600,11 @@ If you want to create a function instead of a filter, define the
     Along with custom filters and functions, you can also register
     `global variables`_.
 
+.. versionadded:: 7.3
+
+    Support for the ``#[AsTwigFilter]`` and ``#[AsTwigFunction]`` attributes was introduced in Symfony 7.3.
+    Previously, you had to use the ``getFilters()`` and ``getFunctions()`` methods.
+
 Register an Extension as a Service
 ..................................
 
@@ -1634,7 +1631,7 @@ Creating Lazy-Loaded Twig Extensions
 Including the code of the custom filters/functions in the Twig extension class
 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.
+extension. Note that if you use attributes, this part is not needed.
 
 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