XXI. Chapitre 21 : Un blog : utilisation de contrôleurs▲
Nous allons continuer l'application « blog » en essayant de mieux organiser le code. Dans la précédente étape nous avons utilisé les routes pour effectuer tout le traitement. Ça fonctionne correctement mais ce n'est pas très lisible. Alors je vous propose d'utiliser un contrôleur pour faire le traitement et ne conserver dans les routes que l'aiguillage de requêtes.
XXI-A. Les routes▲
Le fichier des routes ne conserve que ce pour quoi il est fait, le routage :
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
<?php
Route::get('/', array('uses' => 'HomeController@accueil', 'as' => 'accueil'));
Route::model('cat', 'Categorie');
Route::get('cat/{cat}', 'HomeController@categorie');
Route::model('art', 'Article');
Route::get('art/{cat_id}/{art}', 'HomeController@article');
Route::post('find', 'HomeController@find');
Route::post('comment', 'HomeController@comment');
J'ai prévu de nommer une seule route, pour l'accueil ; je trouve que le code est ensuite plus lisible et ça permet de montrer comment on nomme une route vers un contrôleur par la même occasion. J'ai conservé l'injection d'instance des modèles Categorie et Article qui rend la syntaxe plus légère.
XXI-B. Le contrôleur▲
Le contrôleur HomeController est chargé de toutes les actions pour les articles :
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.
69.
70.
71.
72.
73.
74.
75.
76.
77.
78.
79.
80.
81.
82.
83.
84.
85.
86.
87.
88.
89.
90.
91.
92.
93.
94.
95.
96.
97.
98.
99.
100.
101.
102.
103.
104.
105.
106.
107.
<?php
class HomeController extends BaseController {
public function __construct()
{
$this->beforeFilter('csrf', ['on' => 'post']);
}
/**
* Génère la vue de l'accueil
*
* @param $articles
* @return View
*/
private function gen_accueil($articles)
{
return View::make('accueil', array(
'categories' => Categorie::all(),
'articles' => $articles,
'actif' => 0
));
}
/**
* Affiche la page d'accueil
*
* @return View
*/
public function accueil()
{
$articles = Article::select('id', 'title', 'intro_text')
->orderBy('created_at', 'desc')
->paginate(4);
return $this->gen_accueil($articles);
}
/**
* Affiche les articles d'une catégorie
*
* @param $categorie
* @return View
*/
public function categorie(Categorie $categorie)
{
$articles = $categorie->articles()->orderBy('created_at', 'desc')->paginate(4);
return View::make('accueil', array('categories' => Categorie::all(), 'articles' => $articles, 'actif' => $categorie->id));
}
/**
* Affiche un article
*
* @param $cat_id
* @param $article
* @return View
*/
public function article($cat_id, Article $article)
{
//////////////////////////////////////////////////////////////
// Log d'un utilisateur pour tester la saisie des commentaires
$user = User::where('username', '=', 'admin')->first();
Auth::login($user);
//////////////////////////////////////////////////////////////
$comments = $article->comments()->orderBy('comments.created_at', 'desc')
->join('users', 'users.id', '=', 'comments.user_id')
->select('users.username', 'title', 'text', 'comments.created_at')
->get();
return View::make('article', array('categories' => Categorie::all(), 'article' => $article, 'actif' => $cat_id, 'comments' => $comments));
}
/**
* Traitement du formulaire de recherche
*
* @return View ou Redirect
*/
public function find()
{
$match = Input::get('find');
if($match) {
$articles = Article::select('id', 'title', 'intro_text')
->orderBy('created_at', 'desc')
->where('intro_text', 'like', '%'.$match.'%')
->orwhere('full_text', 'like', '%'.$match.'%')
->get();
Session::flash('flash_notice', 'Résultats pour la recherche du terme '.$match);
return $this->gen_accueil($articles);
}
return Redirect::to('/')->with('flash_error', 'Il faudrait entrer un terme pour la recherche !');
}
/**
* Traitement du formulaire d'ajout de commentaires
*
* @return Redirect
*/
public function comment()
{
Comment::create(array(
'title' => Input::get('title'),
'user_id' => Auth::user()->id,
'article_id' => Input::get('id_art'),
'text' => Input::get('comment')
));
return Redirect::to(url('art', array(Input::get('id_cat'), Input::get('id_art'))));
}
}
Il reprend le code que nous avons déjà vu. J'ai cette fois bien séparé les fonctions, en particulier entre l'accueil et la recherche. Remarquez l'application dans le constructeur du filtre csrf pour la méthode POST. On pourrait aussi mettre ce filtre dans les routes en groupant les deux qui sont concernées.
Au niveau de l'affichage des articles, j'ai prévu l'authentification artificielle d'un utilisateur pour avoir accès à la saisie des commentaires. On supprimera ce code dans un chapitre ultérieur consacré à l'authentification.
XXI-C. Les vues▲
Les vues ont subi quelques améliorations que je vous livre sans commentaires.
Voici le template template.blade.php :
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
<!DOCTYPE html>
<html lang="fr">
<head>
<meta charset="utf-8">
<title>
Mon joli blog
</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
{{ HTML::style('//netdna.bootstrapcdn.com/bootstrap/3.0.2/css/bootstrap.min.css') }}
{{ HTML::style('//netdna.bootstrapcdn.com/bootstrap/3.0.2/css/bootstrap-theme.min.css') }}
{{ HTML::style('assets/css/main.css') }}
{{ HTML::style('http://fonts.googleapis.com/css?family=Imprima') }}
</head>
<body>
<div class="container">
<header class="jumbotron" id="entete">
<h1>Mon joli blog !</h1>
</header>
<nav class="navbar navbar-default">
<div class="navbar-header">
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a class="navbar-brand" href="#">Mon joli blog</a>
</div>
<div class="collapse navbar-collapse">
<ul class="nav navbar-nav">
@yield('navigation')
</ul>
{{ Form::open(array('url' => 'find', 'method' => 'POST', 'class' => 'navbar-form navbar-left pull-right')) }}
{{ Form::text('find', '', array('class' => 'form-group form-control', 'placeholder' => 'Recherche')) }}
{{ Form::close() }}
</div>
</nav>
<section class="row">
@yield('content')
</section>
<footer>
<em>© 2013</em>
</footer>
</div>
{{ HTML::script('//ajax.googleapis.com/ajax/libs/jquery/1.10.2/jquery.min.js'); }}
{{ HTML::script('//netdna.bootstrapcdn.com/bootstrap/3.0.2/js/bootstrap.min.js'); }}
</body>
</html>
La navigation navigation.blade.php :
2.
3.
4.
5.
6.
7.
@section('navigation')
<li>{{ link_to_route('accueil', 'Accueil', null, ($actif == 0)? array('class' => 'actif'): null) }}</li>
@foreach ($categories as $categorie)
<li>{{ link_to('cat/'.$categorie->id, $categorie->title, ($actif == $categorie->id)? array('class' => 'actif'): null) }}</li>
@endforeach
@stop
L'accueil accueil.blade.php :
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
@extends('template_blog')
@include('navigation')
@section('content')
@if (Session::has('flash_notice'))
<div class="col-md-12">
<div class="alert alert-success">
{{ Session::get('flash_notice') }}
</div>
</div>
@endif
@if (Session::has('flash_error'))
<div class="col-md-12">
<div class="alert alert-danger">
{{ Session::get('flash_error') }}
</div>
</div>
@endif
@for ($i = 0; $i < count($articles); $i++)
<div class="col-md-6">
<h3>{{$articles[$i]->title}}</h3>
<p>{{$articles[$i]->intro_text}}</p>
<a class="btn btn-default" href="{{ url('art/'.$actif.'/'.$articles[$i]->id) }}">Lire la suite <span class="glyphicon glyphicon-play"></span></a>
</div>
@endfor
@if (method_exists($articles,'links'))
{{$articles->links()}}
@endif
@stop
Et enfin la vue pour les articles article.blade.php :
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
@extends('template_blog')
@include('navigation')
@section('content')
<div class="col-md-12">
<div class="well">
<em class="pull-right">
Ecrit le {{date('d-m-Y',strtotime($article->created_at))}}
</em>
<h3>
{{$article->title}}
</h3>
<p>
{{$article->full_text}}
</p>
</div>
</div>
@foreach ($comments as $comment)
<div class="col-md-12">
<div class="comment">
<em class="pull-right">
Ecrit par {{$comment->username}} le {{date('d-m-Y',strtotime($comment->created_at))}}
</em>
<h5>
{{$comment->title}}
</h5>
<p>
{{$comment->text}}
</p>
</div>
</div>
@endforeach
@if ($article->allow_comment and Auth::check())
<hr />
<div class="col-md-12">
<div class="well">
{{ Form::open(array('url' => 'comment')) }}
{{ Form::hidden('id_art', $article->id) }}
{{ Form::hidden('id_cat', $actif) }}
{{ Form::label('title', 'Titre de votre commentaire :') }}
{{ Form::text('title', '', $attributes = array('class' => 'form-control')) }}
{{ Form::label('comment', 'Votre commentaire :') }}
{{ Form::textarea('comment', '', $attributes = array('class' => 'form-control')) }}
{{ Form::submit('Envoyer', array('class' => 'btn btn-default')) }}
{{ Form::close() }}
</div>
</div>
@endif
@stop
XXI-D. Conclusion▲
Le code est maintenant mieux organisé avec un fichier de routes léger et lisible et un contrôleur pour assurer la gestion de l'application. Le tout est-il maintenant satisfaisant ?
Pour le moment nous allons nous en satisfaire, mais ce n'est pas une idée excellente de trouver le traitement des données dans le contrôleur. Dans l'idéal un contrôleur devrait juste recevoir des requêtes et leur apporter des réponses. Il existe un principe nommé « Repository Pattern » qui consiste à créer un intermédiaire entre le contrôleur et les modèles d'Eloquent. Nous verrons dans des chapitres ultérieurs comment effectuer ce découplage.