[9.x] Allow route group method to be chained (#44825)

* allow route group method to be chained

* update docblocks

Author: ockle

src/Illuminate/Routing/RouteRegistrar.php

@@ -159,11 +159,13 @@ public function apiResource($name, $controller, array $options = [])
      * Create a route group with shared attributes.
      *
      * @param  \Closure|string  $callback
-     * @return void
+     * @return $this
      */
     public function group($callback)
     {
         $this->router->group($this->attributes, $callback);
+
+        return $this;
     }
 
     /**

src/Illuminate/Routing/Router.php

@@ -373,7 +373,7 @@ public function apiResource($name, $controller, array $options = [])
      *
      * @param  array  $attributes
      * @param  \Closure|array|string  $routes
-     * @return void
+     * @return $this
      */
     public function group(array $attributes, $routes)
     {
@@ -387,6 +387,8 @@ public function group(array $attributes, $routes)
 
             array_pop($this->groupStack);
         }
+
+        return $this;
     }
 
     /**

tests/Routing/RouteRegistrarTest.php

@@ -430,6 +430,26 @@ public function testRouteGroupingWithoutPrefix()
         $this->seeResponse('hello', Request::create('bar/baz', 'GET'));
     }
 
+    public function testRouteGroupChaining()
+    {
+        $this->router
+            ->group([], function ($router) {
+                $router->get('foo', function () {
+                    return 'hello';
+                });
+            })
+            ->group([], function ($router) {
+                $router->get('bar', function () {
+                    return 'goodbye';
+                });
+            });
+
+        $routeCollection = $this->router->getRoutes();
+
+        $this->assertInstanceOf(\Illuminate\Routing\Route::class, $routeCollection->match(Request::create('foo', 'GET')));
+        $this->assertInstanceOf(\Illuminate\Routing\Route::class, $routeCollection->match(Request::create('bar', 'GET')));
+    }
+
     public function testRegisteringNonApprovedAttributesThrows()
     {
         $this->expectException(BadMethodCallException::class);