Skip to content

Commit d81b63d

Browse files
committed
docs: improve description for Environment Variables as Replacements for Data
1 parent a3b92fa commit d81b63d

1 file changed

Lines changed: 7 additions & 6 deletions

File tree

user_guide_src/source/general/configuration.rst

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -222,14 +222,15 @@ Since v4.1.5, you can also write with underscores::
222222
Environment Variables as Replacements for Data
223223
==============================================
224224

225-
It is very important to always remember that environment variables contained in your **.env** are
226-
**only replacements for existing data**.
225+
It is very important to always remember that environment variables contained in
226+
your **.env** are **only replacements for existing scalar values**.
227227

228-
Simply put, you can change only the property value that exists in the Config class
229-
by setting it in your **.env**.
228+
Simply put, you can change only the property's scalar value that exists in the
229+
Config class by setting it in your **.env**.
230230

231-
You cannot add a property that is not defined in the Config class, nor can you
232-
change it to an array if the value of the defined property is a scalar.
231+
1. You cannot add a property that is not defined in the Config class.
232+
2. You cannot change a scalar value in a property to an array.
233+
3. You cannot add an element to an existing array.
233234

234235
For example, you cannot just put ``app.myNewConfig = foo`` in your **.env** and
235236
expect your ``Config\App`` to magically have that property and value at run time.

0 commit comments

Comments
 (0)