README

此库提供了一个基于正则表达式的路由器的快速实现。

安装

使用composer安装

composer require ioguns/httprouter

需要PHP 8.0或更高版本。

用法

以下是一个基本用法示例

<?php

require '/path/to/vendor/autoload.php';

$router = new \IOguns\HttpRouter\RouteCollection();

    $router->get('/', 'demo','home');
    $router->get('/page/{page_slug=[a-zA-Z0-9\-]+}', ['name' => 'page.show']);
    $router->get('/about-us', ['name' => 'about-us']);
    $router->get('/contact-us', ['name' => 'contact-us']);
    $router->post('/contact-us', ['name' => 'contact-us.submit']);

    $router->addGroup('/blog', function ($router) {
        $router->get('/', ['name' => 'blog.index']);
        $router->get('/recent', ['name' => 'blog.recent']);
        $router->get('/post/{post_slug=[a-zA-Z0-9\-]+}', ['name' => 'blog.post.show']);
        $router->post('/post/{post_slug=[a-zA-Z0-9\-]+}/comment', ['name' => 'blog.post.comment']);
    });


// Fetch method and URI from somewhere
$http_method = $_SERVER['REQUEST_METHOD'];
$uri = $_SERVER['REQUEST_URI'];

// Strip query string (?foo=bar) and decode URI
if (false !== $pos = strpos($uri, '?')) {
    $uri = substr($uri, 0, $pos);
}
$uri = rawurldecode($uri);

$route_info = $router->getRoute($http_method, $uri);
switch ($route_info[0]) {
    case \IOguns\HttpRouter\IRouteCollection::ROUTE_NOT_FOUND:
        // ... 404 Not Found
        break;
    case \IOguns\HttpRouter\IRouteCollection::ROUTE_FOUND:
       $data = $route_info[1];
        $route_params = $route_info[2];
        // ... call $handler with $route_params
        break;
    case \IOguns\HttpRouter\IRouteCollection::ROUTE_METHOD_NOT_ALLOWED:
        $allowed_methods = $route_info[1];
        // ... 405 Method Not Allowed
        break;
}

路由组

此外，您还可以在组内指定路由。组内定义的所有路由都将具有共同的前缀。

例如，将您的路由定义为

$router->addGroup('/admin', function (RouteCollection $router) {
    $router->addRoute('GET', '/do-something', 'handler');
    $router->addRoute('GET', '/do-another-thing', 'handler');
    $router->addRoute('GET', '/do-something-else', 'handler');
});

将产生与以下相同的结果

$router->addRoute('GET', '/admin/do-something', 'handler');
$router->addRoute('GET', '/admin/do-another-thing', 'handler');
$router->addRoute('GET', '/admin/do-something-else', 'handler');

也支持嵌套组，在这种情况下，所有嵌套组的前缀将合并。

缓存

将选项 [enable_cache=>true, 'cache_handler' => new \IOguns\HttpRouter\Cache\FileCache(__DIR__)] 传递给构造函数

<?php

$router = new \IOguns\HttpRouter\RouteCollection(['enable_cache' => true, 'cache_handler' => new \IOguns\HttpRouter\Cache\FileCache(__DIR__ . '/../caches/')]);
if (!$router->loadRoutes(cache_key: $cache_key = 'real_life')) {
    $router->get('/', 'demo','home');
    $router->get('/page/{page_slug=[a-zA-Z0-9\-]+}', ['name' => 'page.show']);
    $router->get('/about-us', ['name' => 'about-us']);
    $router->get('/contact-us', ['name' => 'contact-us']);
    $router->post('/contact-us', ['name' => 'contact-us.submit']);

    $router->addGroup('/blog', function ($router) {
        $router->get('/', ['name' => 'blog.index']);
        $router->get('/recent', ['name' => 'blog.recent']);
        $router->get('/post/{post_slug=[a-zA-Z0-9\-]+}', ['name' => 'blog.post.show']);
        $router->post('/post/{post_slug=[a-zA-Z0-9\-]+}/comment', ['name' => 'blog.post.comment']);
    });

   $router->saveRoutes(cache_key:$cache_key,ttl:60);
}

从命名路由获取路由路径

<?php

$router = new \IOguns\HttpRouter\RouteCollection();
$router->get('/', 'demo','home');

$url = $router->resolveNamedRoute(name:'home');

var_dump($url == '/'); //true

$router->get('/page/{page_slug=[a-zA-Z0-9\-]+}', ['name' => 'page.show'], 'page_by_slug');

$url = $router->resolveNamedRoute(name:'page_by_slug',['page_slug'=>'home-alone-part-2']);

var_dump($url == '/page/home-alone-part-2'); //true