13.Zend Framework 2 et 3

13.6.Modèle MVC

13.6.3.MVC: Le contrôleur

13.6.3.1.Introduction

Bien que figurant en troisième position dans le sigle MVC, le contrôleur peut être vu comme le premier étage de la fusée. Comme nous l'avons vu dans le chapitre sur le routage^[où?], la saisie d'une URL dans le navigateur conduit à déclencher une action dans un contrôleur donné.

D'une manière générale, le contrôleur permet de traiter la demande. C'est cette portion de code qui va traiter les paramètres d'entrée, réaliser les opérations demandées (les actions) en manipulant les données (le modèle) et au final retourner un résultat qui, dans la majeure partie des cas devra être affiché (ou restitué sous une forme ou une autre) en passant la main à la vue.

13.6.3.2.Implémentation

La classe contrôleur est une classe qui, le plus souvent, hérite de Zend\Mvc\Controller\AbstractActionController.

Dans l'exemple fourni dans le chapitre sur le routage, l'action appelée était désignée par "monTest" (qui renvoit à la méthode "monTestAction") et le contrôleur baptisé "TestController".

<?php
namespace PHPFacile\Controller;

use Zend\Mvc\Controller\AbstractActionController;

class TestController extends AbstractActionController
{
    public function monTestAction()
    {
        die('A compléter');
    }
}

Libre à vous de choisir l'espace de nom de votre application (dans l'exemple nous avons choisi PHPFacile). Nous avons également choisi de regrouper les contrôleurs dans un dossier et espace de nom Controller. Nous avons donc choisi un espace de nom complet PHPFacile\Controller.
Dans cet exemple, le contrôleur s'appelle TestController (comme ce que nous avions déclaré dans le fichier de routage). A vous d'adapter.
Dans cet exemple, le contrôleur ne contient qu'une seule action, définie par la méthode "monTestAction()" en cohérence, là aussi, avec le fichier de routage qui fait référence à l'action "monTest".
Dans cet exemple, le "passage de témoin" à la vue a été court-circuité par l'instruction die().

Si vous respectez l'arborescence proposée par le squelette d'application Zend, vous aurez une arborescence semblable à:

Depuis ZendSkeletonApplication 3.0.0
Jusque ZendSkeletonApplication 2.5.*

config

module

PHPFacile

config
module.config.php

src

Controller
TestController.php
Model

view

config

module

PHPFacile

config
module.config.php

src

PHPFacile

Controller
TestController.php
Model

view

13.6.3.3.Passage à la vue

Généralement, à l'issue du traitement de la demande par le contrôleur, celui-ci rend la main à la vue qui sera en charge de formatter les données. La plupart du temps, dans le cas d'une application web, il s'agit de générer du code HTML (i.e. afficher une page dans le navigateur) mais il peut également s'agir de générer une chaîne JSON (dans le cadre d'un appel Ajax par exemple), de générer un document PDF, etc.

Ce transfert des données entre le contrôleur et la vue se fait par l'intermédiaire de l'instruction return à la fin de l'action. Comme dans l'exemple suivant:

<?php
namespace PHPFacile\Controller;

use Zend\Mvc\Controller\AbstractActionController;

class TestController extends AbstractActionController
{
    public function monTestAction()
    {
        // Tableau des données à passer à la vue
        return array('variable' => 'valeur');
    }
}

Dans la pratique, nous préférerons retourner un objet de type ViewModel (ou du genre) plutôt qu'un simple tableau mais nous vous expliquons tout cela en détail dans le chapitre suivant.

13.6.3.4.Initialisation

Depuis Zend Framework 2, il n'est plus question de faire appel à une fonction init() pour initialiser le contrôleur. A la place, l'initialisation doit se faire au niveau du constructeur du contrôleur. Il est donc possible de faire comme suit

<?php
namespace PHPFacile\Controller;

use Zend\Mvc\Controller\AbstractActionController;

class TestController extends AbstractActionController
{
    protected $maVariable = null;

    public function __construct()
    {
        $this->maVariable = 'initialisation par le constructeur';
    }

    public function monTestAction()
    {
        // Tableau des données à passer à la vue
        return array('variable' => $this->maVariable);
    }
}

Au niveau du constructeur, il ne sera pas possible d'accéder simplement à la configuration de l'application
Au niveau des méthodes du contrôleur, le tableau contenant toute la configuration de l'application pourra être récupéré via un appel à $this->getServiceLocator()->get('Config') mais en pratique, pour un logiciel bien architecturé, ce n'est pas tellement au niveau des méthodes du contrôleur que cela doit être fait mais au niveau des services ou des "factories" comme nous le verrons par la suite

A dire vrai, ce n'est pas tellement ce cas de figure qui nous intéresse. En pratique, l'initialisation s'appuiera surtout sur des paramètres passés à l'instanciation du contrôleur, comme dans le paragraphe suivant.

Ici vous pouvez apprendre :

1.Introduction
2.Installation de PHP
3.Exécuter un script PHP
4.Configuration et environnement d'exécution de PHP
5.L'environnement de développement
6.Le langage PHP
7.PHP pour le web
8.Internationalisation (i18n) et encodage en PHP
9.Créer un fichier de logs/traces
10.Déboguer une application PHP
11.Programmer en PHP en toute sécurité
12.Bibilothèque PEAR
13.Zend Framework 2 et 3
13.1.Introduction
13.2.Installation
13.3.Utilisation en tant que bibliothèque (pour un script PHP)
13.4.Installation en tant que "coeur" d'une application web
13.5.Routage
13.6.Modèle MVC
13.6.1.Introduction
13.6.2.MVC: Le modèle
13.6.3.MVC: Le contrôleur
13.6.3.1.Introduction
13.6.3.2.Implémentation
13.6.3.3.Passage à la vue
13.6.3.4.Initialisation
13.6.3.5.Passage de paramètres et instanciation
13.6.4.MVC: La vue
13.7.Les bases de données
13.8.LDAP
13.9.Envoyer un e-mail avec Zend Framework 3 et Zend Framework 2
14.Installation de Zend Framework 2
15.Joomla
16.Composer
17.PHPUnit
18.PHPDocumentor
19.Mesure de temps d'exécution (benchmark) d'une fonction PHP
20.Exemples de scripts PHP
21.Erreurs fréquentes et les solutions
22.Archives

Version imprimable: