Merge branch '4.1'

* 4.1:
  added a space before "=" in code
  fix the markup
  Changing to absolute url, as requested
  Updated link to Event Listeners page
  Update form_customization.rst
  Revert "Fix typo on which YAML values must not be quoted"
  Fix typo (shard -> shared)
  Fix typo on which YAML values must not be quoted
  Change all occurrences of Controller to AbstractController
  fix `HandlerLocator`'s use statement

Author: weaverryan

best_practices/forms.rst

@@ -104,10 +104,10 @@ some developers configure form buttons in the controller::
     use App\Entity\Post;
     use App\Form\PostType;
     use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Bundle\FrameworkBundle\Controller\Controller;
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\Form\Extension\Core\Type\SubmitType;
 
-    class PostController extends Controller
+    class PostController extends AbstractController
     {
         // ...
 

components/form.rst

@@ -406,12 +406,12 @@ is created from the form factory.
         // src/Controller/TaskController.php
         namespace App\Controller;
 
-        use Symfony\Bundle\FrameworkBundle\Controller\Controller;
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\HttpFoundation\Request;
         use Symfony\Component\Form\Extension\Core\Type\TextType;
         use Symfony\Component\Form\Extension\Core\Type\DateType;
 
-        class TaskController extends Controller
+        class TaskController extends AbstractController
         {
             public function new(Request $request)
             {
@@ -468,11 +468,11 @@ builder:
         // src/Controller/DefaultController.php
         namespace App\Controller;
 
-        use Symfony\Bundle\FrameworkBundle\Controller\Controller;
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\Form\Extension\Core\Type\TextType;
         use Symfony\Component\Form\Extension\Core\Type\DateType;
 
-        class DefaultController extends Controller
+        class DefaultController extends AbstractController
         {
             public function new(Request $request)
             {
@@ -550,10 +550,10 @@ by ``handleRequest()`` to determine whether a form has been submitted):
         // src/Controller/DefaultController.php
         namespace App\Controller;
 
-        use Symfony\Bundle\FrameworkBundle\Controller\Controller;
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\Form\Extension\Core\Type\FormType;
 
-        class DefaultController extends Controller
+        class DefaultController extends AbstractController
         {
             public function search()
             {
@@ -612,11 +612,11 @@ method:
         // src/Controller/TaskController.php
         namespace App\Controller;
 
-        use Symfony\Bundle\FrameworkBundle\Controller\Controller;
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\Form\Extension\Core\Type\DateType;
         use Symfony\Component\Form\Extension\Core\Type\TextType;
 
-        class TaskController extends Controller
+        class TaskController extends AbstractController
         {
             public function new(Request $request)
             {
@@ -688,13 +688,13 @@ option when building each field:
         // src/Controller/DefaultController.php
         namespace App\Controller;
 
-        use Symfony\Bundle\FrameworkBundle\Controller\Controller;
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\Validator\Constraints\NotBlank;
         use Symfony\Component\Validator\Constraints\Type;
         use Symfony\Component\Form\Extension\Core\Type\DateType;
         use Symfony\Component\Form\Extension\Core\Type\TextType;
 
-        class DefaultController extends Controller
+        class DefaultController extends AbstractController
         {
             public function new(Request $request)
             {

components/lock.rst

@@ -262,7 +262,7 @@ then the lock is considered as acquired; otherwise as not acquired::
 
     $stores = [];
     foreach (array('server1', 'server2', 'server3') as $server) {
-        $redis= new \Redis();
+        $redis = new \Redis();
         $redis->connect($server);
 
         $stores[] = new RedisStore($redis);

components/messenger.rst

@@ -61,7 +61,7 @@ Example::
 
     use App\Message\MyMessage;
     use Symfony\Component\Messenger\MessageBus;
-    use Symfony\Component\Messenger\HandlerLocator;
+    use Symfony\Component\Messenger\Handler\Locator\HandlerLocator;
     use Symfony\Component\Messenger\Middleware\HandleMessageMiddleware;
 
     $bus = new MessageBus([

components/routing.rst

@@ -393,10 +393,10 @@ routes with UTF-8 characters:
 
         namespace App\Controller;
 
-        use Symfony\Bundle\FrameworkBundle\Controller\Controller;
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\Routing\Annotation\Route;
 
-        class DefaultController extends Controller
+        class DefaultController extends AbstractController
         {
             /**
              * @Route("/category/{name}", name="route1", options={"utf8": true})
@@ -462,10 +462,10 @@ You can also include UTF-8 strings as routing requirements:
 
         namespace App\Controller;
 
-        use Symfony\Bundle\FrameworkBundle\Controller\Controller;
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\Routing\Annotation\Route;
 
-        class DefaultController extends Controller
+        class DefaultController extends AbstractController
         {
             /**
              * @Route(

configuration/micro_kernel_trait.rst

@@ -249,10 +249,10 @@ has one file in it::
     // src/Controller/MicroController.php
     namespace App\Controller;
 
-    use Symfony\Bundle\FrameworkBundle\Controller\Controller;
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\Routing\Annotation\Route;
 
-    class MicroController extends Controller
+    class MicroController extends AbstractController
     {
         /**
          * @Route("/random/{limit}")

console/command_in_controller.rst

@@ -28,13 +28,13 @@ Run this command from inside your controller via::
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Console\Application;
-    use Symfony\Bundle\FrameworkBundle\Controller\Controller;
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\Console\Input\ArrayInput;
     use Symfony\Component\Console\Output\BufferedOutput;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\HttpKernel\KernelInterface;
 
-    class SpoolController extends Controller
+    class SpoolController extends AbstractController
     {
         public function sendSpool($messages = 10, KernelInterface $kernel)
         {
@@ -85,7 +85,7 @@ Now, use it in your controller::
     use Symfony\Component\HttpFoundation\Response;
     // ...
 
-    class SpoolController extends Controller
+    class SpoolController extends AbstractController
     {
         public function sendSpool($messages = 10)
         {

controller/soap_web_service.rst

@@ -59,12 +59,12 @@ can be retrieved via ``/soap?wsdl``::
 
     namespace App\Controller;
 
-    use Symfony\Bundle\FrameworkBundle\Controller\Controller;
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
     use App\Service\HelloService;
 
-    class HelloServiceController extends Controller
+    class HelloServiceController extends AbstractController
     {
         /**
          * @Route("/soap")

controller/upload_file.rst

@@ -99,13 +99,13 @@ Finally, you need to update the code of the controller that handles the form::
     // src/Controller/ProductController.php
     namespace App\Controller;
 
-    use Symfony\Bundle\FrameworkBundle\Controller\Controller;
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\Routing\Annotation\Route;
     use App\Entity\Product;
     use App\Form\ProductType;
 
-    class ProductController extends Controller
+    class ProductController extends AbstractController
     {
         /**
          * @Route("/product/new", name="app_product_new")

doctrine.rst

@@ -336,7 +336,7 @@ and save it!
     // ...
     use App\Entity\Product;
 
-    class ProductController extends Controller
+    class ProductController extends AbstractController
     {
         /**
          * @Route("/product", name="product")