Nov 29, 2025 · Nov 29, 2025 · Nov 29, 2025 · Nov 29, 2025
diff --git a/components/index.rst b/components/index.rst
 The Components
 ==============

 .. toctree::
    :maxdepth: 1
    :glob:

    using_components
    *
diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst

        .. code-block:: php

        // config/services.php
        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 // config/services.php
 namespace Symfony\Component\DependencyInjection\Loader\Configurator;

        return function(ContainerConfigurator $container): void {
            // ...
 return function(ContainerConfigurator $container): void {
 // ...

            $services->set(SomeService::class)
                ->arg('$host', '%env(string:key:host:url:DATABASE_URL)%')
                ->arg('$port', '%env(int:key:port:url:DATABASE_URL)%')
                ->arg('$username', '%env(string:key:user:url:DATABASE_URL)%')
                ->arg('$password', '%env(string:key:pass:url:DATABASE_URL)%')
                ->arg('$database_name', '%env(key:path:url:DATABASE_URL)%')
            ;
        };
 $services->set(SomeService::class)
 ->arg('$host', '%env(string:key:host:url:DATABASE_URL)%')
 ->arg('$port', '%env(int:key:port:url:DATABASE_URL)%')
 ->arg('$username', '%env(string:key:user:url:DATABASE_URL)%')
 ->arg('$password', '%env(string:key:pass:url:DATABASE_URL)%')
 ->arg('$database_name', '%env(key:path:url:DATABASE_URL)%')
 ;
 };

    .. warning::


        .. code-block:: php

        // config/services.php
        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 // config/services.php
 namespace Symfony\Component\DependencyInjection\Loader\Configurator;

        return function(ContainerConfigurator $container): void {
            // ...
 return function(ContainerConfigurator $container): void {
 // ...

            $services->set(SomeService::class)
                ->arg('$serverVersion', '%env(string:key:serverVersion:query_string:DATABASE_URL)%')
                ->arg('$charset', '%env(int:string:charset:query_string:DATABASE_URL)%')
            ;
        };
 $services->set(SomeService::class)
 ->arg('$serverVersion', '%env(string:key:serverVersion:query_string:DATABASE_URL)%')
 ->arg('$charset', '%env(int:string:charset:query_string:DATABASE_URL)%')
 ;
 };

 ``env(enum:FooEnum:BAR)``
    Tries to convert an environment variable to an actual ``\BackedEnum`` value.
diff --git a/contributing/core_team.rst b/contributing/core_team.rst
 * **Feature**: For new features and deprecations; Pull requests must be merged
  in the development branch.
 * **Bug**: Only for bug fixes; We are very conservative when it comes to
  merging older, but still maintained, branches. Read the :doc:`maintenance`
  merging older, but still maintained, branches. Read the :doc:`/contributing/code/maintenance`
  document for more information.
 * **Minor**: For everything that does not change the code or when they don't
  need to be listed in the CHANGELOG files: typos, Markdown files, test files,
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,9 @@
		The Components
		==============

		.. toctree::
		:maxdepth: 1
		:glob:

		using_components
		*
Original file line number	Diff line number	Diff line change
Expand Up		@@ -675,20 +675,20 @@ Symfony provides the following env var processors:

		.. code-block:: php

		// config/services.php
		namespace Symfony\Component\DependencyInjection\Loader\Configurator;
		// config/services.php
		namespace Symfony\Component\DependencyInjection\Loader\Configurator;

		return function(ContainerConfigurator $container): void {
		// ...
		return function(ContainerConfigurator $container): void {
		// ...

		$services->set(SomeService::class)
		->arg('$host', '%env(string:key:host:url:DATABASE_URL)%')
		->arg('$port', '%env(int:key:port:url:DATABASE_URL)%')
		->arg('$username', '%env(string:key:user:url:DATABASE_URL)%')
		->arg('$password', '%env(string:key:pass:url:DATABASE_URL)%')
		->arg('$database_name', '%env(key:path:url:DATABASE_URL)%')
		;
		};
		$services->set(SomeService::class)
		->arg('$host', '%env(string:key:host:url:DATABASE_URL)%')
		->arg('$port', '%env(int:key:port:url:DATABASE_URL)%')
		->arg('$username', '%env(string:key:user:url:DATABASE_URL)%')
		->arg('$password', '%env(string:key:pass:url:DATABASE_URL)%')
		->arg('$database_name', '%env(key:path:url:DATABASE_URL)%')
		;
		};

		.. warning::

Expand DownExpand Up		@@ -738,17 +738,17 @@ Symfony provides the following env var processors:

		.. code-block:: php

		// config/services.php
		namespace Symfony\Component\DependencyInjection\Loader\Configurator;
		// config/services.php
		namespace Symfony\Component\DependencyInjection\Loader\Configurator;

		return function(ContainerConfigurator $container): void {
		// ...
		return function(ContainerConfigurator $container): void {
		// ...

		$services->set(SomeService::class)
		->arg('$serverVersion', '%env(string:key:serverVersion:query_string:DATABASE_URL)%')
		->arg('$charset', '%env(int:string:charset:query_string:DATABASE_URL)%')
		;
		};
		$services->set(SomeService::class)
		->arg('$serverVersion', '%env(string:key:serverVersion:query_string:DATABASE_URL)%')
		->arg('$charset', '%env(int:string:charset:query_string:DATABASE_URL)%')
		;
		};

		``env(enum:FooEnum:BAR)``
		Tries to convert an environment variable to an actual ``\BackedEnum`` value.
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -231,7 +231,7 @@ following these rules:
		* Feature: For new features and deprecations; Pull requests must be merged
		in the development branch.
		* Bug: Only for bug fixes; We are very conservative when it comes to
		merging older, but still maintained, branches. Read the :doc:`maintenance`
		merging older, but still maintained, branches. Read the :doc:`/contributing/code/maintenance`
Copy link MemberAuthor wouterjNov 29, 2025• edited Loading Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. @OskarStark this might be an interesting one for DOCtor when you have time: we want all doc references to be absolute paths, so the links don't break when moving documents/sections. This has been a rule since forever, but every once in a while one relative path slips in :) Copy link Contributor OskarStarkNov 29, 2025 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. OK, I created an issue for DOCtor wouterj reacted with heart emoji
		document for more information.
		* Minor: For everything that does not change the code or when they don't
		need to be listed in the CHANGELOG files: typos, Markdown files, test files,
Expand Down