Skip to content

Commit 664fd09

Browse files
committed
Merge branch '5.4' into 6.3
* 5.4: [Configuration] Emphasize env vars purpose
2 parents cf0e26f + 149876b commit 664fd09

File tree

1 file changed

+9
-4
lines changed

1 file changed

+9
-4
lines changed

configuration.rst

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -606,10 +606,15 @@ different scenarios: staging, quality assurance, client review, etc.)
606606
Configuration Based on Environment Variables
607607
--------------------------------------------
608608

609-
Using `environment variables`_ (or "env vars" for short) is a common practice to
610-
configure options that depend on where the application is run (e.g. the database
611-
credentials are usually different in production versus your local machine). If
612-
the values are sensitive, you can even :doc:`encrypt them as secrets </configuration/secrets>`.
609+
Using `environment variables`_ (or "env vars" for short) is a common practice to:
610+
611+
* Configure options that depend on where the application is run (e.g. the database
612+
credentials are usually different in production versus your local machine);
613+
* Configure options that can change dynamically in a production environment (e.g.
614+
to update the value of an expired API key without having to redeploy the entire
615+
application).
616+
617+
In other cases, it's recommended to keep using :ref:`configuration parameters <configuration-parameters>`.
613618

614619
Use the special syntax ``%env(ENV_VAR_NAME)%`` to reference environment variables.
615620
The values of these options are resolved at runtime (only once per request, to

0 commit comments

Comments
 (0)