May 29, 2019 · May 29, 2019 · May 29, 2019 · May 29, 2019 · May 29, 2019 · May 29, 2019
diff --git a/bundles/configuration.rst b/bundles/configuration.rst
        }
    }

 .. deprecated:: 4.2

    Not passing the root node name to ``TreeBuilder`` was deprecated in Symfony 4.2.

 .. seealso::

    The ``Configuration`` class can be much more complicated than shown here,
diff --git a/cache.rst b/cache.rst
 Symfony supports the Cache Contracts, PSR-6/16 and Doctrine Cache interfaces.
 You can read more about these at the :doc:`component documentation </components/cache>`.

 .. versionadded:: 4.2

    The cache contracts were introduced in Symfony 4.2.

 .. _cache-configuration-with-frameworkbundle:

 Configuring Cache with FrameworkBundle

    $ php bin/console cache:pool:list

 .. versionadded:: 4.3

    The ``cache:pool:list`` command was introduced in Symfony 4.3.

 Clear one pool:

 .. code-block:: terminal
diff --git a/components/cache/adapters/memcached_adapter.rst b/components/cache/adapters/memcached_adapter.rst
        'memcached:?host[localhost]&host[localhost:12345]&host[/some/memcached.sock:]=3'
    );

 .. versionadded:: 4.2

    The option to define multiple servers in a single DSN was introduced in Symfony 4.2.

 The `Data Source Name (DSN)`_ for this adapter must use the following format:

 .. code-block:: text
diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
        'redis:?host[redis1:26379]&host[redis2:26379]&host[redis3:26379]&redis_sentinel=mymaster'
    );

 .. versionadded:: 4.2

    The option to define multiple servers in a single DSN was introduced in Symfony 4.2.

 .. versionadded:: 4.4

    Redis Sentinel support was introduced in Symfony 4.4.

 .. note::

    See the :class:`Symfony\\Component\\Cache\\Traits\\RedisTrait` for more options
diff --git a/components/cache/psr6_psr16_adapters.rst b/components/cache/psr6_psr16_adapters.rst
    // now use this wherever you want
    $githubApiClient = new GitHubApiClient($psr6Cache);

 .. versionadded:: 4.3

    The ``Psr16Adapter`` class was introduced in Symfony 4.3.

 Using a PSR-6 Cache Object as a PSR-16 Cache
 --------------------------------------------

    // now use this wherever you want
    $githubApiClient = new GitHubApiClient($psr16Cache);

 .. versionadded:: 4.3

    The ``Psr16Cache`` class was introduced in Symfony 4.3.

 .. _`PSR-16`: http://www.php-fig.org/psr/psr-16/
diff --git a/components/config/definition.rst b/components/config/definition.rst
        }
    }

 .. deprecated:: 4.2

    Not passing the root node name to ``TreeBuilder`` was deprecated in Symfony 4.2.

 Adding Node Definitions to the Tree
 -----------------------------------

diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
     1/2 [==============>-------------]  50%
     2/2 [============================] 100%

 .. versionadded:: 4.3

    The ``iterate()`` method was introduced in Symfony 4.3.

 Customizing the Progress Bar
 ----------------------------

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
        $filePath = $helper->ask($input, $output, $question);
    }

 .. versionadded:: 4.3

    The ``setAutocompleterCallback()`` method was introduced in Symfony 4.3.

 Hiding the User's Response
 ~~~~~~~~~~~~~~~~~~~~~~~~~~

diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
    The DomCrawler component will use it automatically when the content has
    an HTML5 doctype.

    .. versionadded:: 4.3

        The automatic support of the html5-php library was introduced in Symfony 4.3.

 Node Filtering
 ~~~~~~~~~~~~~~

    // avoid the exception passing an argument that text() returns when node does not exist
    $message = $crawler->filterXPath('//body/p')->text('Default text content');

 .. versionadded:: 4.3

    The default argument of ``text()`` was introduced in Symfony 4.3.

 Access the attribute value of the first node of the current selection::

    $class = $crawler->filterXPath('//body/p')->attr('class');
    Special attribute ``_text`` represents a node value, while ``_name``
    represents the element name (the HTML tag name).

    .. versionadded:: 4.3

        The special attribute ``_name`` was introduced in Symfony 4.3.

 Call an anonymous function on each node of the list::

    use Symfony\Component\DomCrawler\Crawler;
        // avoid the exception passing an argument that html() returns when node does not exist
        $html = $crawler->html('Default <strong>HTML</strong> content');

    .. versionadded:: 4.3

        The default argument of ``html()`` was introduced in Symfony 4.3.

 Expression Evaluation
 ~~~~~~~~~~~~~~~~~~~~~

