Dec 7, 2024 · Dec 7, 2024 · Apr 22, 2024 · Dec 7, 2024 · Feb 1, 2023 · Dec 7, 2024
diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml

    #   master
    versionadded_directive_major_version:
        major_version:6
        major_version:7

    versionadded_directive_min_version:
        min_version: '6.0'
        min_version: '7.0'

    deprecated_directive_major_version:
        major_version:6
        major_version:7

    deprecated_directive_min_version:
        min_version: '6.0'
        min_version: '7.0'

 exclude_rule_for_file:
    - path: configuration/multiple_kernels.rst
diff --git a/_build/build.php b/_build/build.php

        $outputDir = __DIR__.'/output';
        $buildConfig = (new BuildConfig())
            ->setSymfonyVersion('6.4')
            ->setSymfonyVersion('7.1')
            ->setContentDir(__DIR__.'/..')
            ->setOutputDir($outputDir)
            ->setImagesDir(__DIR__.'/output/_images')
diff --git a/_build/redirection_map b/_build/redirection_map
 /serializer/normalizers /serializer#serializer-built-in-normalizers
 /logging/monolog_regex_based_excludes /logging/monolog_exclude_http_codes
 /security/named_encoders /security/named_hashers
 /components/inflector /components/string#inflector
 /components/inflector /string#inflector
 /security/experimental_authenticators /security
 /security/user_provider /security/user_providers
 /security/reset_password /security/passwords#reset-password
 /messenger/dispatch_after_current_bus /messenger#messenger-transactional-messages
 /messenger/multiple_buses /messenger#messenger-multiple-buses
 /frontend/encore/server-data /frontend/server-data
 /components/string /string
 /testing/http_authentication /testing#testing_logging_in_users
 /doctrine/registration_form /security#security-make-registration-form
 /form/form_dependencies /form/create_custom_field_type
 /doctrine/reverse_engineering /doctrine#doctrine-adding-mapping
 /components/serializer /serializer
 /serializer/custom_encoder /serializer/encoders#serializer-custom-encoder
diff --git a/_includes/_annotation_loader_tip.rst.inc b/_includes/_annotation_loader_tip.rst.inc
diff --git a/bundles.rst b/bundles.rst
    {
    }

 .. versionadded:: 6.1

    The :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle` was
    introduced in Symfony 6.1.

 .. warning::

    If your bundle must be compatible with previous Symfony versions you have to
diff --git a/bundles/configuration.rst b/bundles/configuration.rst
 Using the AbstractBundle Class
 ------------------------------

 .. versionadded:: 6.1

    The ``AbstractBundle`` class was introduced in Symfony 6.1.

 In bundles extending the :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`
 class, you can add all the logic related to processing the configuration in that class::

diff --git a/bundles/extension.rst b/bundles/extension.rst
 Loading Services Directly in your Bundle Class
 ----------------------------------------------

 .. versionadded:: 6.1

    The ``AbstractBundle`` class was introduced in Symfony 6.1.

 In bundles extending the :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`
 class, you can define the :method:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle::loadExtension`
 method to load service definitions from configuration files::
diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
 Prepending Extension in the Bundle Class
 ----------------------------------------

 .. versionadded:: 6.1

    The ``AbstractBundle`` class was introduced in Symfony 6.1.

 You can also prepend extension configuration directly in your
 Bundle class if you extend from the :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`
 class and define the :method:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle::prependExtension`
            $containerBuilder->prependExtensionConfig('framework', [
                'cache' => ['prefix_seed' => 'foo/bar'],
            ]);

            // prepend config from a file
            $containerConfigurator->import('../config/packages/cache.php');
        }
    }

 .. note::

    The ``prependExtension()`` method, like ``prepend()``, is called only at compile time.

 .. versionadded:: 7.1

    Starting from Symfony 7.1, calling the :method:`Symfony\\Component\\DependencyInjection\\Loader\\Configurator\\ContainerConfigurator::import`
    method inside ``prependExtension()`` will prepend the given configuration.
    In previous Symfony versions, this method appended the configuration.

 Alternatively, you can use the ``prepend`` parameter of the
 :method:`Symfony\\Component\\DependencyInjection\\Loader\\Configurator\\ContainerConfigurator::extension`
 method::

    use Symfony\Component\DependencyInjection\ContainerBuilder;
    use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;

    class FooBundle extends AbstractBundle
    {
        public function prependExtension(ContainerConfigurator $containerConfigurator, ContainerBuilder $containerBuilder): void
        {
            // ...

            $containerConfigurator->extension('framework', [
                'cache' => ['prefix_seed' => 'foo/bar'],
            ], prepend: true);

            // ...
        }
    }

 .. versionadded:: 7.1

    The ``prepend`` parameter of the
    :method:`Symfony\\Component\\DependencyInjection\\Loader\\Configurator\\ContainerConfigurator::extension`
    method was added in Symfony 7.1.

 More than one Bundle using PrependExtensionInterface
 ----------------------------------------------------

