allow can method to be chained onto route for quick authorization middleware additions (#39464)

Author: taylorotwell

src/Illuminate/Routing/Route.php

@@ -1040,6 +1040,20 @@ public function middleware($middleware = null)
         return $this;
     }
 
+    /**
+     * Specify that the "Authorize" / "can" middleware should be applied to the route with the given options.
+     *
+     * @param  string  $ability
+     * @param  array|string  $models
+     * @return $this
+     */
+    public function can($ability, $models = [])
+    {
+        return empty($models)
+                    ? $this->middleware(['can:'.$ability])
+                    : $this->middleware(['can:'.$ability.','.implode(',', Arr::wrap($models))]);
+    }
+
     /**
      * Get the middleware for the route's controller.
      *

tests/Routing/RoutingRouteTest.php

@@ -1926,6 +1926,24 @@ public function testRoutePermanentRedirect()
         $this->assertEquals(301, $response->getStatusCode());
     }
 
+    public function testRouteCanMiddlewareCanBeAssigned()
+    {
+        $route = new Route(['GET'], '/', []);
+        $route->middleware(['foo'])->can('create', Route::class);
+
+        $this->assertEquals([
+            'foo',
+            'can:create,Illuminate\Routing\Route',
+        ], $route->middleware());
+
+        $route = new Route(['GET'], '/', []);
+        $route->can('create');
+
+        $this->assertEquals([
+            'can:create',
+        ], $route->middleware());
+    }
+
     protected function getRouter()
     {
         $container = new Container;