minor #11311 Adds deprecation for non-string env values. (dbrumann, javiereguiluz)

wouterj · wouterj · commit 711a1bf30e5a · 2019-04-06T16:53:16.000+02:00
This PR was merged into the master branch. Discussion ---------- Adds deprecation for non-string env values. Fixes #11279 Commits ------- 77f390b Made the deprecation notice more concise b733aea Adds deprecation for non-string env values.
diff --git a/configuration/environment_variables.rst b/configuration/environment_variables.rst
@@ -77,7 +77,7 @@ whenever the corresponding environment variable is *not* found:
 
         # config/services.yaml
         parameters:
-            env(DATABASE_HOST): localhost
+            env(DATABASE_HOST): 'localhost'
 
     .. code-block:: xml
 
@@ -97,6 +97,12 @@ whenever the corresponding environment variable is *not* found:
         // config/services.php
         $container->setParameter('env(DATABASE_HOST)', 'localhost');
 
+.. deprecated:: 4.3
+
+    Passing non-string values as default values for environment variables is
+    deprecated since Symfony 4.3. Use :ref:`environment variable processors <env-var-processors>`
+    if you need to transform those string default values into other data types.
+
 .. _configuration-env-var-in-prod:
 
 Configuring Environment Variables in Production
@@ -132,6 +138,8 @@ the following:
     :doc:`Symfony profiler </profiler>`. In practice this shouldn't be a
     problem because the web profiler must **never** be enabled in production.
 
+.. _env-var-processors:
+
 Environment Variable Processors
 -------------------------------
 
