diff --git a/configuration.rst b/configuration.rst index ebdef340f0c..f526b3a692e 100644 --- a/configuration.rst +++ b/configuration.rst @@ -792,7 +792,9 @@ the right situation: but the overrides only apply to one environment. *Real* environment variables always win over env vars created by any of the -``.env`` files. +``.env`` files. This behavior depends on +`variables_order `_ to +contain an ``E`` to expose the ``$_ENV`` superglobal. The ``.env`` and ``.env.`` files should be committed to the repository because they are the same for all developers and machines. However,