Merge branch '5.1'

* 5.1: (21 commits)
  Adding `path`
  Fixing bad path for class PdoSessionHandler
  Fix package name modified post merge
  Fix typos: DNS -> DSN
  Fix term
  Fix inconsistent security docs
  Fix debug:container command
  Fix logout on form login setup
  Change char to varchar type
  Remove reference to non-existing fromBinary method
  Use redirectToRoute
  [#13980] add annotation config example
  [Validator] Made the code sample more explicit with accepted values
  Update voters.rst
  Update voters.rst
  Update voters.rst
  Update security/voters.rst
  Update voters.rst
  [#13554] Slightly reworded the tip
  Update voters.rst
  ...

Author: xabbuh

components/http_foundation.rst

@@ -647,7 +647,7 @@ or change its ``Content-Disposition``::
         'filename.txt'
     );
 
-It is possible to delete the file after the request is sent with the
+It is possible to delete the file after the response is sent with the
 :method:`Symfony\\Component\\HttpFoundation\\BinaryFileResponse::deleteFileAfterSend` method.
 Please note that this will not work when the ``X-Sendfile`` header is set.
 

components/phpunit_bridge.rst

@@ -336,7 +336,7 @@ the compiling and warming up of the container:
 
 .. code-block:: terminal
 
-    $ debug:container --deprecations
+    $ php bin/console debug:container --deprecations
 
 .. versionadded:: 5.1
 

components/uid.rst

@@ -62,15 +62,10 @@ to create each type of UUID::
 If your UUID is generated by another system, use the ``fromString()`` method to
 create an object and make use of the utilities available for Symfony UUIDs::
 
-    // this value is generated somewhere else
+    // this value is generated somewhere else (can also be in binary format)
     $uuidValue = 'd9e7a184-5d5b-11ea-a62a-3499710062d0';
     $uuid = Uuid::fromString($uuidValue);
 
-If your UUIDs are generated in binary format, use the ``fromBinary()`` method
-to create the objects for them::
-
-    $uuid = Uuid::fromBinary($uuidBinaryContents);
-
 Converting UUIDs
 ~~~~~~~~~~~~~~~~
 
@@ -140,15 +135,10 @@ Instantiate the ``Ulid`` class to generate a random ULID value::
 If your ULID is generated by another system, use the ``fromString()`` method to
 create an object and make use of the utilities available for Symfony ULIDs::
 
-    // this value is generated somewhere else
+    // this value is generated somewhere else (can also be in binary format)
     $ulidValue = '01E439TP9XJZ9RPFH3T1PYBCR8';
     $ulid = Ulid::fromString($ulidValue);
 
-If your ULIDs are generated in binary format, use the ``fromBinary()`` method
-to create the objects for them::
-
-    $ulid = Ulid::fromBinary($ulidBinaryContents);
-
 Converting ULIDs
 ~~~~~~~~~~~~~~~~
 

controller/upload_file.rst

@@ -171,7 +171,7 @@ Finally, you need to update the code of the controller that handles the form::
 
                 // ... persist the $product variable or any other work
 
-                return $this->redirect($this->generateUrl('app_product_list'));
+                return $this->redirectToRoute('app_product_list');
             }
 
             return $this->render('product/new.html.twig', [

mailer.rst

@@ -19,7 +19,7 @@ Transport Setup
 ---------------
 
 Emails are delivered via a "transport". Out of the box, you can deliver emails
-over SMTP by configuring the DNS in your ``.env`` file (the ``user``,
+over SMTP by configuring the DSN in your ``.env`` file (the ``user``,
 ``pass`` and ``port`` parameters are optional):
 
 .. code-block:: env
@@ -83,7 +83,7 @@ transport, but you can force to use one:
     # force to use SMTP instead of HTTP (which is the default)
     MAILER_DSN=sendgrid+smtp://$SENDGRID_KEY@default
 
-This table shows the full list of available DNS formats for each third
+This table shows the full list of available DSN formats for each third
 party provider:
 
 ==================== ========================================== =========================================== ========================================

notifier.rst

@@ -54,16 +54,16 @@ to send SMS messages to mobile phones. This feature requires subscribing to
 a third-party service that sends SMS messages. Symfony provides integration
 with a couple popular SMS services:
 
-==========  ===============================  ====================================================
+==========  ================================  ====================================================
 Service     Package                          DSN
-==========  ===============================  ====================================================
-Twilio      ``symfony/twilio-notifier``      ``twilio://SID:TOKEN@default?from=FROM``
-Nexmo       ``symfony/nexmo-notifier``       ``nexmo://KEY:SECRET@default?from=FROM``
-OvhCloud    ``symfony/ovhcloud-notifier``    ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME``
-Sinch       ``symfony/sinch-notifier``       ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
-FreeMobile  ``symfony/freemobile-notifier``  ``freemobile://LOGIN:PASS@default?phone=PHONE``
-Smsapi      ``symfony/smsapi-notifier``      ``smsapi://TOKEN@default?from=FROM``
-==========  ===============================  ====================================================
+==========  ================================  ====================================================
+Twilio      ``symfony/twilio-notifier``       ``twilio://SID:TOKEN@default?from=FROM``
+Nexmo       ``symfony/nexmo-notifier``        ``nexmo://KEY:SECRET@default?from=FROM``
+OvhCloud    ``symfony/ovhcloud-notifier``     ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME``
+Sinch       ``symfony/sinch-notifier``        ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
+FreeMobile  ``symfony/free-mobile-notifier``  ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
+Smsapi      ``symfony/smsapi-notifier``       ``smsapi://TOKEN@default?from=FROM``
+==========  ================================  ====================================================
 
 .. versionadded:: 5.1
 

reference/configuration/security.rst

@@ -540,6 +540,14 @@ the current firewall and not the other ones.
 
 .. _reference-security-logout-success-handler:
 
+``path``
+~~~~~~~~
+
+**type**: ``string`` **default**: ``/logout``
+
+The path which triggers logout. If you change it from the default value ``/logout``,
+you need to set up a route with a matching path.
+
 success_handler
 ~~~~~~~~~~~~~~~
 

reference/constraints/Collection.rst

@@ -209,7 +209,7 @@ you can do the following:
              *     }
              * )
              */
-            protected $profileData = ['personal_email'];
+            protected $profileData = ['personal_email' => 'email@example.com'];
         }
 
     .. code-block:: yaml

