minor symfony#17673 [Config] Introducing the new param() function as early as possible (ThomasLandauer)

javiereguiluz · javiereguiluz · commit 1a02013fe4df · 2023-06-06T12:37:32.000+02:00
This PR was squashed before being merged into the 5.4 branch. Discussion ---------- [Config] Introducing the new `param()` function as early as possible Commits ------- a4c1261 [Config] Introducing the new `param()` function as early as possible
diff --git a/configuration.rst b/configuration.rst
@@ -304,8 +304,6 @@ configuration file using a special syntax: wrap the parameter name in two ``%``
             # any string surrounded by two % is replaced by that parameter value
             email_address: '%app.admin_email%'
 
-            # ...
-
     .. code-block:: xml
 
         <!-- config/packages/some_package.xml -->
@@ -328,13 +326,17 @@ configuration file using a special syntax: wrap the parameter name in two ``%``
 
         // config/packages/some_package.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+        use function Symfony\Component\DependencyInjection\Loader\Configurator\param;
 
         return static function (ContainerConfigurator $container) {
             $container->extension('some_package', [
-                // any string surrounded by two % is replaced by that parameter value
-                'email_address' => '%app.admin_email%',
+                // when using the param() function, you only have to pass the parameter name...
+                'email_address' => param('app.admin_email'),
 
-                // ...
+                // ... but if you prefer it, you can also pass the name as a string
+                // surrounded by two % (same as in YAML and XML formats) and Symfony will
+                // replace it by that parameter value
+                'email_address' => '%app.admin_email%',
             ]);
         };
 
