Merge branch '3.3' into 3.4

weaverryan · weaverryan · commit c35d58a46283 · 2017-12-30T14:30:49.000-05:00
* 3.3:
  Added Symfony\Component\Security\Guard\Authenticator\AbstractFormLoginAuthenticator
  Reworded the note about supressing form validation
  [PropertyInfo] Fixed doc about PhpDocExtractor
  Update web_server_configuration.rst
  Update http_foundation.rst
diff --git a/components/property_info.rst b/components/property_info.rst
@@ -379,7 +379,7 @@ PhpDocExtractor
 
 .. note::
 
-    This extractor depends on the `phpdocumentor/reflection`_ library.
+    This extractor depends on the `phpdocumentor/reflection-docblock`_ library.
 
 Using `phpDocumentor Reflection`_ to parse property and method annotations,
 the :class:`Symfony\\Component\\PropertyInfo\\Extractor\\PhpDocExtractor`
@@ -481,8 +481,8 @@ service by defining it as a service with one or more of the following
 * ``property_info.access_extractor`` if it provides access information.
 
 .. _Packagist: https://packagist.org/packages/symfony/property-info
-.. _`phpDocumentor Reflection`: https://github.com/phpDocumentor/Reflection
-.. _`phpdocumentor/reflection`: https://packagist.org/packages/phpdocumentor/reflection
+.. _`phpDocumentor Reflection`: https://github.com/phpDocumentor/ReflectionDocBlock
+.. _`phpdocumentor/reflection-docblock`: https://packagist.org/packages/phpdocumentor/reflection-docblock
 .. _`Doctrine ORM`: http://www.doctrine-project.org/projects/orm.html
 .. _`symfony/serializer`: https://packagist.org/packages/symfony/serializer
 .. _`symfony/doctrine-bridge`: https://packagist.org/packages/symfony/doctrine-bridge
diff --git a/create_framework/http_foundation.rst b/create_framework/http_foundation.rst
@@ -285,15 +285,15 @@ the wheel.
 
 I've almost forgot to talk about one added benefit: using the HttpFoundation
 component is the start of better interoperability between all frameworks and
-applications using it (like `Symfony`_, `Drupal 8`_, `phpBB 4`_, `ezPublish
+applications using it (like `Symfony`_, `Drupal 8`_, `phpBB 3`_, `ezPublish
 5`_, `Laravel`_, `Silex`_ and `more`_).
 
 .. _`Twig`: http://twig.sensiolabs.org/
 .. _`HTTP specification`: http://tools.ietf.org/wg/httpbis/
 .. _`audited`: https://symfony.com/blog/symfony2-security-audit
 .. _`Symfony`: https://symfony.com/
 .. _`Drupal 8`: https://drupal.org/
-.. _`phpBB 4`: https://www.phpbb.com/
+.. _`phpBB 3`: https://www.phpbb.com/
 .. _`ezPublish 5`: http://ez.no/
 .. _`Laravel`: http://laravel.com/
 .. _`Silex`: http://silex.sensiolabs.org/
diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
@@ -620,30 +620,5 @@ code from above to generate the submitted form can be reused.
 Suppressing Form Validation
 ---------------------------
 
-To suppress form validation you can use the ``POST_SUBMIT`` event and prevent
-the :class:`Symfony\\Component\\Form\\Extension\\Validator\\EventListener\\ValidationListener`
-from being called.
-
-The reason for needing to do this is that even if you set ``validation_groups``
-to ``false`` there  are still some integrity checks executed. For example
-an uploaded file will still be checked to see if it is too large and the form
-will still check to see if non-existing fields were submitted. To disable
-all of this, use a listener::
-
-    use Symfony\Component\Form\FormBuilderInterface;
-    use Symfony\Component\Form\FormEvents;
-    use Symfony\Component\Form\FormEvent;
-
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        $builder->addEventListener(FormEvents::POST_SUBMIT, function (FormEvent $event) {
-            $event->stopPropagation();
-        }, 900); // Always set a higher priority than ValidationListener
-
-        // ...
-    }
-
-.. caution::
-
-    By doing this, you may accidentally disable something more than just form
-    validation, since the ``POST_SUBMIT`` event may have other listeners.
+To suppress form validation, set ``validation_groups`` to ``false`` or an empty
+array.
diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
@@ -503,6 +503,7 @@ and add the following logic::
     use Symfony\Component\Security\Csrf\CsrfTokenManagerInterface;
     use Symfony\Component\Security\Csrf\CsrfToken;
     use Symfony\Component\Security\Core\Exception\InvalidCsrfTokenException;
+    use Symfony\Component\Security\Guard\Authenticator\AbstractFormLoginAuthenticator;
 
     class ExampleFormAuthenticator extends AbstractFormLoginAuthenticator
     {
diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
@@ -274,7 +274,7 @@ The **minimum configuration** to get your application running under Nginx is:
         # This rule should only be placed on your development environment
         # In production, don't include this and don't deploy app_dev.php or config.php
         location ~ ^/(app_dev|config)\.php(/|$) {
-            fastcgi_pass unix:/var/run/php7.1-fpm.sock;
+            fastcgi_pass unix:/run/php/php7.1-fpm.sock;
             fastcgi_split_path_info ^(.+\.php)(/.*)$;
             include fastcgi_params;
             # When you are using symlinks to link the document root to the
@@ -289,7 +289,7 @@ The **minimum configuration** to get your application running under Nginx is:
         }
         # PROD
         location ~ ^/app\.php(/|$) {
-            fastcgi_pass unix:/var/run/php7.1-fpm.sock;
+            fastcgi_pass unix:/run/php/php7.1-fpm.sock;
             fastcgi_split_path_info ^(.+\.php)(/.*)$;
             include fastcgi_params;
             # When you are using symlinks to link the document root to the