diff --git a/cache.rst b/cache.rst
                default_psr6_provider: 'app.my_psr6_service'
                default_redis_provider: 'redis://localhost'
                default_memcached_provider: 'memcached://localhost'
                default_pdo_provider: 'app.my_pdo_service'

        services:
            app.my_pdo_service:
                class: \PDO
                arguments: ['pgsql:host=localhost']
                default_pdo_provider: 'pgsql:host=localhost'

    .. code-block:: xml

                    default-psr6-provider="app.my_psr6_service"
                    default-redis-provider="redis://localhost"
                    default-memcached-provider="memcached://localhost"
                    default-pdo-provider="app.my_pdo_service"
                    default-pdo-provider="pgsql:host=localhost"
                />
            </framework:config>

            <services>
                <service id="app.my_pdo_service" class="\PDO">
                    <argument>pgsql:host=localhost</argument>
                </service>
            </services>
        </container>

    .. code-block:: php

        // config/packages/cache.php
        use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
        use Symfony\Config\FrameworkConfig;

        return static function (FrameworkConfig $framework, ContainerConfigurator $container): void {
        return static function (FrameworkConfig $framework): void {
            $framework->cache()
                // Only used with cache.adapter.filesystem
                ->directory('%kernel.cache_dir%/pools')
                ->defaultPsr6Provider('app.my_psr6_service')
                ->defaultRedisProvider('redis://localhost')
                ->defaultMemcachedProvider('memcached://localhost')
                ->defaultPdoProvider('app.my_pdo_service')
            ;

            $container->services()
                ->set('app.my_pdo_service', \PDO::class)
                ->args(['pgsql:host=localhost'])
                ->defaultPdoProvider('pgsql:host=localhost')
            ;
        };

 .. versionadded:: 7.1

    Using a DSN as the provider for the PDO adapter was introduced in Symfony 7.1.

 .. _cache-create-pools:

 Creating Custom (Namespaced) Pools

    $ php bin/console cache:pool:clear --all

 .. versionadded:: 6.3

    The ``--all`` option was introduced in Symfony 6.3.

 Clear all cache pools except some:

 .. code-block:: terminal

    $ php bin/console cache:pool:clear --all --exclude=my_cache_pool --exclude=another_cache_pool

 .. versionadded:: 6.4

    The ``--exclude`` option was introduced in Symfony 6.4.

 Clear all caches everywhere:

 .. code-block:: terminal

 Clear cache by tag(s):

 .. versionadded:: 6.1

    The ``cache:pool:invalidate-tags`` command was introduced in Symfony 6.1.

 .. code-block:: terminal

    # invalidate tag1 from all taggable pools
diff --git a/components/browser_kit.rst b/components/browser_kit.rst
    // ... and `clickLink()`
    $crawler = $client->clickLink('Go elsewhere...', ['X-Custom-Header' => 'Some data']);

 .. versionadded:: 6.4

    The ``serverParameters`` parameter was introduced in Symfony 6.4.

 Submitting Forms
 ~~~~~~~~~~~~~~~~

    $response = $browser->getResponse()->toArray();
    // $response is a PHP array of the decoded JSON contents

 .. versionadded:: 6.1

    The ``toArray()`` method was introduced in Symfony 6.1.

 Learn more
 ----------

diff --git a/components/cache.rst b/components/cache.rst
 the cache items before storing them.

 The :class:`Symfony\\Component\\Cache\\Marshaller\\DefaultMarshaller` uses PHP's
 ``serialize()``or``igbinary_serialize()`` if the `Igbinary extension`_ is installed.
 There are other *marshallers* that can encrypt or compressthedata before storing it::
 ``serialize()``function by default, but you can optionally use the``igbinary_serialize()``
 function fromthe`Igbinary extension`_::

    use Symfony\Component\Cache\Adapter\RedisAdapter;
    use Symfony\Component\Cache\DefaultMarshaller;
    use Symfony\Component\Cache\DeflateMarshaller;
    use Symfony\Component\Cache\Marshaller\DefaultMarshaller;
    use Symfony\Component\Cache\Marshaller\DeflateMarshaller;

    $marshaller = new DeflateMarshaller(new DefaultMarshaller());
    // you can optionally use the Igbinary extension if you have it installed
    // $marshaller = new DeflateMarshaller(new DefaultMarshaller(useIgbinarySerialize: true));

    $cache = new RedisAdapter(new \Redis(), 'namespace', 0, $marshaller);

 There are other *marshallers* that can encrypt or compress the data before storing it.

 .. versionadded:: 7.2

    In Symfony versions prior to 7.2, the ``igbinary_serialize()`` function was
    used by default when the Igbinary extension was installed. Starting from
    Symfony 7.2, you have to enable Igbinary support explicitly.

 Advanced Usage
 --------------

diff --git a/components/cache/adapters/array_cache_adapter.rst b/components/cache/adapters/array_cache_adapter.rst

        // the maximum number of items that can be stored in the cache. When the limit
        // is reached, cache follows the LRU model (least recently used items are deleted)
        $maxItems = 0
        $maxItems = 0,

        // optional implementation of the Psr\Clock\ClockInterface that will be used
        // to calculate the lifetime of cache items (for example to get predictable
        // lifetimes in tests)
        $clock = null,
    );

 .. versionadded:: 7.2

    The optional ``$clock`` argument was introduced in Symfony 7.2.
