Laravel 4 definiert RESTful-Controller

Question

Also ich bin neu im Laravel-Framework ab v4 und frage mich, wie man RESTful-Controller erstellen und verwenden kann. Wenn ich die Dokumentation durchlese, bin ich ein wenig verwirrt, was den Unterschied zwischen RESTful-Controllern und Resource-Controllern betrifft.

Wenn eine RESTful Controller definiert, wie pro die docs, es folgt die in routes.php schlägt tun:

Route::controller('posts', 'PostController'); 

Im PostController, tun wir die Klassenmethoden durch das Vorsetzen den Namen des Verfahrens mit dem HTTP definieren Verb möchten wir verwenden? Zum Beispiel:

class PostController extends \BaseController { 
    public function getIndex() 
    { 
     // 
    } 
} 

jedoch umreißt auch eine Möglichkeit, Ressourcen-Controller in der routes.php Datei zu erstellen, wie so: Strecke :: Ressource (‚Beiträge‘, ‚Postcontroller‘);

Und in PostController.php definieren wir Methoden ohne Präfix mit dem HTTP-Verb.

class PostController extends \BaseController { 
    public function index() 
    { 
     // 
    } 
} 

Was ist der Unterschied zwischen den beiden? Und wann benutzen wir eines statt des anderen und warum?

Auch sollten wir verwenden Route::controller('posts', 'PostController'); oder Route::resource('posts', 'PostController'); Routing an die Steuerung zu übergeben oder sollten wir jede Route manuell definieren, wie unten:

Route::get('/users', 'UserController@index'); 
Route::get('/users/create', 'UserController@create'); 
Route::post('/users', 'UserController@store'); 
Route::get('/users/{id}', 'UserController@show'); 
Route::get('/users{id}/edit', 'UserController@edit'); 
Route::put('/users', 'UserController@update'); 
Route::delete('/users', 'UserController@destroy'); 

Answer 1

Nehmen Sie diesen Regler als Beispiel:

<?php 

class TestController extends BaseController { 

    public function getIndex() 
    { 
     echo "a"; 
    } 

    public function postSecond($a) 
    { 
     echo "b"; 
    } 

} 

In Ihre Routen, wenn Sie haben

Route::controller('tests', 'TestController'); 

And execut

e

php artisan routes 

werden Sie haben:

+--------+--------------------------------------------+------------------------+-----------------------------------+----------------+---------------+ 
| Domain | URI          | Name     | Action       | Before Filters | After Filters | 
+--------+--------------------------------------------+------------------------+-----------------------------------+----------------+---------------+ 
|  | GET /tests/index/{v1}/{v2}/{v3}/{v4}/{v5} |      | TestController@getIndex   |    |    | 
|  | GET /tests         |      | TestController@getIndex   |    |    | 
|  | POST /tests        | tests.store   | TestController@store    |    |    | 
|  | GET /tests/{_missing}      |      | TestController@missingMethod  |    |    | 
+--------+--------------------------------------------+------------------------+-----------------------------------+----------------+---------------+ 

Laravel prüft die Steuerung und erzeugt Routen basierend auf welche Methoden es findet, automatisch.

Aber wenn Sie

Route::resource('tests', 'TestController'); 

tun Sie finden diese Route-Eintrag erhalten:

+--------+--------------------------------------------+------------------------+-----------------------------------+----------------+---------------+ 
| Domain | URI          | Name     | Action       | Before Filters | After Filters | 
+--------+--------------------------------------------+------------------------+-----------------------------------+----------------+---------------+ 
|  | GET /tests         |      | Closure       |    |    | 
|  | GET /tests         | tests.index   | TestController@index    |    |    | 
|  | GET /tests/create       | tests.create   | TestController@create    |    |    | 
|  | POST /tests        | tests.store   | TestController@store    |    |    | 
|  | GET /tests/{tests}       | tests.show    | TestController@show    |    |    | 
|  | GET /tests/{tests}/edit     | tests.edit    | TestController@edit    |    |    | 
|  | PUT /tests/{tests}       | tests.update   | TestController@update    |    |    | 
|  | PATCH /tests/{tests}      |      | TestController@update    |    |    | 
|  | DELETE /tests/{tests}      | tests.destroy   | TestController@destroy   |    |    | 
+--------+--------------------------------------------+------------------------+-----------------------------------+----------------+---------------+ 

Keine erraten, Laravel verwendet eine vordefinierte CRUD Liste von Routen, können Sie einige dieser Routen entfernen, aber Es wird Ihren Controller nicht untersuchen, um Routen für Ihre Methoden zu erstellen.

Sie entscheiden, was das Beste für Sie ist. Aber normalerweise ist Route :: resource() ein guter Anfang, wenn Sie einen CRUD-Controller verwenden, andernfalls können Sie Route :: controller() verwenden oder Ihre Routen manuell erstellen.

EDIT:

Es gibt keine wirklich, warum eine oder warum eine andere ist nur eine Frage der Gestaltung und Auswahl. Einige werden keines von ihnen jemals benutzen. Es ist nur Hut Route::resource() folgt dem Weg der Schiene Routing: http://guides.rubyonrails.org/routing.html.

Mit Route::resource() Sie brauchen nicht alle diese Methoden zu erstellen, aber Sie werden mit einer Liste von sinnlose Routen enden, weil Laravel immer alle von ihnen standardmäßig erstellen, es sei denn, Sie tun:

Route::resource('photo', 'PhotoController', 
       array('only' => array('index', 'show'))); 

Und Ihre Routenliste zeigt nur den Index und zeigt Aktionen an.

Wenn du noch andere Routen benötigst, musst du sie mit Route::resource() manuell erstellen oder mit etwas Magie arbeiten, um sie für all deine findigen Routen automatisch zu machen. Mit Route::controller() ist alles automatisch, jedes Mal, wenn Sie eine neue Methode hinzufügen, wird eine neue Route für Sie erstellt.

Wenn Sie einen CRUD-Controller erstellen möchten, beginnen Sie mit Route::resource(). Andernfalls denken Sie über die Vorteile des einen oder anderen in Ihrem speziellen Fall nach.

EDIT2:

Dies ist ein großer Artikel, von Phil Sturgeon (PyroCMS und PHP-Figur), über die Vorteile der manuell alle Ihre Routen bauen: http://philsturgeon.co.uk/blog/2013/07/beware-the-route-to-evil.

Answer 2

@ Antonios Antwort ist gut. Lassen Sie mich etwas Ähnliches und Wichtigeres etwas prägnanter sagen. In routes.php:

Route::resource('users', 'UserController'); 

die Ressource Methode verwenden macht Laravel CRUD-Funktionalität übernehmen und es sieht nur für seine sechs vorgefertigte CRUD Methoden: Index, erstellen, zu speichern, zu zeigen, zerstören, etc. Es gewann‘ t "sehen" Sie alle anderen neuen Methoden, die Sie dort erstellen.

Route::controller('info', 'InfoController'); 

die Controller-Methode ermöglicht es Ihnen, benutzerdefinierte Methoden/Seiten zu erstellen. Laravel sucht nach ihnen, wenn Sie die Methode/den Seitennamen mit einem HTTP-Verb voranstellen. In Ihrer XxxxController.php:

class InfoController extends \BaseController { 

    public function getFeatures() 
    { 
     return View::make('info.features'); 
    } 

    public function getContactUs() 
    { 
     return View::make('info.contact-us'); 
    } 

    public function getPricing() 
    { 
     return View::make('info.pricing'); 
    } 

}