Tutoriel pour apprendre à utiliser le framework Laravel 4

La requête est analysée et comparée aux chemins définis dans le fichier app/route.php.

Si vous l'ouvrez vous ne trouvez que ce code :

Route::get('/', function()
{
    return View::make('hello');
});

Changez-le pour celui-ci :

Route::get('/', function()
{
    return 'coucou';
});

Si vous lancez l'application avec l'URI http://localhost/laravel/public/ vous obtenez le message « coucou » à l'écran, ce qui montre que l'URI est bien traité par ce code (je rappelle que je pars de l'hypothèse que vous testez Laravel 4 en local dans un dossier nommé « laravel »).

La syntaxe est simple, vous indiquez le type de requête, ici on a get mais vous pouvez utiliser aussi post comme nous allons le voir plus loin (sont aussi gérés put et delete). Vous avez ensuite deux paramètres dont le premier est le chemin (ici c'est la racine représentée par « / »), le second paramètre est une fonction anonyme contenant le traitement.

Faisons un autre essai avec un autre URL :

Route::get('login', function()
{
    return 'login';
});

Ici l'URI correspondant est http://localhost/laravel/public/login.

Remarquez qu'on n'ajoute pas le signe « / » dans ce cas devant « login ». Le seul cas où on l'utilise est celui de la racine. Par contre maintenant si vous utilisez l'URL http://localhost/laravel/public/ vous obtenez un message d'erreur puisque nous n'avons plus de chemin défini pour cet URL :

Sur un site en production il faudra évidemment éviter ce genre de message, mais en cours de développement c'est indispensable.

Prenons un exemple de route avec une requête de type post. Pour cela créons un petit formulaire nommé test.html et placé dans le dossier public :

<form action="log" method="post">
    <input type="text" name="nom" />
    <input type="submit" name="Envoyer" />
</form>

Et prévoyons la route pour récupérer l'information :

Route::post('log', function()
{
    return Input::get('nom');
});

Nous verrons en détail la récupération des entrées dans un autre chapitre, mais la clarté de la syntaxe de Laravel doit vous rendre cette écriture déjà évidente.

En réponse à l'URL : http://localhost/laravel/public/test.html nous obtenons le formulaire :

Et si nous entrons « toto » comme dans le cas de cette image, ce nom doit s'afficher comme réponse à l'écran, ce qui montre que les variables « post » sont bien prises en compte.

Il est classique de transmettre des paramètres dans une requête de type « get », il faut alors pouvoir récupérer ces paramètres. Voici un exemple :

Route::get('article/{numero}', function($numero)
{
    return "Le numéro de l'article est $numero";
});

Exemple d'URL : http://localhost/laravel/public/article/24.

Remarquez la syntaxe, le paramètre est placé entre accolades, on reprend son nom comme paramètre de la fonction et on n'a plus qu'à l'utiliser.

Avec cette syntaxe si vous ne mettez aucun paramètre vous obtenez un message d'erreur. Il est possible de rendre le paramètre optionnel en faisant suivre un point d'interrogation à son nom. Mais il faut prévoir une valeur par défaut pour la variable dans la fonction pour éviter un message d'erreur :

Route::get('article/{numero?}', function($numero = null)
{
    if($numero) return "Le numéro de l'article est $numero";
    else return 'Aucun article mentionné !';
});

On peut contraindre une partie d'un URL à correspondre à un certain type de données avec l'utilisation d'une expression régulière. Voici un exemple :

Route::get('article/{numero}', function($numero)
{
    return "Le numéro de l'article est $numero";
})->where('numero', '[0-9]+');

Ici on oblige le numéro à être un nombre.

Vous pouvez attribuer un nom à une route pour en garder une référence. Voici un exemple :

Route::get('log/{nom?}', array('as' => 'loger', function($nom = null)
{
    if($nom) return $nom;
    else return 'Vous devez vous connecter !';
}));
Route::get('login/{nom?}', function($nom = null)
{
    return Redirect::route('loger', array($nom));
});

J'ai défini deux routes, la première prend en compte un nom de connexion, la seconde n'en prend pas mais elle redirige vers la première. Bon, ce n'est pas un exemple très réaliste mais il montre le fonctionnement du système.

Si vous entrez http://localhost/laravel/public/login vous obtenez « Vous devez vous connecter ! » et si vous entrez http://localhost/laravel/public/login/albert vous obtenez « albert ».

Si vous ne nommez pas la route vous pouvez quand même faire une redirection en passant l'URI avec la méthode to :

Route::get('log/{nom?}', function($nom = null)
{
    if($nom) return $nom;
    else return 'Vous devez vous connecter !';
});
Route::get('login/{nom?}', function($nom = null)
{
    return Redirect::to('log'.'/'.$nom);
});

La version bêta 5 a réintroduit la commande Redirect::home() de Laravel 3 (pour que ça fonctionne il faut que la route correspondante soit nommée home).

Nous verrons d'autres cas de redirection plus tard.

Il est possible de grouper des routes pour leur appliquer un traitement spécifique, par exemple pour tenir compte d'un préfixe (nous verrons dans un chapitre ultérieur d'autres cas d'application avec un filtrage) :

Route::group(array('prefix' => 'login'), function()
{
    Route::get('', function($nom = null)
    {
        return 'Vous devez vous connecter !';
    });
    Route::get('{nom}', function($nom = null)
    {
        return 'Bienvenu '.$nom;
    });
});

Le groupement de routes se fait avec la méthode Route::group. Ici j'ai aussi défini le préfixe login qui est appliqué à toutes les routes du groupe. Ainsi avec l'URL http://localhost/laravel/public/login on obtient :

Vous devez vous connecter !

Et avec l'URL http://localhost/laravel/public/login/toto on obtient :

Bienvenu toto

Nous verrons d'autres possibilités pour les routes au cours des chapitres suivants.