diff --git a/components/cache/adapters/couchbasebucket_adapter.rst b/components/cache/adapters/couchbasebucket_adapter.rst
 Couchbase Bucket Cache Adapter
 ==============================

 .. deprecated:: 7.1

    The ``CouchbaseBucketAdapter`` is deprecated since Symfony 7.1, use the
    :doc:`CouchbaseCollectionAdapter </components/cache/adapters/couchbasecollection_adapter>`
    instead.

 This adapter stores the values in-memory using one (or more) `Couchbase server`_
 instances. Unlike the :doc:`APCu adapter </components/cache/adapters/apcu_adapter>`, and similarly to the
 :doc:`Memcached adapter </components/cache/adapters/memcached_adapter>`, it is not limited to the current server's
diff --git a/components/cache/adapters/doctrine_dbal_adapter.rst b/components/cache/adapters/doctrine_dbal_adapter.rst
    necessary to detect the database engine and version without opening the
    connection.

 The adapter uses SQL syntax that is optimized for database server that it is connected to.
 The following database servers are known to be compatible:

 * MySQL 5.7 and newer
 * MariaDB 10.2 and newer
 * Oracle 10g and newer
 * SQL Server 2012 and newer
 * SQLite 3.24 or later
 * PostgreSQL 9.5 or later

 .. note::

    Newer releases of Doctrine DBAL might increase these minimal versions. Check
    the manual page on `Doctrine DBAL Platforms`_ if your database server is
    compatible with the installed Doctrine DBAL version.

 .. _`Doctrine DBAL Connection`: https://github.com/doctrine/dbal/blob/master/src/Connection.php
 .. _`Doctrine DBAL URL`: https://www.doctrine-project.org/projects/doctrine-dbal/en/latest/reference/configuration.html#connecting-using-a-url
 .. _`Doctrine DBAL URL`: https://www.doctrine-project.org/projects/doctrine-dbal/en/current/reference/configuration.html#connecting-using-a-url
 .. _`Doctrine DBAL Platforms`: https://www.doctrine-project.org/projects/doctrine-dbal/en/current/reference/platforms.html
Original file line number	Diff line number	Diff line change
Expand Up		@@ -74,16 +74,16 @@ rules:

		# master
		versionadded_directive_major_version:
		major_version:6
		major_version:7

		versionadded_directive_min_version:
		min_version: '6.0'
		min_version: '7.0'

		deprecated_directive_major_version:
		major_version:6
		major_version:7

		deprecated_directive_min_version:
		min_version: '6.0'
		min_version: '7.0'

		exclude_rule_for_file:
		- path: configuration/multiple_kernels.rst
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -27,7 +27,7 @@

		$outputDir = __DIR__.'/output';
		$buildConfig = (new BuildConfig())
		->setSymfonyVersion('6.4')
		->setSymfonyVersion('7.1')
		->setContentDir(__DIR__.'/..')
		->setOutputDir($outputDir)
		->setImagesDir(__DIR__.'/output/_images')
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -529,7 +529,7 @@
		/serializer/normalizers /serializer#serializer-built-in-normalizers
		/logging/monolog_regex_based_excludes /logging/monolog_exclude_http_codes
		/security/named_encoders /security/named_hashers
		/components/inflector /components/string#inflector
		/components/inflector /string#inflector
		/security/experimental_authenticators /security
		/security/user_provider /security/user_providers
		/security/reset_password /security/passwords#reset-password
