Merge remote-tracking branch 'origin/4.4' into 4.4

* origin/4.4: (23 commits)
  Use .yaml instead of .yml
  Show DomCrawler results consistent
  Update mailer.rst
  auth_basic is a scalar type
  Update mailer.rst
  Remvove space before self-closing xml tag
  Update symfony 4 project structure
  fixes missing "use" declaration for the ClockMock
  Clarifying that you can't override real env vars
  [HttpClient] Documented the cancel() method
  Fixed typos
  fix constraint reference YAML config syntax
  [HttpClient] improve doc again
  Fixing docs about switch_user and custom voters
  [Mailer] Sort providers alphabetically
  Reword
  Typo
  Remove chrome debug since it's no longer present
  fix(DI): service name
  Fix several typos
  ...

Author: wouterj

bundles/best_practices.rst

@@ -306,26 +306,15 @@ following standardized instructions in your ``README.md`` file.
         ### Step 2: Enable the Bundle
 
         Then, enable the bundle by adding it to the list of registered bundles
-        in the `app/AppKernel.php` file of your project:
+        in the `config/bundles.php` file of your project:
 
         ```php
-        // app/AppKernel.php
-
-        // ...
-        class AppKernel extends Kernel
-        {
-            public function registerBundles()
-            {
-                $bundles = [
-                    // ...
-                    new <vendor>\<bundle-name>\<bundle-long-name>(),
-                ];
-
-                // ...
-            }
+        // config/bundles.php
 
+        return [
             // ...
-        }
+            <vendor>\<bundle-name>\<bundle-long-name>::class => ['all' => true],
+        ];
         ```
 
     .. code-block:: rst
@@ -362,26 +351,14 @@ following standardized instructions in your ``README.md`` file.
         ~~~~~~~~~~~~~~~~~~~~~~~~~
 
         Then, enable the bundle by adding it to the list of registered bundles
-        in the ``app/AppKernel.php`` file of your project::
-
-            // app/AppKernel.php
-
-            // ...
-            class AppKernel extends Kernel
-            {
-                public function registerBundles()
-                {
-                    $bundles = [
-                        // ...
-
-                        new <vendor>\<bundle-name>\<bundle-long-name>(),
-                    ];
+        in the ``config/bundles.php`` file of your project::
 
-                    // ...
-                }
+            // config/bundles.php
 
+            return [
                 // ...
-            }
+                <vendor>\<bundle-name>\<bundle-long-name>::class => ['all' => true],
+            ];
 
         .. _`installation chapter`: https://getcomposer.org/doc/00-intro.md
 

components/dom_crawler.rst

@@ -362,30 +362,34 @@ This behavior is best illustrated with examples::
     $crawler->addHtmlContent($html);
 
     $crawler->filterXPath('//span[contains(@id, "article-")]')->evaluate('substring-after(@id, "-")');
-    /* array:3 [
-      0 => "100"
-      1 => "101"
-      2 => "102"
-    ]
+    /* Result:
+    [
+        0 => '100',
+        1 => '101',
+        2 => '102',
+    ];
     */
 
     $crawler->evaluate('substring-after(//span[contains(@id, "article-")]/@id, "-")');
-    /* array:1 [
-      0 => "100"
+    /* Result:
+    [
+        0 => '100',
     ]
     */
 
     $crawler->filterXPath('//span[@class="article"]')->evaluate('count(@id)');
-    /* array:3 [
-      0 => 1.0
-      1 => 1.0
-      2 => 1.0
+    /* Result:
+    [
+        0 => 1.0,
+        1 => 1.0,
+        2 => 1.0,
     ]
     */
 
     $crawler->evaluate('count(//span[@class="article"])');
-    /* array:1 [
-      0 => 3.0
+    /* Result:
+    [
+        0 => 3.0,
     ]
     */