minor #11865 Debug container environment variables (javiereguiluz)

javiereguiluz · javiereguiluz · commit 9a873fbc4c5f · 2019-07-03T11:15:54.000+02:00
This PR was squashed before being merged into the 4.3 branch (closes #11865). Discussion ---------- Debug container environment variables This replaces #11637 and fixes #11278. Commits ------- f5c0554 Debug container environment variables
diff --git a/configuration.rst b/configuration.rst
@@ -445,6 +445,32 @@ In order to define the actual values of env vars, Symfony proposes different
 solutions depending if the application is running in production or in your local
 development machine.
 
+Independent from the way you set environmnet variables, you may need to run the
+``debug:container`` command with the ``--env-vars`` option to verify that they
+are defined and have the expected values:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:container --env-vars
+
+    ---------------- ----------------- ---------------------------------------------
+     Name             Default value     Real value
+    ---------------- ----------------- ---------------------------------------------
+     APP_SECRET       n/a               "471a62e2d601a8952deb186e44186cb3"
+     FOO              "[1, "2.5", 3]"   n/a
+     BAR              null              n/a
+    ---------------- ----------------- ---------------------------------------------
+
+    # you can also filter the list of env vars by name:
+    $ php bin/console debug:container --env-vars foo
+
+    # run this command to show all the details for a specific env var:
+    $ php bin/console debug:container --env-var=FOO
+
+.. versionadded:: 4.3
+
+    The option to debug environment variables was introduced in Symfony 4.3.
+
 .. _configuration-env-var-in-dev:
 .. _config-dot-env:
 