Expand DownExpand Up		@@ -567,5 +567,10 @@
		/messenger/dispatch_after_current_bus /messenger#messenger-transactional-messages
		/messenger/multiple_buses /messenger#messenger-multiple-buses
		/frontend/encore/server-data /frontend/server-data
		/components/string /string
		/testing/http_authentication /testing#testing_logging_in_users
		/doctrine/registration_form /security#security-make-registration-form
		/form/form_dependencies /form/create_custom_field_type
		/doctrine/reverse_engineering /doctrine#doctrine-adding-mapping
		/components/serializer /serializer
		/serializer/custom_encoder /serializer/encoders#serializer-custom-encoder
Original file line number	Diff line number	Diff line change
Expand Up		@@ -58,11 +58,6 @@ Start by creating a new class called ``AcmeBlogBundle``::
		{
		}

		.. versionadded:: 6.1

		The :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle` was
		introduced in Symfony 6.1.

		.. warning::

		If your bundle must be compatible with previous Symfony versions you have to
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -61,10 +61,6 @@ There are two different ways of creating friendly configuration for a bundle:
		Using the AbstractBundle Class
		------------------------------

		.. versionadded:: 6.1

		The ``AbstractBundle`` class was introduced in Symfony 6.1.

		In bundles extending the :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`
		class, you can add all the logic related to processing the configuration in that class::

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -20,10 +20,6 @@ There are two different ways of doing it:
		Loading Services Directly in your Bundle Class
		----------------------------------------------

		.. versionadded:: 6.1

		The ``AbstractBundle`` class was introduced in Symfony 6.1.

		In bundles extending the :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`
		class, you can define the :method:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle::loadExtension`
		method to load service definitions from configuration files::
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -154,10 +154,6 @@ registered and the ``entity_manager_name`` setting for ``acme_hello`` is set to
		Prepending Extension in the Bundle Class
		----------------------------------------

		.. versionadded:: 6.1

		The ``AbstractBundle`` class was introduced in Symfony 6.1.

		You can also prepend extension configuration directly in your
		Bundle class if you extend from the :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`
		class and define the :method:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle::prependExtension`
Expand All		@@ -175,13 +171,50 @@ method::
		$containerBuilder->prependExtensionConfig('framework', [
		'cache' => ['prefix_seed' => 'foo/bar'],
		]);

		// prepend config from a file
		$containerConfigurator->import('../config/packages/cache.php');
		}
		}

		.. note::

		The ``prependExtension()`` method, like ``prepend()``, is called only at compile time.

		.. versionadded:: 7.1

		Starting from Symfony 7.1, calling the :method:`Symfony\\Component\\DependencyInjection\\Loader\\Configurator\\ContainerConfigurator::import`
		method inside ``prependExtension()`` will prepend the given configuration.
		In previous Symfony versions, this method appended the configuration.

		Alternatively, you can use the ``prepend`` parameter of the
		:method:`Symfony\\Component\\DependencyInjection\\Loader\\Configurator\\ContainerConfigurator::extension`
		method::

		use Symfony\Component\DependencyInjection\ContainerBuilder;
		use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
		use Symfony\Component\HttpKernel\Bundle\AbstractBundle;

		class FooBundle extends AbstractBundle
		{
		public function prependExtension(ContainerConfigurator $containerConfigurator, ContainerBuilder $containerBuilder): void
		{
		// ...

		$containerConfigurator->extension('framework', [
		'cache' => ['prefix_seed' => 'foo/bar'],
		], prepend: true);

		// ...
		}
		}

		.. versionadded:: 7.1

		The ``prepend`` parameter of the
		:method:`Symfony\\Component\\DependencyInjection\\Loader\\Configurator\\ContainerConfigurator::extension`
		method was added in Symfony 7.1.

		More than one Bundle using PrependExtensionInterface
		----------------------------------------------------

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -133,12 +133,7 @@ Some of these adapters could be configured via shortcuts.
		default_psr6_provider: 'app.my_psr6_service'
		default_redis_provider: 'redis://localhost'
		default_memcached_provider: 'memcached://localhost'
		default_pdo_provider: 'app.my_pdo_service'

		services:
		app.my_pdo_service:
		class: \PDO
		arguments: ['pgsql:host=localhost']
		default_pdo_provider: 'pgsql:host=localhost'

		.. code-block:: xml

