[Dotenv] Add SYMFONY_DOTENV_PATH

Author: alexandre-daubois

configuration.rst

@@ -932,6 +932,27 @@ get the environment variables and will not spend time parsing the ``.env`` files
     Update your deployment tools/workflow to run the ``dotenv:dump`` command after
     each deploy to improve the application performance.
 
+Store Environment Variables In Another File
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+By default, the environment variables are stored in the ``.env`` file located
+at the root of your project. However, you can store them in another file by
+setting the ``SYMFONY_DOTENV_PATH`` env var to the path and filename of the
+file where the environment variables are stored. Symfony will then look for
+the environment variables in that file, but also in the local and
+environment-specific files (e.g. ``.*.local`` and
+``.*.<environment>.local``). You can find more information about this
+in the :ref:`dedicated section <configuration-multiple-env-files>`.
+
+Because this env var is used to find the the files where you application env
+var are store, it must be defined at the system level (e.g. in your web server
+configuration) and not in the ``.env`` files.
+
+.. versionadded:: 7.1
+
+    The support for the ``SYMFONY_DOTENV_PATH`` env var was introduced in
+    Symfony 7.1.
+
 .. _configuration-secrets:
 
 Encrypting Environment Variables (Secrets)