This PR improves the redirect router. It adds support for callback based routing alongside pattern based routing which was already possible.

Redirect routing is available globally, redirects can be setup outside of the context of Pages for any url on your Joomla site

Global redirects

The changes implemented as part of #344 make it possible to implement redirects in Joomla outside of the context of Pages.

Global configuration

You do not need to setup a /joomlatools-pages folder to be able to define redirects. If you just want to use this feature add a configuration-pages.php to your Joomla root, and defines your redirects.

<?php
return array('redirects' => [
    '/articles/[:alias]' => '/blog/posts/[:alias],
    '/login'  => ['resolve' => function($route)
    {
	if(isset($route->query['view']) && $route->query['view'] == 'registration')
	{
            $route->path = '/register';
            unset($route->query['view']);

            return true;
	 }
     }],
  ]
);

Configure caching

You can configure the redirect cache lifetime through the cache query parameter in the route target. It will set the max-age value for the Cache-Control header when the response is send.

The max-age parameter indicates that the file is to be considered stale after its age is greater than the specified number of seconds.

By setting a cache liftetime you instruct CDN's and browser cache the redirect for a specific time. This helps to increase the performance of your site and is recommended practice.

The cache parameters offers support for English textual relative datetime formats as supported by strtotime, for example:

• 1day
• 2hours
• 15min

See also: joomlatools/joomlatools-framework#373

For example, set the cache lifetime to 1day

>> '/articles/[:alias]' => '/blog/posts/[:alias]/?cache=1day,