symfony · JohnyProkie · Sep 26, 2019 · Sep 26, 2019 · Sep 26, 2019 · Sep 26, 2019
diff --git a/_images/quick_tour/no_routes_page.png b/_images/quick_tour/no_routes_page.png
diff --git a/bundles.rst b/bundles.rst
@@ -85,8 +85,7 @@ Bundle Directory Structure
 
 The directory structure of a bundle is meant to help to keep code consistent
 between all Symfony bundles. It follows a set of conventions, but is flexible
-to be adjusted if needed. Take a look at AcmeDemoBundle, as it contains some
-of the most common elements of a bundle:
+to be adjusted if needed:
 
 ``Controller/``
     Contains the controllers of the bundle (e.g. ``RandomController.php``).
@@ -118,6 +117,35 @@ database, create and validate forms, create translations for your application,
 write tests and much more. Each of these has their own place and role within
 the bundle.
 
+Overridding the Bundle Directory Structure
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Some of the bundle directories are conventions that can be overridden if needed.
+For example, the **public directory**, which by default is located at
+``<your-bundle>/Resources/public/``, can be changed by defining the
+``getPublicDir()`` method in the bundle class::
+
+    // src/Acme/TestBundle/AcmeTestBundle.php
+    namespace App\Acme\TestBundle;
+
+    use Symfony\Component\HttpKernel\Bundle\Bundle;
+
+    class AcmeTestBundle extends Bundle
+    {
+        // ...
+
+        // the returned value must be relative to the bundle root directory
+        // (public dir is now <your-bundle>/public/ instead of <your-bundle>/Resources/public/)
+        public function getPublicDir(): string
+        {
+            return 'public/';
+        }
+    }
+
+.. versionadded:: 4.4
+
+    The ``getPublicDir()`` method was introduced in Symfony 4.4.
+
 Learn more
 ----------
 

diff --git a/cache.rst b/cache.rst
@@ -234,7 +234,7 @@ You can also create more customized pools:
                     <framework:pool name="my_cache_pool" adapter="cache.adapter.array"/>
                     <framework:pool name="acme.cache" adapter="cache.adapter.memcached"/>
                     <framework:pool name="foobar.cache" adapter="cache.adapter.memcached" provider="memcached://user:password@example.com"/>
-                    <framework:pool name="short_cache" adapter="foobar.cache" default_lifetime="60"/>
+                    <framework:pool name="short_cache" adapter="foobar.cache" default-lifetime="60"/>
                 </framework:cache>
             </framework:config>
         </container>
@@ -390,6 +390,10 @@ If an error happens when storing an item in a pool, Symfony stores it in the
 other pools and no exception is thrown. Later, when the item is retrieved,
 Symfony stores the item automatically in all the missing pools.
 
+.. versionadded:: 4.4
+
+    Support for configuring a chain using ``framework.cache.pools`` was introduced in Symfony 4.4.
+
 .. configuration-block::
 
     .. code-block:: yaml
@@ -399,23 +403,11 @@ Symfony stores the item automatically in all the missing pools.
             cache:
                 pools:
                     my_cache_pool:
-                        adapter: cache.adapter.psr6
-                        provider: app.my_cache_chain_adapter
-                    cache.my_redis:
-                        adapter: cache.adapter.redis
-                        provider: 'redis://user:password@example.com'
-                    cache.apcu:
-                        adapter: cache.adapter.apcu
-                    cache.array:
-                        adapter: cache.adapter.array
-
-
-        services:
-            app.my_cache_chain_adapter:
-                class: Symfony\Component\Cache\Adapter\ChainAdapter
-                arguments:
-                    - ['@cache.array', '@cache.apcu', '@cache.my_redis']
-                    - 31536000 # One year
+                        default_lifetime: 31536000  # One year
+                        adapters:
+                          - cache.adapter.array
+                          - cache.adapter.apcu
+                          - {name: cache.adapter.redis, provider: 'redis://user:password@example.com'}
 
     .. code-block:: xml
 
@@ -429,23 +421,13 @@ Symfony stores the item automatically in all the missing pools.
 
             <framework:config>
                 <framework:cache>
-                    <framework:pool name="my_cache_pool" adapter="cache.adapter.psr6" provider="app.my_cache_chain_adapter"/>
-                    <framework:pool name="cache.my_redis" adapter="cache.adapter.redis" provider="redis://user:password@example.com"/>
-                    <framework:pool name="cache.apcu" adapter="cache.adapter.apcu"/>
-                    <framework:pool name="cache.array" adapter="cache.adapter.array"/>
+                    <framework:pool name="my_cache_pool" default-lifetime="31536000">
+                        <framework:adapter name="cache.adapter.array"/>
+                        <framework:adapter name="cache.adapter.apcu"/>
+                        <framework:adapter name="cache.adapter.redis" provider="redis://user:password@example.com"/>
+                    </framework:pool>
                 </framework:cache>
             </framework:config>
