[Translation] Give current locale to LocaleSwitcher::runWithLocale()'s callback

alexandre-daubois · alexandre-daubois · commit db92b3acbbc6 · 2023-09-20T16:50:18.000+02:00
diff --git a/translation.rst b/translation.rst
@@ -1062,17 +1062,32 @@ of:
             $this->localeSwitcher->reset();
 
             // you can also run some code with a certain locale, without
-            // changing the locale for the rest of the application
+            // changing the locale for the rest of the application.
             $this->localeSwitcher->runWithLocale('es', function() {
 
                 // e.g. render here some Twig templates using 'es' (Spanish) locale
 
             });
 
+            // you can optionally declare an argument in your callback to receive the
+            // injected locale
+            $this->localeSwitcher->runWithLocale('es', function(string $locale) {
+
+                // here, the $locale argument will be set to 'es'
+
+            });
+
             // ...
         }
     }
 
+.. versionadded:: 6.4
+
+    The support of declaring an argument in the callback to inject the locale
+    being used in the
+    :method:`Symfony\\Component\\Translation\\LocaleSwitcher::runWithLocale`
+    method was introduced in Symfony 6.4.
+
 When using :ref:`autowiring <services-autowire>`, type-hint any controller or
 service argument with the :class:`Symfony\\Component\\Translation\\LocaleSwitcher`
 class to inject the locale switcher service. Otherwise, configure your services