security/form_login.rst

@@ -28,7 +28,8 @@ First, enable ``form_login`` under your firewall:
 
             firewalls:
                 main:
-                    anonymous: lazy
+                    anonymous: true
+                    lazy: true
                     form_login:
                         login_path: login
                         check_path: login
@@ -46,8 +47,7 @@ First, enable ``form_login`` under your firewall:
                 https://symfony.com/schema/dic/security/security-1.0.xsd">
 
             <config>
-                <firewall name="main">
-                    <anonymous lazy="true"/>
+                <firewall name="main" anonymous="true" lazy="true">
                     <form-login login-path="login" check-path="login"/>
                 </firewall>
             </config>
@@ -59,7 +59,8 @@ First, enable ``form_login`` under your firewall:
         $container->loadFromExtension('security', [
             'firewalls' => [
                 'main' => [
-                    'anonymous'  => 'lazy',
+                    'anonymous' => true,
+                    'lazy' => true,
                     'form_login' => [
                         'login_path' => 'login',
                         'check_path' => 'login',

security/form_login_setup.rst

@@ -99,12 +99,13 @@ Edit the ``security.yaml`` file in order to declare the ``/logout`` path:
         security:
             # ...
 
-            providers:
-                # ...
-                logout:
-                    path: app_logout
-                    # where to redirect after logout
-                    # target: app_any_route
+            firewalls:
+                main:
+                    # ...
+                    logout:
+                        path: app_logout
+                        # where to redirect after logout
+                        # target: app_any_route
 
     .. code-block:: xml
 
@@ -119,8 +120,11 @@ Edit the ``security.yaml`` file in order to declare the ``/logout`` path:
                 https://symfony.com/schema/dic/security/security-1.0.xsd">
 
             <config>
-                <rule path="^/login$" role="IS_AUTHENTICATED_ANONYMOUSLY"/>
                 <!-- ... -->
+                <firewall name="main">
+                    <!-- ... -->
+                    <logout path="app_logout"/>
+                </firewall>
             </config>
         </srv:container>
 
@@ -129,12 +133,15 @@ Edit the ``security.yaml`` file in order to declare the ``/logout`` path:
         // config/packages/security.php
         $container->loadFromExtension('security', [
             // ...
-            'access_control' => [
-                [
-                    'path' => '^/login',
-                    'roles' => 'IS_AUTHENTICATED_ANONYMOUSLY',
+            'firewalls' => [
+                'main' => [
+                    // ...
+                    'logout' => [
+                        'path' => 'app_logout',
+                        // where to redirect after logout
+                        'target' => 'app_any_route'
+                    ],
                 ],
-                // ...
             ],
         ]);