Slim 3框架-我应该为我的API使用路由组吗


Slim 3 Framework - Should I be using Route Groups for my API?

我应该使用这个结构吗。。。

require 'vendor/autoload.php';
$app = new 'Slim'App;
$app->get('/books', 'getBooks');
$app->get('/books/{id}', 'getBook');
$app->run();
function getBooks() {
    // Return list of books
}
function getBook($id) {
    // Return a single book
}

还是这个"路由组"?

require 'vendor/autoload.php';
$app = new 'Slim'App;
$app->group('/books', function () use ($app) {
    $app->get('', function ($req, $res) {
        // Return list of books
    });
    $app->get('/{id:'d+}', function ($req, $res, $args) {
        // Return a single book
    });
});
$app->run();

什么是更好的方法?前者似乎干净多了。我是一个相对较新的人,所以我不知道其中的利弊。

通常,您使用路由组来组织类似的资源或内容,这样您就可以在代码中明显地看到它们的关系。如果您需要在特定组上设置任何特殊条件(如中间件),路由组也很有用。例如,您的网站上可能有一个管理员部分,您希望在访问控制器之前确保用户实际上是管理员。

$app->get('panel/admin', 'Admin/DashboardController:index')->add($adminAuth);
$app->get('panel/admin/users', 'Admin/UserController:index')->add($adminAuth);
$app->post('panel/admin/users', 'Admin/UserController:create')->add($adminAuth);

显然,将这些路线组合在一起更有意义,因为它们具有相似的特征。如果你将来需要改变这些特性(比如中间件的类型),你只需要做一次。

$app->group('/panel', function() use ($app) {
    $app->group('/admin', function() use ($app) {
        $app->get('', 'Admin/DashboardController:index');
        $app->get('/users', 'Admin/UserController:index');
        $app->post('/users', 'Admin/UserController:create');
    })->add($adminAuth);
})->add($userAuth);

如果你想扩展特定URI的用例,这也很有帮助,比如说你想在面板中推出一个普通用户可以使用的新功能。

$app->group('/panel', function() use ($app) {
    $app->group('/admin', function() use ($app) {
        $app->get('', 'Admin/DashboardController:index');
        $app->get('/users', 'Admin/UserController:index');
        $app->post('/users', 'Admin/UserController:create');
    })->add($adminAuth);

    $app->get('', 'DashboardController:index');
})->add($userAuth);

虽然这不是很重要,但将所有代码布局为尽可能有组织是一种很好的做法,路由组允许您这样做。