如何使用 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() 方法
我正在尝试使用 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() 方法