TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:09 +02:00
commit af8cc155b5
6818 changed files with 642608 additions and 0 deletions
@@ -0,0 +1,41 @@
+.. include:: /Includes.rst.txt
+
+.. _feature-86409:
+
+============================================================================
+Feature: #86409 - Allow usage of environment variables in site configuration
+============================================================================
+
+See :issue:`86409`
+
+Description
+===========
+
+To enable environment variable based configuration the TYPO3 Core Yaml loader has been adjusted to
+be able to resolve environment variables. Resolving of variables in the loader can be enabled or
+disabled via flags. When editing the site configuration through the backend interface the resolving
+of environment variables needs to be disabled to be able to add environment configuration through
+the interface.
+
+The format for environment variables is :yaml:`%env(ENV_NAME)%`. Environment variables may be used to replace
+complete values or parts of a value.
+
+
+Impact
+======
+
+In site configuration environment variables can be used. One common example would be the base url
+that can now be configured via an environment variable.
+
+Additionally, the Yaml Loader class has two new flags: :yaml:`PROCESS_PLACEHOLDERS` and :yaml:`PROCESS_IMPORTS`.
+
+* :yaml:`PROCESS_PLACEHOLDERS` decides whether or not placeholders (`%abc%`) will be resolved.
+* :yaml:`PROCESS_IMPORTS` decides whether or not imports (`imports` key) will be resolved.
+
+Example usage in site configuration:
+
+.. code-block:: yaml
+
+    base: 'https://%env(BASE_DOMAIN)%/'
+
+.. index:: Backend, ext:core