From b9f2a576b70c47363392ffd98d4c8d561a6b23b3 Mon Sep 17 00:00:00 2001
From: Gary PEGEOT <garypegeot@gmail.com>
Date: Wed, 28 Jun 2023 19:52:53 +0000
Subject: [PATCH]  [DependencyInjection] Add defined prefix for env var
 processor

Fixes #18462
---
 configuration/env_var_processors.rst | 37 ++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 937c0e341f6..562dc57420b 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -786,6 +786,43 @@ Symfony provides the following env var processors:
 
         The ``env(enum:...)`` env var processor was introduced in Symfony 6.2.
 
+``env(defined:NO_FOO)``
+    Evaluates to ``true`` if the env var is defined (ie: different from ``''`` or ``null``), ``false`` otherwise.
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/services.yaml
+            parameters:
+                typed_env: '%env(defined:NO_FOO)%'
+
+        .. 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="typed_env"'%env(defined:NO_FOO)%</parameter>
+                </parameters>
+            </container>
+
+        .. code-block:: php
+
+            // config/services.php
+            $container->setParameter('typed_env', '%env(defined:NO_FOO)%');
+
+    .. versionadded:: 6.4
+
+        The ``env(defined:...)`` env var processor was introduced in Symfony 6.4.
+
 It is also possible to combine any number of processors:
 
 .. configuration-block::