Slim 3 Framework - Soll ich Routengruppen für meine API verwenden?

Question

Soll ich diese Struktur verwenden ...

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 
} 

Oder diese "Route Groups" ein?

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

Was ist der bessere Weg? Ersteres scheint viel sauberer zu sein. Ich bin relativ neu, daher bin ich mir der Vor- und Nachteile nicht bewusst.

Answer 1

Im Allgemeinen verwenden Sie Routengruppen, um ähnliche Ressourcen oder Inhalte zu organisieren, sodass Sie ihre Beziehung im Code sichtbar sehen können. Routengruppen sind auch hilfreich, wenn Sie spezielle Bedingungen wie Middleware einer bestimmten Gruppe zuordnen müssen. Beispiel: Sie haben möglicherweise einen Administratorabschnitt auf Ihrer Website und möchten sicherstellen, dass der Benutzer tatsächlich Administrator ist, bevor Sie auf den Controller zugreifen.

Offensichtlich wäre es sinnvoller, diese Routen zusammen zu gruppieren, da sie ähnliche Merkmale aufweisen. Wenn Sie jemals etwas an diesen Eigenschaften in der Zukunft ändern müssen (wie die Art der Middleware), müssen Sie es nur einmal tun.

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

Es ist auch hilfreich, wenn Sie jemals den Anwendungsfall dieser spezifischen URI erweitern wollen, können so sagen, dass Sie ein neues Feature in der Platte ausrollen wollen, dass normale Benutzer verwenden können.

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

Obwohl es nicht sehr viel von Bedeutung ist, ist es nur gute Praxis den gesamten Code Layout wie möglich organisiert und Route-Gruppen können Sie dies tun.