diff --git a/components/dotenv.rst b/components/dotenv.rst
 environments by passing them as additional arguments to ``Dotenv::loadEnv()``
 (see :method:`Symfony\\Component\\Dotenv\\Dotenv::loadEnv` for details).

 .. versionadded:: 4.2

    The ``Dotenv::loadEnv()`` method was introduced in Symfony 4.2.

 You should never store a ``.env`` file in your code repository as it might
 contain sensitive information; create a ``.env.dist`` file (or multiple
 environment-specific ones as shown above) with sensible defaults instead.
diff --git a/components/finder.rst b/components/finder.rst
    // excludes files/directories matching the .gitignore patterns
    $finder->ignoreVCSIgnored(true);

 .. versionadded:: 4.3

    The ``ignoreVCSIgnored()`` method was introduced in Symfony 4.3.

 File Name
 ~~~~~~~~~

    // same as above
    $finder->notPath(['first/dir', 'other/dir']);

 .. versionadded:: 4.2

    Support for passing arrays to ``notPath()`` was introduced in Symfony
    4.2

 File Size
 ~~~~~~~~~

diff --git a/components/http_client.rst b/components/http_client.rst
    PHP stream wrappers and cURL. It provides utilities to consume APIs and
    supports synchronous and asynchronous operations.

 .. versionadded:: 4.3

    The HttpClient component was introduced in Symfony 4.3.

 Installation
 ------------

diff --git a/components/intl.rst b/components/intl.rst

    $isValidLanguage = Languages::exists($languageCode);

 .. versionadded:: 4.3

    The ``Languages`` class was introduced in Symfony 4.3.

 The ``Scripts`` class provides access to the optional four-letter script code
 that can follow the language code according to the `Unicode ISO 15924 Registry`_
 (e.g. ``HANS`` in ``zh_HANS`` for simplified Chinese and ``HANT`` in ``zh_HANT``

    $isValidScript = Scripts::exists($scriptCode);

 .. versionadded:: 4.3

    The ``Scripts`` class was introduced in Symfony 4.3.

 Country Names
 ~~~~~~~~~~~~~


    $isValidCountry = Countries::exists($countryCode);

 .. versionadded:: 4.3

    The ``Countries`` class was introduced in Symfony 4.3.

 Locales
 ~~~~~~~


    $isValidLocale = Locales::exists($localeCode);

 .. versionadded:: 4.3

    The ``Locales`` class was introduced in Symfony 4.3.

 Currencies
 ~~~~~~~~~~


    $isValidCurrency = Currencies::exists($currencyCode);

 .. versionadded:: 4.3

    The ``Currencies`` class was introduced in Symfony 4.3.

 Timezones
 ~~~~~~~~~


    $isValidTimezone = Timezones::exists($timezoneId);

 .. versionadded:: 4.3

    The ``Timezones`` class was introduced in Symfony 4.3.

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

diff --git a/components/lock.rst b/components/lock.rst
 MongoDbStore
 ~~~~~~~~~~~~

 .. versionadded:: 4.3

    The ``MongoDbStore`` was introduced in Symfony 4.3.

 The MongoDbStore saves locks on a MongoDB server, it requires a
 ``\MongoDB\Client`` connection from `mongodb/mongodb`_. This store does not
 support blocking and expects a TTL to avoid stalled locks::
diff --git a/components/messenger.rst b/components/messenger.rst
 When using the message bus with Symfony's FrameworkBundle, the following middleware
 are configured for you:

 #. :class:`Symfony\\Component\\Messenger\\Middleware\\LoggingMiddleware` (logs the processing of your messages)
 #. :class:`Symfony\\Component\\Messenger\\Middleware\\SendMessageMiddleware` (enables asynchronous processing)
 #. :class:`Symfony\\Component\\Messenger\\Middleware\\SendMessageMiddleware` (enables asynchronous processing, logs the processing of your messages if you pass a logger)
 #. :class:`Symfony\\Component\\Messenger\\Middleware\\HandleMessageMiddleware` (calls the registered handler(s))

 .. deprecated:: 4.3

    The ``LoggingMiddleware`` is deprecated since Symfony 4.3 and will be
    removed in 5.0. Pass a logger to ``SendMessageMiddleware`` instead.

 Example::

    use App\Message\MyMessage;
diff --git a/components/options_resolver.rst b/components/options_resolver.rst
 value, otherwise you can prepend the new normalizer by passing ``true`` as
 third argument.

 .. versionadded:: 4.3

    The ``addNormalizer()`` method was introduced in Symfony 4.3.

 Default Values that Depend on another Option
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

diff --git a/components/property_access.rst b/components/property_access.rst
 Accessing a non Existing Property Path
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 .. versionadded:: 4.3

    The ``disableExceptionOnInvalidPropertyPath()`` method was introduced in
    Symfony 4.3.

 By default a :class:`Symfony\\Component\\PropertyAccess\\Exception\\NoSuchPropertyException`
 is thrown if the property path passed to :method:`PropertyAccessor::getValue<Symfony\\Component\\PropertyAccess\\PropertyAccessor::getValue>`
 does not exist. You can change this behavior using the
diff --git a/components/routing.rst b/components/routing.rst
            ;
        };

 .. versionadded:: 4.3

    The ``utf8`` option/method has been introduced in Symfony 4.3.
    Before you had to use the ``options`` setting to define this value (for
    example, when using annotations: ``options={"utf8": true}``).

 In this route, the ``utf8`` option set to ``true`` makes Symfony consider the
 ``.`` requirement to match any UTF-8 characters instead of just a single
 byte character. This means that so the following URLs would match:
