[!!!][TASK] Remove deprecated code from TableController
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / 9.5 / Feature-86409-AllowUsageOfEnvironmentVariablesInSiteConfiguration.rst
1 .. include:: ../../Includes.txt
2
3 ============================================================================
4 Feature: #86409 - Allow usage of environment variables in site configuration
5 ============================================================================
6
7 See :issue:`86409`
8
9 Description
10 ===========
11
12 To enable environment variable based configuration the TYPO3 Core Yaml loader has been adjusted to
13 be able to resolve environment variables. Resolving of variables in the loader can be enabled or
14 disabled via flags. When editing the site configuration through the backend interface the resolving
15 of environment variables needs to be disabled to be able to add environment configuration through
16 the interface.
17
18 The format for environment variables is `%env(ENV_NAME)%`. Environment variables may be used to replace
19 complete values or parts of a value.
20
21
22 Impact
23 ======
24
25 In site configuration environment variables can be used. One common example would be the base url
26 that can now be configured via an environment variable.
27
28 Additionally, the Yaml Loader class has two new flags: :yaml:`PROCESS_PLACEHOLDERS` and :yaml:`PROCESS_IMPORTS`.
29
30 * :yaml:`PROCESS_PLACEHOLDERS` decides whether or not placeholders (`%abc%`) will be resolved.
31 * :yaml:`PROCESS_IMPORTS` decides whether or not imports (`imports` key) will be resolved.
32
33 Example usage in site configuration:
34
35 .. code-block:: yaml
36
37 base: 'https://%env(BASE_DOMAIN)%/'
38
39 .. index:: Backend, ext:core