スリム3フレームワーク - 私は自分のAPIにルートグループを使用すべきですか？

Question

私は、この構造を使用する必要があります...

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 
} 

それとも、この「ルートグループ」1？

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(); 

もっと良い方法はありますか？前者ははるかにクリーンなようです。私は比較的新しいので、私は賛否両論を知らない。

Answer 1

は一般的に、あなたは目に見えて、コード内の関係を見ることができるように、同様のリソースやコンテンツを整理するルートグループを使用します。ルートグループは、特定のグループにミドルウェアなどの特別な条件を設定する必要がある場合にも役立ちます。たとえば、Webサイトに管理者セクションがあり、コントローラにアクセスする前にユーザーが実際に管理者であることを確認したい場合があります。

$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); 

それが重要なの多大ではありませんが、可能性として組織として、すべてのコードをレイアウトするだけで良い習慣です、とルートグループは、あなたがこれを行うことができます。