Merge branch '3.4' into 4.0

* 3.4:
  tweaking language
  fix(syntax): added a space before has
  fix(tip): Add the tip block for realpth_cache_size
  [FIX](Realpath)
  Show controller tag for PHP configuration
  Change order of configuration types
  remove needless PHP version
  Update without_class.rst
  [#8767] fix list item termination character
  Typo
  added Tobias Nyholm in the core team

Author: weaverryan

contributing/code/core_team.rst

@@ -81,7 +81,10 @@ Active Core Members
     components and the SecurityBundle_;
 
   * **Maxime Steinhausser** (`ogizanagi`_) can merge into Config_, Console_,
-    Form_, Serializer_, DependencyInjection_, and HttpKernel_ components.
+    Form_, Serializer_, DependencyInjection_, and HttpKernel_ components;
+
+  * **Tobias Nyholm** (`Nyholm`) manages the official and contrib recipes
+    repositories.
 
 * **Deciders** (``@symfony/deciders`` on GitHub):
 
@@ -223,4 +226,4 @@ discretion of the **Project Leader**.
 .. _`lyrixx`: https://github.com/lyrixx/
 .. _`chalasr`: https://github.com/chalasr/
 .. _`ogizanagi`: https://github.com/ogizanagi/
-.. _`csarrazi`: https://github.com/csarrazi/
+.. _`Nyholm`: https://github.com/Nyholm

form/without_class.rst

@@ -63,7 +63,7 @@ an array.
 Adding Validation
 -----------------
 
-The only missing piece is validation. Usually, when you call ``$form->isValid()``,
+The only missing piece is validation. Usually, when you call ``$form->handleRequest($request)``,
 the object is validated by reading the constraints that you applied to that
 class. If your form is mapped to an object (i.e. you're using the ``data_class``
 option or passing an object to your form), this is almost always the approach

performance.rst

@@ -79,14 +79,12 @@ real and absolute file system paths. This increases the performance for
 applications like Symfony that open many PHP files, especially on Windows
 systems.
 
-By default, PHP sets a ``realpath_cache_size`` of ``16K`` which is too low for
-Symfony. Consider updating this value at least to ``4096K``. In addition, cached
-paths are only stored for ``120`` seconds by default. Consider updating this
-value too using the ``realpath_cache_ttl`` option:
+Consider increasing the ``realpath_cache_size`` and ``realpath_cache_ttl``:
 
 .. code-block:: ini
 
     ; php.ini
+    ; 4096k is the default value in PHP 7.2
     realpath_cache_size=4096K
     realpath_cache_ttl=600
 

reference/constraints/Expression.rst

@@ -60,15 +60,6 @@ One way to accomplish this is with the Expression constraint:
 
 .. configuration-block::
 
-    .. code-block:: yaml
-
-        # config/validator/validation.yaml
-        App\Model\BlogPost:
-            constraints:
-                - Expression:
-                    expression: "this.getCategory() in ['php', 'symfony'] or !this.isTechnicalPost()"
-                    message: "If this is a tech post, the category should be either php or symfony!"
-
     .. code-block:: php-annotations
 
         // src/Model/BlogPost.php
@@ -87,6 +78,15 @@ One way to accomplish this is with the Expression constraint:
             // ...
         }
 
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Model\BlogPost:
+            constraints:
+                - Expression:
+                    expression: "this.getCategory() in ['php', 'symfony'] or !this.isTechnicalPost()"
+                    message: "If this is a tech post, the category should be either php or symfony!"
+
     .. code-block:: xml
 
         <!-- config/validator/validation.xml -->
@@ -141,16 +141,6 @@ more about the expression language syntax, see
 
     .. configuration-block::
 
-        .. code-block:: yaml
-
-            # config/validator/validation.yaml
-            App\Model\BlogPost:
-                properties:
-                    isTechnicalPost:
-                        - Expression:
-                            expression: "this.getCategory() in ['php', 'symfony'] or value == false"
-                            message: "If this is a tech post, the category should be either php or symfony!"
-
         .. code-block:: php-annotations
 
             // src/Model/BlogPost.php
@@ -173,6 +163,16 @@ more about the expression language syntax, see
                 // ...
             }
 
+        .. code-block:: yaml
+
+            # config/validator/validation.yaml
+            App\Model\BlogPost:
+                properties:
+                    isTechnicalPost:
+                        - Expression:
+                            expression: "this.getCategory() in ['php', 'symfony'] or value == false"
+                            message: "If this is a tech post, the category should be either php or symfony!"
+
         .. code-block:: xml
 
             <!-- config/validator/validation.xml -->

service_container/3.3-di-changes.rst

@@ -364,6 +364,7 @@ The third big change is that, in a new Symfony 3.3 project, your controllers are
 
         // ...
 
+        $definition->addTag('controller.service_arguments');
         $this->registerClasses($definition, 'App\\Controller\\', '../src/Controller/*');
 
 But, you might not even notice this. First, your controllers *can* still extend