From 6b73dda6da1c114619cf9e4fe33a3ce8839f6e99 Mon Sep 17 00:00:00 2001 From: Martin Melka Date: Mon, 10 Jan 2022 11:42:55 +0100 Subject: [PATCH] Note that env vars are not always compatible with options There are cases where environment variables cannot be used in place of regular configuration options. This commit makes the limitation explicit. From https://github.com/symfony/symfony/issues/39902 --- configuration.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/configuration.rst b/configuration.rst index 1c0c9dd21c3..dc435894686 100644 --- a/configuration.rst +++ b/configuration.rst @@ -602,6 +602,10 @@ You can reference environment variables using the special syntax ``%env(ENV_VAR_NAME)%``. The values of these options are resolved at runtime (only once per request, to not impact performance). +Note that not all config options are compatible with environment variables. There are +`cases `_ which may require refactoring +the config definition in order to work with environment variables. + This example shows how you could configure the database connection using an env var: .. configuration-block::