diff --git a/components/security/authentication.rst b/components/security/authentication.rst
 The ``Symfony\Component\Security\Http\Event\DeauthenticatedEvent`` event is triggered when a token has been deauthenticated
 because of a user change, it can help you doing some clean-up task when a logout has been triggered.

 .. versionadded:: 4.3

    The ``Symfony\Component\Security\Http\Event\DeauthenticatedEvent`` event was introduced in Symfony 4.3.

 .. seealso::

    For more information on switching users, see
diff --git a/components/serializer.rst b/components/serializer.rst
 arrays of objects. Those will still be replaced when present in the normalized
 data.

 .. versionadded:: 4.3

    The ``AbstractObjectNormalizer::DEEP_OBJECT_TO_POPULATE`` option was
    introduced in Symfony 4.3.

 .. _component-serializer-attributes-groups:

 Attributes Groups
    $serializer = new Serializer([$normalizer], [$encoder]);
    $serializer->serialize($person, 'json', ['ignored_attributes' => ['age']]); // Output: {"name":"foo"}

 .. deprecated:: 4.2

    The :method:`Symfony\\Component\\Serializer\\Normalizer\\AbstractNormalizer::setIgnoredAttributes`
    method that was used as an alternative to the ``ignored_attributes`` option
    was deprecated in Symfony 4.2.

 .. _component-serializer-converting-property-names-when-serializing-and-deserializing:

 Converting Property Names when Serializing and Deserializing
 Using Callbacks to Serialize Properties with Object Instances
 -------------------------------------------------------------

 .. deprecated:: 4.2

    The :method:`Symfony\\Component\\Serializer\\Normalizer\\AbstractNormalizer::setCallbacks`
    method is deprecated since Symfony 4.2. Use the ``callbacks``
    key of the context instead.

 When serializing, you can set a callback to format a specific object property::

    use App\Model\Person;
            'createdAt' => $callback,
        ],
    ];


    $normalizer = new GetSetMethodNormalizer(null, null, null, null, null, $defaultContext);

    $serializer = new Serializer([$normalizer], [$encoder]);
 You can pass the context key ``as_collection`` in order to have the results
 always as a collection.

 .. deprecated:: 4.2

    Relying on the default value ``false`` is deprecated since Symfony 4.2.

 The ``XmlEncoder``
 ~~~~~~~~~~~~~~~~~~
Original file line number	Diff line number	Diff line change
Expand Up		@@ -197,10 +197,6 @@ The ``Configuration`` class to handle the sample configuration looks like::
		}
		}

		.. deprecated:: 4.2

		Not passing the root node name to ``TreeBuilder`` was deprecated in Symfony 4.2.

		.. seealso::

		The ``Configuration`` class can be much more complicated than shown here,
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -30,10 +30,6 @@ Basic uses of the cache looks like this::
		Symfony supports the Cache Contracts, PSR-6/16 and Doctrine Cache interfaces.
		You can read more about these at the :doc:`component documentation </components/cache>`.

		.. versionadded:: 4.2

		The cache contracts were introduced in Symfony 4.2.

		.. _cache-configuration-with-frameworkbundle:

		Configuring Cache with FrameworkBundle
