Added view() method to route collections

system/Router/RouteCollection.php

@@ -992,6 +992,21 @@ public function cli(string $from, $to, ?array $options = null): RouteCollectionI
         return $this;
     }
 
+    /**
+     * Specifies a route that will only display a view.
+     * Only works for GET requests.
+     */
+    public function view(string $from, string $view, ?array $options = null): RouteCollectionInterface
+    {
+        $to = static fn (...$data) => Services::renderer()
+            ->setData(['segments' => $data], 'raw')
+            ->render($view, $options);
+
+        $this->create('get', $from, $to, $options);
+
+        return $this;
+    }
+
     /**
      * Limits the routes to a specified ENVIRONMENT or they won't run.
      */

tests/system/Router/RouteCollectionTest.php

@@ -819,6 +819,27 @@ public function testCLI()
         $this->assertSame($expected, $routes->getRoutes('cli'));
     }
 
+    public function testView()
+    {
+        $routes = $this->getCollector();
+
+        $routes->view('here', 'hello');
+
+        $route = $routes->getRoutes('get')['here'];
+        $this->assertIsCallable($route);
+
+        // Test that the route is not available in any other verb
+        $this->assertArrayNotHasKey('here', $routes->getRoutes('*'));
+        $this->assertArrayNotHasKey('here', $routes->getRoutes('options'));
+        $this->assertArrayNotHasKey('here', $routes->getRoutes('head'));
+        $this->assertArrayNotHasKey('here', $routes->getRoutes('post'));
+        $this->assertArrayNotHasKey('here', $routes->getRoutes('put'));
+        $this->assertArrayNotHasKey('here', $routes->getRoutes('delete'));
+        $this->assertArrayNotHasKey('here', $routes->getRoutes('trace'));
+        $this->assertArrayNotHasKey('here', $routes->getRoutes('connect'));
+        $this->assertArrayNotHasKey('here', $routes->getRoutes('cli'));
+    }
+
     public function testEnvironmentRestricts()
     {
         // ENVIRONMENT should be 'testing'

user_guide_src/source/changelogs/v4.3.0.rst

@@ -136,6 +136,7 @@ Others
 
 - Added ``$routes->useSupportedLocalesOnly(true)`` so that the Router returns 404 Not Found if the locale in the URL is not supported in ``Config\App::$supportedLocales``. See :ref:`Localization <localization-in-routes>`
 - Now you can specify Composer packages to auto-discover manually. See :ref:`Code Modules <modules-specify-composer-packages>`.
+- Added new ``$routes->view()`` method to return a the view directly. See :ref:`View Routes <view-routes>`.
 
 Changes
 *******

user_guide_src/source/incoming/routing.rst

@@ -210,6 +210,22 @@ a simple view:
 
 .. literalinclude:: routing/020.php
 
+.. _view-routes:
+
+Views
+=====
+
+If you just want to render a view out that has no logic associated with it, you can use the ``view()`` method.
+This is always treated as GET request.
+This method accepts the name of the view to load as the second parameter.
+
+.. literalinclude:: routing/065.php
+
+If you use placeholders within your route, you can access them within the view in a special variable, ``$segments``.
+They are available as an array, indexed in the order they appear in the route.
+
+.. literalinclude:: routing/066.php
+
 Mapping Multiple Routes
 =======================
 

user_guide_src/source/incoming/routing/065.php

@@ -0,0 +1,4 @@
+<?php
+
+// Displays the view in /app/Views/pages/about.php
+$routes->view('about', 'pages/about');

user_guide_src/source/incoming/routing/066.php

@@ -0,0 +1,7 @@
+<?php
+
+// Displays the view in /app/Views/map.php
+$routes->view('map/(:segment)/(:segment)', 'map');
+
+// Within the view, you can access the segments with
+// $segments[0] and $segments[1] respectively.