samsonasik/redirect-handler-module

Laminas module to for Url Redirect handling

3.0.0 2020-01-07 17:03 UTC

README

PHP version Software License Build Status Coverage Status Downloads

RedirectHandlerModule is a module for handling redirect when the given url to redirect plugin is not registered in your Laminas application. It simply override existing Laminas redirect plugin, so we can just use it.

This is README for version ^3.0 which only support Laminas 3 with php ^7.1.

For version 2, you can read at version 2 readme which still support ZF3 with php ^7.1 support.

For version 1, you can read at version 1 readme which still support ZF2 with php ^5.6|^7.0 support.

For example, we use redirect() plugin in your controller:

$redirect = '/foo'; // may be a variable from GET
return $this->redirect()->toUrl($redirect);

if the passed $redirect as url is a valid and registered in the routes, it uses default redirect() implementation, otherwise, it will redirect to default default_url registered in config/autoload/redirect-handler-module.local.php:

For example, we define:

return [
    'redirect_handler_module' => [
        'allow_not_routed_url' => false,
        'default_url' => '/',
        'options' => [
            'exclude_urls' => [
                // 'https://www.github.com/samsonasik/RedirectHandlerModule',
            ], // to allow excluded urls to always be redirected
            'exclude_hosts' => [
                // 'www.github.com'
            ],
        ],
    ],
];

It means, we can't allow to make redirect to outside registered routes, whenever found un-registered url in routes, then we will be redirected to default_url. It also disable redirect to self, so you can't redirect to self.

For specific urls that exceptional ( allowed to be redirected even not registered in routes), you can register at exclude_urls/exclude_hosts options.

if you define exclude_urls/exclude_hosts options, which one of them is your own current url/host/domain, its your risk to still get "infinite" redirection loops. so, make sure exclude_urls/exclude_hosts is not your current own.

While default implementation of redirect to self will silently, you can trigger your listener to handle redirect to self in your Module::onBootstrap($e):

class Module
{
    public function onBootstrap($e)
    {
        $app           = $e->getApplication();
        $eventManager  = $app->getEventManager();
        $sharedManager = $eventManager->getSharedManager();

        $sharedManager->attach('RedirectHandlerModule\Controller\Plugin\Redirect', 'redirect-same-url', function() {
            die('You need to use different URL for Redirect');
        });

        $plugin = $app->getServiceManager()->get('ControllerPluginManager')->get('redirect');
        $plugin->setEventManager($eventManager);
    }
}

Installation

Require via composer

composer require samsonasik/redirect-handler-module

After composer require done, you can copy vendor/samsonasik/redirect-handler-module/config/redirect-handler-module.local.php.dist to config/autoload/redirect-handler-module.local.php and modify on your needs.

Last, register to config/application.config.php:

return [
    'modules' => [
        // ...
        'RedirectHandlerModule',
    ],
];

Contributing

Contributions are very welcome. Please read CONTRIBUTING.md

Credit