Tutoriel pour apprendre à utiliser le framework Laravel 4

Vous pouvez avec Laravel créer un contrôleur qui répond aux conventions de nommage de la norme REST. Voyons un exemple simple de contrôleur :

class GuestController extends BaseController {
 
    /**
    * Affiche le formulaire de login
    *
    * @return View
    */
    public function getLogin()
    {
            //  ...
    }
 
    /**
    * Traitement du formulaire de login
    *
    * @return Redirect
    */
    public function postLogin()
    {
             //  ...    
    }
}

On a deux actions login (identifiant), une avec la méthode GET et l'autre la méthode POST. Au niveau des routes on se contente de cette ligne de code :

Route::controller('guest', 'GuestController');

Avec l'URL http://localhost/blog/public/guest/login on active l'action login qui correspond à la méthode getLogin. Avec le même URL mais la méthode POST on active l'action login qui correspond à la méthode postLogin. Il suffit donc de bien préfixer les actions avec get et post. Je montrerai un exemple complet d'application ultérieurement.

Laravel possède un outil en ligne nommé Artisan. Il permet de faire bien des choses. Pour vous en rendre compte, entrez php artisan en ligne de commande :

Vous pouvez voir qu'il y a pas mal de commandes disponibles. Nous allons nous intéresser pour le moment à la commande controller:make qui sert justement à créer un contrôleur. Voyons les options de cette commande :

Nous allons commencer par une création simple :

On nous dit que le contrôleur a été créé, nous le trouvons effectivement dans app/controllers/mon_controleur.php :

<?php

class mon_controleur extends BaseController {

    /**
    * Display a listing of the resource.
    *
    * @return Response
    */
    public function index()
    {
    //
    }

    /**
    * Show the form for creating a new resource.
    *
    * @return Response
    */
    public function create()
    {
    //
    }

    /**
    * Store a newly created resource in storage.
    *
    * @return Response
    */
    public function store()
    {
    //
    }

    /**
    * Display the specified resource.
    *
    * @return Response
    */
    public function show($id)
    {
    //
    }

    /**
    * Show the form for editing the specified resource.
    *
    * @return Response
    */
    public function edit($id)
    {
    //
    }

    /**
    * Update the specified resource in storage.
    *
    * @return Response
    */
    public function update($id)
    {
    //
    }

    /**
    * Remove the specified resource from storage.
    *
    * @return Response
    */
    public function destroy($id)
    {
    //
    }

}

Laravel se conforme à l'architecture RESTful ce qui explique la présence de toutes ces méthodes. Pour clarifier un peu tout ça, voilà le code modifié avec un retour évocateur :

<?php
 
class mon_controleur extends BaseController {
 
    public function index()
    {
        return "Réponse de base";
    }
 
    // GET /ma_ressource/create
    public function create()
    {
        return "La ressource doit être créée ici";
    }
 
    // POST /ma_ressource
    public function store()
    {
        return "Ressource mémorisée";
    }
 
    // GET /ma_ressource/{id}
    public function show($id)
    {
        return "C'est ici qu'on montre la ressource ".$id;
    }
 
    // GET /ma_ressource/{id}/edit
    public function edit($id)
    {
        return "C'est ici qu'on modifie la ressource ".$id;
    }
 
    // PUT /ma_ressource/{id}
    public function update($id)
    {
        return "C'est ici qu'on met à jour la ressource ".$id;
    }
 
    // DELETE /ma_ressource/{id}
    public function destroy($id)
    {
        return "C'est ici qu'on supprime la ressource ".$id;
    }
 
}

On va aussi déclarer la ressource dans le fichier des routes, ce qui va avoir pour effet de créer toutes les routes correspondant à cette ressource avec une seule ligne de code :

Route::resource('ma_ressource', 'mon_controleur');

En réponse à http://localhost/laravel/public/ma_ressource j'obtiens donc :

Réponse de base

En réponse à http://localhost/laravel/public/ma_ressource/toto j'obtiens donc :

C'est ici qu'on montre la ressource toto

En réponse à http://localhost/laravel/public/ma_ressource/toto/edit j'obtiens donc :

C'est ici qu'on modifie la ressource toto

Pour les autres commandes il faut un peu plus d'intendance puisqu'on a les verbes POST, PUT et DELETE.

Par exemple pour l'enregistrement d'une ressource créez ce formulaire :

<form action="ma_ressource" method="post">
    <input name="Valider" type="submit">
</form>

Quand vous cliquez sur le bouton vous devez obtenir :

Ressource mémorisée

En ce qui concerne les méthodes PUT et DELETE la mise en œuvre est un peu plus délicate.

Si vous ne voulez pas toutes les fonctionnalités vous pouvez créer un contrôleur limité à vos besoins. La commande d'Artisan comprend les options -only et -except. Mais il faut aussi le signaler dans l'appel de la ressource. Par exemple si vous ne voulez que show et edit :

Route::resource('ma_ressource', 'mon_controleur',
array('only' => array('show', 'edit')));

Vous avez donc la possibilité d'utiliser ce type de contrôleur dans vos applications si vous voulez coller à l'architecture REST ou tout simplement partir sur une base cohérente.

Je donne un exemple completChapitre 22 : Installer des générateurs d'une ressource avec un générateur plus loin dans ce tutoriel.