feature #14976 [DependencyInjection] Negated (not:) env var processor (bpolaszek)

OskarStark · OskarStark · commit 86a577af028c · 2021-02-15T08:29:02.000+01:00
This PR was squashed before being merged into the 5.3-dev branch. Discussion ---------- [DependencyInjection] Negated (not:) env var processor This PR adds documentation for symfony/symfony#40169: negated env var processor: ------ Casts to a bool (just as `env(bool:...)` does) except it returns the inverted value(falsy values are returned as `true`, truthy values are returned as `false`): ```yaml # config/services.yaml parameters: safe_for_production: '%env(not:APP_DEBUG)%' ``` Commits ------- 3ff812d [DependencyInjection] Negated (not:) env var processor
diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
@@ -136,6 +136,46 @@ Symfony provides the following env var processors:
                 'http_method_override' => '%env(bool:HTTP_METHOD_OVERRIDE)%',
             ]);
 
+``env(not:FOO)``
+
+    .. versionadded:: 5.3
+
+        The ``not:`` env var processor was introduced in Symfony 5.3.
+
+    Casts ``FOO`` to a bool (just as ``env(bool:...)`` does) except it returns the inverted value
+    (falsy values are returned as ``true``, truthy values are returned as ``false``):
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/services.yaml
+            parameters:
+                safe_for_production: '%env(not:APP_DEBUG)%'
+
+        .. code-block:: xml
+
+            <!-- config/services.xml -->
+            <?xml version="1.0" encoding="UTF-8" ?>
+            <container xmlns="http://symfony.com/schema/dic/services"
+                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+                xmlns:framework="http://symfony.com/schema/dic/symfony"
+                xsi:schemaLocation="http://symfony.com/schema/dic/services
+                    https://symfony.com/schema/dic/services/services-1.0.xsd
+                    http://symfony.com/schema/dic/symfony
+                    https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
+
+                <parameters>
+                    <parameter key="safe_for_production">%env(not:APP_DEBUG)%</parameter>
+                </parameters>
+
+            </container>
+
+        .. code-block:: php
+
+            // config/services.php
+            $container->setParameter('safe_for_production', '%env(not:APP_DEBUG)%');
+
 ``env(int:FOO)``
     Casts ``FOO`` to an int.
 