Expand All		@@ -159,24 +154,17 @@ Some of these adapters could be configured via shortcuts.
		default-psr6-provider="app.my_psr6_service"
		default-redis-provider="redis://localhost"
		default-memcached-provider="memcached://localhost"
		default-pdo-provider="app.my_pdo_service"
		default-pdo-provider="pgsql:host=localhost"
		/>
		</framework:config>

		<services>
		<service id="app.my_pdo_service" class="\PDO">
		<argument>pgsql:host=localhost</argument>
		</service>
		</services>
		</container>

		.. code-block:: php

		// config/packages/cache.php
		use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
		use Symfony\Config\FrameworkConfig;

		return static function (FrameworkConfig $framework, ContainerConfigurator $container): void {
		return static function (FrameworkConfig $framework): void {
		$framework->cache()
		// Only used with cache.adapter.filesystem
		->directory('%kernel.cache_dir%/pools')
Expand All		@@ -185,15 +173,14 @@ Some of these adapters could be configured via shortcuts.
		->defaultPsr6Provider('app.my_psr6_service')
		->defaultRedisProvider('redis://localhost')
		->defaultMemcachedProvider('memcached://localhost')
		->defaultPdoProvider('app.my_pdo_service')
		;

		$container->services()
		->set('app.my_pdo_service', \PDO::class)
		->args(['pgsql:host=localhost'])
		->defaultPdoProvider('pgsql:host=localhost')
		;
		};

		.. versionadded:: 7.1

		Using a DSN as the provider for the PDO adapter was introduced in Symfony 7.1.

		.. _cache-create-pools:

		Creating Custom (Namespaced) Pools
Expand DownExpand Up		@@ -744,20 +731,12 @@ Clear all cache pools:

		$ php bin/console cache:pool:clear --all

		.. versionadded:: 6.3

		The ``--all`` option was introduced in Symfony 6.3.

		Clear all cache pools except some:

		.. code-block:: terminal

		$ php bin/console cache:pool:clear --all --exclude=my_cache_pool --exclude=another_cache_pool

		.. versionadded:: 6.4

		The ``--exclude`` option was introduced in Symfony 6.4.

		Clear all caches everywhere:

		.. code-block:: terminal
Expand All		@@ -766,10 +745,6 @@ Clear all caches everywhere:

		Clear cache by tag(s):

		.. versionadded:: 6.1

		The ``cache:pool:invalidate-tags`` command was introduced in Symfony 6.1.

		.. code-block:: terminal

		# invalidate tag1 from all taggable pools
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -130,10 +130,6 @@ on a link::
		// ... and `clickLink()`
		$crawler = $client->clickLink('Go elsewhere...', ['X-Custom-Header' => 'Some data']);

		.. versionadded:: 6.4

		The ``serverParameters`` parameter was introduced in Symfony 6.4.

		Submitting Forms
		~~~~~~~~~~~~~~~~

Expand DownExpand Up		@@ -403,10 +399,6 @@ to call ``json_decode()`` explicitly::
		$response = $browser->getResponse()->toArray();
		// $response is a PHP array of the decoded JSON contents

		.. versionadded:: 6.1

		The ``toArray()`` method was introduced in Symfony 6.1.

		Learn more
		----------

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -208,16 +208,27 @@ Symfony uses marshallers (classes which implement
		the cache items before storing them.

		The :class:`Symfony\\Component\\Cache\\Marshaller\\DefaultMarshaller` uses PHP's
		``serialize()``or``igbinary_serialize()`` if the `Igbinary extension`_ is installed.
		There are other marshallers that can encrypt or compressthedata before storing it::
		``serialize()``function by default, but you can optionally use the``igbinary_serialize()``
		function fromthe`Igbinary extension`_::

		use Symfony\Component\Cache\Adapter\RedisAdapter;
		use Symfony\Component\Cache\DefaultMarshaller;
		use Symfony\Component\Cache\DeflateMarshaller;
		use Symfony\Component\Cache\Marshaller\DefaultMarshaller;
		use Symfony\Component\Cache\Marshaller\DeflateMarshaller;

		$marshaller = new DeflateMarshaller(new DefaultMarshaller());
		// you can optionally use the Igbinary extension if you have it installed
		// $marshaller = new DeflateMarshaller(new DefaultMarshaller(useIgbinarySerialize: true));

		$cache = new RedisAdapter(new \Redis(), 'namespace', 0, $marshaller);

		There are other marshallers that can encrypt or compress the data before storing it.

		.. versionadded:: 7.2

		In Symfony versions prior to 7.2, the ``igbinary_serialize()`` function was
		used by default when the Igbinary extension was installed. Starting from
		Symfony 7.2, you have to enable Igbinary support explicitly.

		Advanced Usage
		--------------

Expand Down