Slim 3 Framework - Devo utilizzare Route Groups per la mia API?

Question

Dovrei usare questa struttura ...

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 
} 

O questo "percorso Gruppi" uno?

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

Qual è il modo migliore? Il primo sembra molto più pulito. Sono relativamente nuovo, quindi non sono a conoscenza dei pro e dei contro.

Answer 1

Generalmente, si utilizzano gruppi di percorsi per organizzare risorse o contenuti simili in modo da poter vedere visibilmente la loro relazione nel codice. I gruppi di percorsi sono anche utili se è necessario inserire condizioni speciali come il middleware in un gruppo specifico. Ad esempio, potresti avere una sezione amministratore sul tuo sito web e assicurarti che l'utente sia effettivamente un amministratore prima di accedere al controller.

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

Ovviamente, avrebbe più senso raggruppare insieme questi percorsi perché condividono tratti simili. Se hai bisogno di cambiare qualcosa su questi tratti in futuro (come il tipo di middleware), dovresti farlo una sola volta.

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

E 'anche utile se si sarebbe mai ad espandere il caso d'uso di quello specifico URI, quindi diciamo che si desidera implementare una nuova funzionalità nel pannello che gli utenti normali possono utilizzare.

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

Anche se non è una grande quantità di importanza, è solo una buona pratica per il layout tutto il codice organizzato come possibile, e gruppi di percorso permettono di fare questo.