Expand DownExpand Up		@@ -612,10 +608,6 @@ To see all available cache pools:

		$ php bin/console cache:pool:list

		.. versionadded:: 4.3

		The ``cache:pool:list`` command was introduced in Symfony 4.3.

		Clear one pool:

		.. code-block:: terminal
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -70,10 +70,6 @@ helper method allows creating and configuring a `Memcached`_ class instance usin
		'memcached:?host[localhost]&host[localhost:12345]&host[/some/memcached.sock:]=3'
		);

		.. versionadded:: 4.2

		The option to define multiple servers in a single DSN was introduced in Symfony 4.2.

		The `Data Source Name (DSN)`_ for this adapter must use the following format:

		.. code-block:: text
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -102,14 +102,6 @@ name of your service group::
		'redis:?host[redis1:26379]&host[redis2:26379]&host[redis3:26379]&redis_sentinel=mymaster'
		);

		.. versionadded:: 4.2

		The option to define multiple servers in a single DSN was introduced in Symfony 4.2.

		.. versionadded:: 4.4

		Redis Sentinel support was introduced in Symfony 4.4.

		.. note::

		See the :class:`Symfony\\Component\\Cache\\Traits\\RedisTrait` for more options
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -46,10 +46,6 @@ this use-case::
		// now use this wherever you want
		$githubApiClient = new GitHubApiClient($psr6Cache);

		.. versionadded:: 4.3

		The ``Psr16Adapter`` class was introduced in Symfony 4.3.

		Using a PSR-6 Cache Object as a PSR-16 Cache
		--------------------------------------------

Expand DownExpand Up		@@ -87,8 +83,4 @@ this use-case::
		// now use this wherever you want
		$githubApiClient = new GitHubApiClient($psr16Cache);

		.. versionadded:: 4.3

		The ``Psr16Cache`` class was introduced in Symfony 4.3.

		.. _`PSR-16`: http://www.php-fig.org/psr/psr-16/
Original file line number	Diff line number	Diff line change
Expand Up		@@ -68,10 +68,6 @@ implements the :class:`Symfony\\Component\\Config\\Definition\\ConfigurationInte
		}
		}

		.. deprecated:: 4.2

		Not passing the root node name to ``TreeBuilder`` was deprecated in Symfony 4.2.

		Adding Node Definitions to the Tree
		-----------------------------------

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -118,10 +118,6 @@ If ``$iterable = [1, 2]``, the previous code will output the following:
		1/2 [==============>-------------] 50%
		2/2 [============================] 100%

		.. versionadded:: 4.3

		The ``iterate()`` method was introduced in Symfony 4.3.

		Customizing the Progress Bar
		----------------------------

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -212,10 +212,6 @@ provide a callback function to dynamically generate suggestions::
		$filePath = $helper->ask($input, $output, $question);
		}

		.. versionadded:: 4.3

		The ``setAutocompleterCallback()`` method was introduced in Symfony 4.3.

		Hiding the User's Response
		~~~~~~~~~~~~~~~~~~~~~~~~~~

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -77,10 +77,6 @@ tree.
		The DomCrawler component will use it automatically when the content has
		an HTML5 doctype.

		.. versionadded:: 4.3

		The automatic support of the html5-php library was introduced in Symfony 4.3.

		Node Filtering
		~~~~~~~~~~~~~~

Expand DownExpand Up		@@ -216,10 +212,6 @@ Access the value of the first node of the current selection::
		// avoid the exception passing an argument that text() returns when node does not exist
		$message = $crawler->filterXPath('//body/p')->text('Default text content');

		.. versionadded:: 4.3

		The default argument of ``text()`` was introduced in Symfony 4.3.

		Access the attribute value of the first node of the current selection::

		$class = $crawler->filterXPath('//body/p')->attr('class');
Expand All		@@ -236,10 +228,6 @@ Extract attribute and/or node values from the list of nodes::
		Special attribute ``_text`` represents a node value, while ``_name``
		represents the element name (the HTML tag name).

		.. versionadded:: 4.3

		The special attribute ``_name`` was introduced in Symfony 4.3.

		Call an anonymous function on each node of the list::

		use Symfony\Component\DomCrawler\Crawler;
Expand DownExpand Up		@@ -333,10 +321,6 @@ and :phpclass:`DOMNode` objects::
		// avoid the exception passing an argument that html() returns when node does not exist
		$html = $crawler->html('Default <strong>HTML</strong> content');

		.. versionadded:: 4.3

		The default argument of ``html()`` was introduced in Symfony 4.3.

		Expression Evaluation
		~~~~~~~~~~~~~~~~~~~~~

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -104,10 +104,6 @@ You can adjust the variable defining the environment, default environment and te
		environments by passing them as additional arguments to ``Dotenv::loadEnv()``
		(see :method:`Symfony\\Component\\Dotenv\\Dotenv::loadEnv` for details).

		.. versionadded:: 4.2

		The ``Dotenv::loadEnv()`` method was introduced in Symfony 4.2.

		You should never store a ``.env`` file in your code repository as it might
		contain sensitive information; create a ``.env.dist`` file (or multiple
		environment-specific ones as shown above) with sensible defaults instead.
Expand Down