README

A simple request router with cache.

Install

Via Composer

$ composer require vakata/router-cached

Usage

// Usage is the same as with the non-cached router
// you only need to supply a class implementing the \vakata\cache\CacheInterface
$router = new \vakata\routerCached\RouterCached(
    new \vakata\cache\Filecache(__DIR__), // where will cached pages be stored
    60, // cache validity in seconds - by default it is 1440 seconds
    function ($request, $verb) { // return a key for each request
        return md5($verb . ' ' . $request); // this is the default
    },
    [ 'GET', 'POST' ], // which verbs to cache
    'routeCache' // a namespace (allowing easy clearing of all cached routes)
);

// everything else is exactly the same as with the non-caching router:
$router
    ->get('/', function () { echo 'homepage'; })
    ->get('/profile', function () { echo 'user profile'; })
    ->with('/books/') // specify a prefix for all future routes
        ->get('read/{i:id}', function ($matches) {
            // this method uses a named placeholder
            // provided the user visits /books/read/10 matches will contain:
            var_dump($matches); // 0 => books, 1 => read, 2 => 10, id => 10
            // placeholders are wrapped in curly braces {...} and can be: 
            //  - i - an integer
            //  - a - any letter (a-z)
            //  - h - any letter or integer
            //  - * - anything (up to the next slash (/))
            //  - ** - anything (to the end of the URL)

            // placeholders can be named too by using the syntax:
            // {placeholder:name}
            
            // placeholders can also be optional
            // {?optional}
        })
        // for advanced users - you can use any regex as a placeholder:
        ->get('{(delete|update):action}/{(\d+):id}', function ($matches) { })
        // you can also use any HTTP verb
        ->post('delete/{i:id}', function ($matches) { })
    // here is how you reset the prefix
    ->with('')
        // you can also bind multiple HTTP verbs in one go
        ->add(['GET', 'HEAD'], '/path', function () { })
    // you can also use with() statements to execute some code if the begging of the URL is a match to the prefix
    ->with('user', function () { echo 1; })
        ->get('view', function () { /* 1 will be echoed */ })
        ->post('chat', function () { /* 1 will be echoed */ });

// there is no need to chain the method calls - this works too:
$router->post('123', function () { });
$router->post('456', function () { });

// you finally run the router
try {
    $router->run($_SERVER['REQUEST_URI'], $_SERVER['REQUEST_METHOD']);
} catch (\vakata\router\RouterException $e) {
    // thrown if no matching route is found
}

Testing

$ composer test

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email github@vakata.com instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.

vakata / router-cached

Maintainers

Details