如何使用 FastRoute?

How do I use FastRoute?

我正在尝试使用 FastRoute 路由库,但无法使用简单的用法示例。

这是在 GitHub page:

上找到的基本用法示例
<?php

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

$dispatcher = FastRoute\simpleDispatcher(function(FastRoute\RouteCollector $r) {
    $r->addRoute('GET', '/users', 'get_all_users_handler');
    // {id} must be a number (\d+)
    $r->addRoute('GET', '/user/{id:\d+}', 'get_user_handler');
    // The /{title} suffix is optional
    $r->addRoute('GET', '/articles/{id:\d+}[/{title}]', 'get_article_handler');
});

// Fetch method and URI from somewhere
$httpMethod = $_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);

$routeInfo = $dispatcher->dispatch($httpMethod, $uri);
switch ($routeInfo[0]) {
    case FastRoute\Dispatcher::NOT_FOUND:
        // ... 404 Not Found
        break;
    case FastRoute\Dispatcher::METHOD_NOT_ALLOWED:
        $allowedMethods = $routeInfo[1];
        // ... 405 Method Not Allowed
        break;
    case FastRoute\Dispatcher::FOUND:
        $handler = $routeInfo[1];
        $vars = $routeInfo[2];
        // ... call $handler with $vars
        break;
}

评论写着“...用 $vars 调用 $handler”,我试过返回 call_user_func_array($handler, $vars) 但它不起作用。

我还认为可能是 .htaccess 文件阻止了它的工作,因为 Github 页面没有 .htaccess 项目的文件示例。我正在使用这个:

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . index.php [QSA,L]

我也试过调用一个带有闭包的路由作为处理程序,如下所示:

$r->addRoute('GET', '/', function() {
    echo 'home';
});

如何处理请求的示例

$r->addRoute('GET', '/users', User::class . '/getUsers');

那么如果发现了dispatcher,就可以进行如下处理

case FastRoute\Dispatcher::FOUND:
    $handler = $routeInfo[1];
    $vars = $routeInfo[2];        
    list($class, $method) = explode("/", $handler, 2);
    call_user_func_array(array(new $class, $method), $vars);
    
    break;

不要忘记使用 getUsers() 方法创建 class User

$r->addRoute(['GET','POST','PUT'], '/test', 'TestClass/testMethod');

然后在你的调度方法中:

$routeInfo = $router->dispatch($httpMethod, $uri)
switch($routeInfo[0]) {
 case FastRoute\Dispatcher::FOUND:
 $handler = $routeInfo[1];
 $vars = $routeInfo[2];
 list($class, $method) = explode('/',$handler,2);
 $controller = $container->build()->get($class);
 $controller->{$method}(...array_values($vars));
break;
}   

Class 和方法当然可以通过 call_user_func() 调用,但由于我希望路由器更抽象并放置在根目录之外,我决定使用 DI 容器,太棒了。

我做了一个演示 API,它使用 FastRoute 和 PHP-DI(依赖注入)来展示如何使用两者。参见:https://github.com/tochix/shapes-api/blob/master/src/Service/Http/Router.php#L94。简而言之,它看起来像这样:

/**
 * @param string $requestMethod
 * @param string $requestUri
 * @param Dispatcher $dispatcher
 * @throws DependencyException
 * @throws NotFoundException
 */
private function dispatch(string $requestMethod, string $requestUri, Dispatcher $dispatcher)
{
    $routeInfo = $dispatcher->dispatch($requestMethod, $requestUri);

    switch ($routeInfo[0]) {
        case Dispatcher::NOT_FOUND:
            $this->getRequest()->sendNotFoundHeader();
            break;
        case Dispatcher::METHOD_NOT_ALLOWED:
            $this->getRequest()->sendMethodNotAllowedHeader();
            break;
        case Dispatcher::FOUND:
            list($state, $handler, $vars) = $routeInfo;
            list($class, $method) = explode(static::HANDLER_DELIMITER, $handler, 2);

            $controller = $this->getContainer()->get($class);
            $controller->{$method}(...array_values($vars));
            unset($state);
            break;
    }
}

创建方法主页()

使用方法 users().

创建 class User

添加如下路线

$r->addRoute(['GET','POST','PUT'], '/home',  'homepage');
$r->addRoute(['GET','POST','PUT'], '/aboutus', function() { echo 'About us'; });
$r->addRoute(['GET','POST','PUT'], '/users', 'User/users');

如果调度员找到

case FastRoute\Dispatcher::FOUND:
    $handler = $routeInfo[1];
    $vars    = $routeInfo[2];
    if ( is_object( $handler ) || ( is_string( $handler ) && strpos( $handler, '/' ) === false ) ) {
        if(count($vars) > 0) {
            call_user_func_array($handler,$vars);
        } else {
            call_user_func_array($handler,array());
        }
    } else if ( is_string( $handler ) && strpos( $handler, '/' ) !== false ) {
        list($class, $method) = explode( '/', $handler, 2 );
        if ( class_exists( $class ) && method_exists( $class, $method ) ) {
            call_user_func_array( array( new $class(), $method ), $vars );
        }
    }
    break;

然后,

/home 将调用方法 homepage()

/aboutus 将在 add routes

调用给定的 function object

/users 将从 User class

调用 users() 方法