-
-            <services>
-                <service id="app.my_cache_chain_adapter" class="Symfony\Component\Cache\Adapter\ChainAdapter">
-                    <argument type="collection">
-                        <argument type="service" value="cache.array"/>
-                        <argument type="service" value="cache.apcu"/>
-                        <argument type="service" value="cache.my_redis"/>
-                    </argument>
-                    <argument>31536000</argument>
-                </service>
-            </services>
         </container>
 
     .. code-block:: php
@@ -455,39 +437,17 @@ Symfony stores the item automatically in all the missing pools.
             'cache' => [
                 'pools' => [
                     'my_cache_pool' => [
-                        'adapter' => 'cache.adapter.psr6',
-                        'provider' => 'app.my_cache_chain_adapter',
-                    ],
-                    'cache.my_redis' => [
-                        'adapter' => 'cache.adapter.redis',
-                        'provider' => 'redis://user:password@example.com',
-                    ],
-                    'cache.apcu' => [
-                        'adapter' => 'cache.adapter.apcu',
-                    ],
-                    'cache.array' => [
-                        'adapter' => 'cache.adapter.array',
+                        'default_lifetime' => 31536000, // One year
+                        'adapters' => [
+                            'cache.adapter.array',
+                            'cache.adapter.apcu',
+                            ['name' => 'cache.adapter.redis', 'provider' => 'redis://user:password@example.com'],
+                        ],
                     ],
                 ],
             ],
         ]);
 
-        $container->getDefinition('app.my_cache_chain_adapter', \Symfony\Component\Cache\Adapter\ChainAdapter::class)
-            ->addArgument([
-                new Reference('cache.array'),
-                new Reference('cache.apcu'),
-                new Reference('cache.my_redis'),
-            ])
-            ->addArgument(31536000);
-
-.. note::
-
-    In this configuration the ``my_cache_pool`` pool is using the ``cache.adapter.psr6``
-    adapter and the ``app.my_cache_chain_adapter`` service as a provider. That is
-    because ``ChainAdapter`` does not support the ``cache.pool`` tag. So it is decorated
-    with the ``ProxyAdapter``.
-
-
 Using Cache Tags
 ----------------
 

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
@@ -106,6 +106,10 @@ name of your service group::
 
     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/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
@@ -50,10 +50,16 @@ you can also set the current progress by calling the
 
     If your platform doesn't support ANSI codes, updates to the progress
     bar are added as new lines. To prevent the output from being flooded,
-    adjust the
+    use the method :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::minSecondsBetweenRedraws`
+    to limit the number of redraws and the method
     :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::setRedrawFrequency`
-    accordingly. By default, when using a ``max``, the redraw frequency
-    is set to *10%* of your ``max``.
+    to redraw every N iterations. By default, redraw frequency is
+    **100ms** or **10%** of your ``max``.
+
+    .. versionadded:: 4.4
+
+        The ``minSecondsBetweenRedraws()`` and ``maxSecondsBetweenRedraws()``
+        methods were introduced in Symfony 4.4.
 
 If you don't know the exact number of steps in advance, set it to a reasonable
 value and then call the ``setMaxSteps()`` method to update it as needed::
@@ -289,17 +295,19 @@ to display it can be customized::
 
 .. caution::
 
