Merge branch '4.1'

* 4.1:
  Added a tip about atPath() method
  Remove useless use statements
  Added the missing class imports
  Update upload_file.rst for handling FileException
  Fix environment variable name

Author: javiereguiluz

controller/upload_file.rst

@@ -100,6 +100,7 @@ Finally, you need to update the code of the controller that handles the form::
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\File\Exception\FileException;
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\Routing\Annotation\Route;
     use App\Entity\Product;
@@ -123,11 +124,15 @@ Finally, you need to update the code of the controller that handles the form::
 
                 $fileName = $this->generateUniqueFileName().'.'.$file->guessExtension();
 
-                // moves the file to the directory where brochures are stored
-                $file->move(
-                    $this->getParameter('brochures_directory'),
-                    $fileName
-                );
+                // Move the file to the directory where brochures are stored
+                try {
+                    $file->move(
+                        $this->getParameter('brochures_directory'),
+                        $fileName
+                    );
+                } catch (FileException $e) {
+                    // ... handle exception if something happens during file upload
+                }
 
                 // updates the 'brochure' property to store the PDF file name
                 // instead of its contents
@@ -219,6 +224,7 @@ logic to a separate service::
     // src/Service/FileUploader.php
     namespace App\Service;
 
+    use Symfony\Component\HttpFoundation\File\Exception\FileException;
     use Symfony\Component\HttpFoundation\File\UploadedFile;
 
     class FileUploader
@@ -234,7 +240,11 @@ logic to a separate service::
         {
             $fileName = md5(uniqid()).'.'.$file->guessExtension();
 
-            $file->move($this->getTargetDirectory(), $fileName);
+            try {
+                $file->move($this->getTargetDir(), $fileName);
+            } catch (FileException $e) {
+                // ... handle exception if something happens during file upload
+            }
 
             return $fileName;
         }

messenger.rst

@@ -159,7 +159,7 @@ the messenger component, the following configuration should have been created:
 
     # .env
     ###> symfony/messenger ###
-    MESSENGER_DSN=amqp://guest:guest@localhost:5672/%2f/messages
+    MESSENGER_TRANSPORT_DSN=amqp://guest:guest@localhost:5672/%2f/messages
     ###< symfony/messenger ###
 
 This is enough to allow you to route your message to the ``amqp`` transport.

reference/forms/types/options/property_path.rst.inc

@@ -3,10 +3,8 @@ property_path
 
 **type**: ``PropertyPathInterface|string|null`` **default**: ``null``
 
-Fields display a property value of the form's domain object by default.
-When the form is submitted, the submitted value is written back into the
-object.
-
-If you want to override the property that a field reads from and writes
-to, you can set the ``property_path`` option. Its default value (``null``)
-will use the field's name as the property.
+By default (when the value of this option is ``null``) form fields read from and
+write to the properties with the same names in the form's domain object. The
+``property_path`` option lets you define which property a field reads from and
+writes to. The value of this option can be any
+:doc:`valid PropertyAccess syntax </components/property_access>`.

security/impersonating_user.rst

@@ -93,8 +93,6 @@ In some cases you may need to get the object that represents the impersonator
 user rather than the impersonated user. Use the following snippet to iterate
 over the user's roles until you find one that is a ``SwitchUserRole`` object::
 
-    use Symfony\Component\Security\Core\Authentication\Token\Storage\TokenStorageInterface;
-    use Symfony\Component\Security\Core\Authorization\AuthorizationCheckerInterface;
     use Symfony\Component\Security\Core\Role\SwitchUserRole;
     use Symfony\Component\Security\Core\Security;
     // ...

validation/custom_constraint.rst

@@ -196,6 +196,12 @@ With this, the validator ``validate()`` method gets an object as its first argum
         }
     }
 
+.. tip::
+
+    The ``atPath()`` method defines the property which the validation error is
+    associated to. Use any :doc:`valid PropertyAccess syntax </components/property_access>`
+    to define that property.
+
 Note that a class constraint validator is applied to the class itself, and
 not to the property: