router()

Creates a micro-router and executes the routing action immediately

kirby/config/helpers.php#L470

router(?string $path = null, string $method = 'GET', array $routes = [ ], ?Closure $callback = null): mixed|null

Parameters

Name	Type	Default
$path	`string`\|`null`	`null`
$method	`string`	`'GET'`
$routes	`array`	`[ ]`
$callback	`Closure`\|`null`	`null`

Return type

mixed|null

Example

The router() helper takes a set of routes and request data and directly executes the matching routing action.

This helper is great to build your own custom router. This could be done in the config or in a custom script.

/site/config/config.php

<?php

return [
  'routes' => [
    [
      'pattern' => 'shop/(:all)',
      'action'  => function (string $path) {
        return router($path, 'GET', [
          [
            'pattern' => 'cart',
            'action'  => function () {
                // ...
            }
          ],
          [
            'pattern' => 'checkout',
            'action'  => function () {
                // ...
            }
          ]
        ]);
      }
    ]
  ]
];

Although the example above could of course also simply be solved with more route definitions, it's sometimes really useful to implement such a nested router.

You can also use it for any kind of logic that depends on path matching with regex.