Merge pull request #9150 from ddevsr/router-multiple-hostname

feat: multiple hostname routing

system/Router/RouteCollection.php

@@ -1562,7 +1562,7 @@ protected function create(string $verb, string $from, $to, ?array $options = nul
      * Compares the hostname passed in against the current hostname
      * on this page request.
      *
-     * @param string $hostname Hostname in route options
+     * @param list<string>|string $hostname Hostname in route options
      */
     private function checkHostname($hostname): bool
     {
@@ -1571,6 +1571,13 @@ private function checkHostname($hostname): bool
             return false;
         }
 
+        // Has multiple hostnames
+        if (is_array($hostname)) {
+            $hostnameLower = array_map('strtolower', $hostname);
+
+            return in_array(strtolower($this->httpHost), $hostnameLower, true);
+        }
+
         return strtolower($this->httpHost) === strtolower($hostname);
     }
 

tests/system/Router/RouteCollectionTest.php

@@ -13,6 +13,7 @@
 
 namespace CodeIgniter\Router;
 
+use App\Controllers\Home;
 use App\Controllers\Product;
 use CodeIgniter\Config\Services;
 use CodeIgniter\controller;
@@ -1744,6 +1745,46 @@ public function testRouteOverwritingMatchingHost(): void
         $this->assertSame($expects, $router->handle('/'));
     }
 
+    public function testRouteMatchingHostMultipleCorrect(): void
+    {
+        service('superglobals')->setServer('HTTP_HOST', 'two.domain.com');
+        service('request')->setMethod(Method::GET);
+
+        $routes = $this->getCollector();
+        $router = new Router($routes, Services::request());
+
+        $routes->setDefaultNamespace('App\Controllers');
+        $routes->setDefaultController('Home');
+        $routes->setDefaultMethod('index');
+
+        $routes->get('/', 'Home::index', ['as' => 'home']);
+        $routes->get('/', '\App\Controllers\Site\CDoc::index', ['hostname' => ['one.domain.com', 'two.domain.com', 'three.domain.com']]);
+
+        $expect = '\App\Controllers\Site\CDoc';
+
+        $this->assertSame($expect, $router->handle('/'));
+    }
+
+    public function testRouteMatchingHostMultipleFail(): void
+    {
+        service('superglobals')->setServer('HTTP_HOST', 'doc.domain.com');
+        service('request')->setMethod(Method::GET);
+
+        $routes = $this->getCollector();
+        $router = new Router($routes, Services::request());
+
+        $routes->setDefaultNamespace('App\Controllers');
+        $routes->setDefaultController('Home');
+        $routes->setDefaultMethod('index');
+
+        $routes->get('/', 'Home::index', ['as' => 'home']);
+        $routes->get('/', '\App\Controllers\Site\CDoc::index', ['hostname' => ['one.domain.com', 'two.domain.com', 'three.domain.com']]);
+
+        $expect = '\\' . Home::class;
+
+        $this->assertSame($expect, $router->handle('/'));
+    }
+
     /**
      * Tests for router DefaultNameSpace issue
      *

user_guide_src/source/changelogs/v4.6.0.rst

@@ -178,6 +178,11 @@ Commands
   arguments.
 - The ``spark filter:check`` command now displays filter classnames.
 
+Routing
+=======
+
+- Now you can specify multiple hostnames when restricting routes.
+
 Testing
 =======
 

user_guide_src/source/incoming/routing.rst

@@ -476,6 +476,15 @@ by passing the "hostname" option along with the desired domain to allow it on as
 This example would only allow the specified hosts to work if the domain exactly matched **accounts.example.com**.
 It would not work under the main site at **example.com**.
 
+Restrict by Multiple Hostnames
+------------------------------
+
+.. versionadded:: 4.6.0
+
+Also you can restrict by multiple hostnames, e.g:
+
+.. literalinclude:: routing/073.php
+
 Limit to Subdomains
 ===================
 

user_guide_src/source/incoming/routing/073.php

@@ -0,0 +1,3 @@
+<?php
+
+$routes->get('from', 'to', ['hostname' => ['s1.example.com', 's2.example.com']]);