lesichkovm/php-autoroute

Automatically maps a provided route to a controller and method

PHP Autoroute

The "set-and-forget" smart router script., _(*1)

Installation

A. Use composer (preferred)

composer require lesichkovm/php-autoroute

B. Manually via composer

Add the following to your composer file:, _(*2)

   "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/lesichkovm/php-autoroute.git"
        }
    ],
    "require": {
        "lesichkovm/php-autoroute": "dev-master"
    },

How does it work?

Just from the route (URI) it will find and execute the appropriate controller and method. Pass the current route and autoroute will call the associated controller and method., _(*3)

Requirements

Your controller classes must be either included (i.e. using require_once), or you must have an autoload function registered (recommended)., _(*4)

See http://php.net/manual/en/language.oop5.autoload.php for how to register and autoload classes., _(*5)

Example routes

Route: /admin/user-management/view-users, _(*6)

Executes: Admin\UserManagementController@viewUsers, _(*7)

Route: user/admin/test/home, _(*8)

Executes: User\Admin\TestController@home, _(*9)

Example routes using request method

Route: /admin/user-management/view-users, _(*10)

Executes: Admin\UserManagementController@getViewUsers, _(*11)

Route: user/admin/test/home, _(*12)

Executes: User\Admin\TestController@getHome, _(*13)

How to use

Simple One Line Example

autoroute(parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH));

Advanced Options with Exception Catching

// 1. Get the current route
$route = isset($_REQUEST['route']) ? $_REQUEST['route'] : '';

// 2. Autoroute
try {
    autoroute($route, [
        'default_method' => 'index',
        'default_controller' => 'Guest',
        'default_namespace' => 'App\\Controllers',
        'use_request_method' => true,
    ]);
} catch (ReflectionException $re) {
    // Page not found
    die('Not found:' . $re->controller . '@' . $re->method);
} catch (Exception $e) {
    // Other non routing related exception
    // Deal with exception (i.e. send yourself a mail)
    die('Exception occurred');
}