-    For performance reasons, be careful if you set the total number of steps
-    to a high number. For example, if you're iterating over a large number of
-    items, consider setting the redraw frequency to a higher value by calling
-    :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::setRedrawFrequency`,
-    so it updates on only some iterations::
+    For performance reasons, Symfony redraws screen every 100ms. If this is too
+    fast or to slow for your application, use the methods
+    :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::minSecondsBetweenRedraws` and
+    :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::maxSecondsBetweenRedraws`::
 
         $progressBar = new ProgressBar($output, 50000);
         $progressBar->start();
 
-        // update every 100 iterations
+        // this redraws the screen every 100 iterations, but sets additional limits:
+        // don't redraw slower than 200ms (0.2) or faster than 100ms (0.1)
         $progressBar->setRedrawFrequency(100);
+        $progressBar->maxSecondsBetweenRedraws(0.2);
+        $progressBar->minSecondsBetweenRedraws(0.1);
 
         $i = 0;
         while ($i++ < 50000) {
@@ -308,6 +316,11 @@ to display it can be customized::
             $progressBar->advance();
         }
 
+    .. versionadded:: 4.4
+
+        The ``minSecondsBetweenRedraws`` and ``maxSecondsBetweenRedraws()`` methods
+        were introduced in Symfony 4.4.
+
 Custom Placeholders
 ~~~~~~~~~~~~~~~~~~~
 

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
@@ -218,6 +218,30 @@ provide a callback function to dynamically generate suggestions::
 
     The ``setAutocompleterCallback()`` method was introduced in Symfony 4.3.
 
+Do not Trim the Answer
+~~~~~~~~~~~~~~~~~~~~~~
+
+You can also specify if you want to not trim the answer by setting it directly with
+:method:`Symfony\\Component\\Console\\Question\\Question::setTrimmable`::
+
+    use Symfony\Component\Console\Question\Question;
+
+    // ...
+    public function execute(InputInterface $input, OutputInterface $output)
+    {
+        // ...
+        $helper = $this->getHelper('question');
+
+        $question = new Question('What is the name of the child?');
+        $question->setTrimmable(false);
+        // if the users inputs 'elsa ' it will not be trimmed and you will get 'elsa ' as value
+        $name = $helper->ask($input, $output, $question);
+    }
+
+.. versionadded:: 4.4
+
+    The ``setTrimmable()`` method was introduced in Symfony 4.4.
+
 Hiding the User's Response
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 

diff --git a/components/css_selector.rst b/components/css_selector.rst
@@ -91,11 +91,16 @@ Pseudo-elements (``:before``, ``:after``, ``:first-line``,
 ``:first-letter``) are not supported because they select portions of text
 rather than elements.
 
-Several pseudo-classes are not yet supported:
+Pseudo-classes are partially supported:
 
-* ``*:first-of-type``, ``*:last-of-type``, ``*:nth-of-type``,
-  ``*:nth-last-of-type``, ``*:only-of-type``. (These work with an element
-  name (e.g. ``li:first-of-type``) but not with ``*``).
+* Not supported: ``*:first-of-type``, ``*:last-of-type``, ``*:nth-of-type`` and
+  ``*:nth-last-of-type`` (all these work with an element name (e.g.
+  ``li:first-of-type``) but not with the ``*`` selector).
+* Supported: ``*:only-of-type``.
+
+.. versionadded:: 4.4
+
+    The support for ``*:only-of-type`` was introduced in Symfony 4.4.
 
 Learn more
 ----------

diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
@@ -165,6 +165,14 @@ Namespaces can be explicitly registered with the
     $crawler->registerNamespace('m', 'http://search.yahoo.com/mrss/');
     $crawler = $crawler->filterXPath('//m:group//yt:aspectRatio');
 
+Verify if the current node matches a selector::
+
+    $crawler->matches('p.lorem');
+
+.. versionadded:: 4.4
+
+    The ``matches()`` method was introduced in Symfony 4.4.
+
 Node Traversing
 ~~~~~~~~~~~~~~~
 
@@ -195,6 +203,14 @@ Get all the direct child nodes matching a CSS selector::
 
     $crawler->filter('body')->children('p.lorem');
 
+Get the first parent (heading toward the document root) of the element that matches the provided selector::
+
+    $crawler->closest('p.lorem');
+
+.. versionadded:: 4.4
+
+    The ``closest()`` method was introduced in Symfony 4.4.
+
 .. note::
 
     All the traversal methods return a new :class:`Symfony\\Component\\DomCrawler\\Crawler`
@@ -216,10 +232,18 @@ 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');
 
+    // pass TRUE as the second argument of text() to remove all extra white spaces, including
+    // the internal ones (e.g. "  foo\n  bar    baz \n " is returned as "foo bar baz")
+    $crawler->filterXPath('//body/p')->text('Default text content', true);
+
 .. versionadded:: 4.3
 
     The default argument of ``text()`` was introduced in Symfony 4.3.
 
+.. versionadded:: 4.4
+
+    The option to trim white spaces in ``text()`` was introduced in Symfony 4.4.
+
 Access the attribute value of the first node of the current selection::
 
     $class = $crawler->filterXPath('//body/p')->attr('class');
@@ -337,6 +361,15 @@ and :phpclass:`DOMNode` objects::
 
         The default argument of ``html()`` was introduced in Symfony 4.3.
 
+    Or you can get the outer HTML of the first node using
+    :method:`Symfony\\Component\\DomCrawler\\Crawler::outerHtml`::
+
+        $html = $crawler->outerHtml();
+
+    .. versionadded:: 4.4
+
+        The ``outerHtml()`` method was introduced in Symfony 4.4.
+
 Expression Evaluation
 ~~~~~~~~~~~~~~~~~~~~~
 
@@ -485,8 +518,12 @@ The :class:`Symfony\\Component\\DomCrawler\\Form` object has lots of very
 useful methods for working with forms::
 
     $uri = $form->getUri();
-
     $method = $form->getMethod();
+    $name = $form->getName();
+
+.. versionadded:: 4.4
+
+    The ``getName()`` method was introduced in Symfony 4.4.
 
 The :method:`Symfony\\Component\\DomCrawler\\Form::getUri` method does more
 than just return the ``action`` attribute of the form. If the form method

diff --git a/components/dotenv.rst b/components/dotenv.rst
@@ -149,6 +149,17 @@ Use environment variables in values by prefixing variables with ``$``:
     its value will depend on the ``DB_USER`` value defined in other files
     instead of the value defined in this file.
 
+Define a default value in case the environment variable is not set:
+
+.. code-block:: terminal
+
+    DB_USER=
+    DB_PASS=${DB_USER:-root}pass # results in DB_PASS=rootpass
+
+.. versionadded:: 4.4
+
+    The support for default values has been introduced in Symfony 4.4.
+
 Embed commands via ``$()`` (not supported on Windows):
 
 .. code-block:: terminal