Merge branch '6.4' into 7.0

* 6.4:
  Changing `enum:` example away from APP_ENV

Author: javiereguiluz

configuration/env_var_processors.rst

@@ -741,11 +741,13 @@ Symfony provides the following env var processors:
     Tries to convert an environment variable to an actual ``\BackedEnum`` value.
     This processor takes the fully qualified name of the ``\BackedEnum`` as an argument::
 
-        # App\Enum\Environment
+        // App\Enum\Suit.php
         enum Environment: string
         {
-            case Development = 'dev';
-            case Production = 'prod';
+            case Clubs = 'clubs';
+            case Spades = 'spades';
+            case Diamonds = 'diamonds';
+            case Hearts = 'hearts';
         }
 
     .. configuration-block::
@@ -754,7 +756,7 @@ Symfony provides the following env var processors:
 
             # config/services.yaml
             parameters:
-                typed_env: '%env(enum:App\Enum\Environment:APP_ENV)%'
+                suit: '%env(enum:App\Enum\Suit:CARD_SUIT)%'
 
         .. code-block:: xml
 
@@ -769,14 +771,17 @@ Symfony provides the following env var processors:
                     https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
                 <parameters>
-                    <parameter key="typed_env">%env(enum:App\Enum\Environment:APP_ENV)%</parameter>
+                    <parameter key="suit">%env(enum:App\Enum\Suit:CARD_SUIT)%</parameter>
                 </parameters>
             </container>
 
         .. code-block:: php
 
             // config/services.php
-            $container->setParameter('typed_env', '%env(enum:App\Enum\Environment:APP_ENV)%');
+            $container->setParameter('suit', '%env(enum:App\Enum\Suit:CARD_SUIT)%');
+
+    The value stored in the ``CARD_SUIT`` env var would be a string (e.g. ``'spades'``)
+    but the application will use the enum value (e.g. ``Suit::Spades``).
 
 ``env(defined:NO_FOO)``
     Evaluates to ``true`` if the env var exists and its value is not ``''``