hiraeth/middleware-browser-redirect

Redirect browsers / versions to alternative URLs

2.0.0 2022-11-04 21:45 UTC

Requires

• hiraeth/app: ^2.0
• hiraeth/middleware-imp: ^2.0
• sinergi/browser-detector: ^6.1

Requires (Dev)

• hiraeth/diactoros: ^2.0
• hiraeth/middleland: ^2.0
• phpstan/phpstan: ^1.0

MIT

• Matthew J. Sahagian

README

This is a PSR-15 middleware that can be configured with a series of rules to detect specific browsers, versions, and request paths and redirect them to an alternate URL.

Basic Usage

//
// The factory must be an actual instance of a response factory, the PSR interface here is
// used as a stand in for any particular PSR compatible implementation.
//

$factory  = new Psr\Http\Message\ResponseFactoryInterface();
$browser  = new Sinergi\BrowserDetector\Browser();
$redirect = new BrowserRedirect($browser, $factory);

$redirect->addRule([
	'target'   => '/.*',
	'browser'  => 'IE',
	'version'  => '<10',
	'redirect' => 'https://getfirefox.com'
]);

//
// This will actually be executed by your middleware stack, so you probably don't need to do this
// yourself.
//

$response = $redirect->process($request, $handler);

Hiraeth Integration

1. Package configuration and middleware configuration will be copied on install
2. Additional rules can be added to any config as an array of objects:

[browser]

	rules = [
		{
			"target": "/.*",
			"browser": "IE",
			"version": "<10",
			"redirect": "https://getfirefox.com"
		}
	]