5. Le contrôleur principal 🚦⚓︎

en construction

Introduction⚓︎

Jusqu'ici, chaque contrôleur était étudié individuellement. Dans une application MVC réelle, il existe un contrôleur principal (ou front controller) qui sert de point d'entrée unique : toutes les requêtes passent par lui, et c'est lui qui délègue le traitement au bon contrôleur.

Dans notre application, ce rôle est joué par index.php + controleurPrincipal.php.

A — Analyse du fonctionnement du contrôleur principal 🔍⚓︎

Question 1 — Analyse de l'existant 🔎⚓︎

Documents à utiliser : fichiers du projet, annexes 1, 2 et 3

Rappel : transmission en méthode GET⚓︎

Les paramètres GET sont visibles dans l'URL :

📋 Texte

http://serveur/dossier/index.php?action=connexion

Dans cet exemple : le paramètre action a la valeur connexion.

1.1 — Paramètres GET selon les écrans 📨⚓︎

Naviguer successivement sur les écrans de connexion, recherche et accueil. Relever les URL et compléter le tableau :

Écran	URL complète	Paramètre GET	Valeur
Connexion
Recherche
Accueil

Éléments de réponses ✅

Écran	URL complète	Paramètre GET	Valeur
Connexion	`http://serveur/resto/?action=connexion`	`action`	`connexion`
Recherche	`http://serveur/resto/?action=recherche`	`action`	`recherche`
Accueil	`http://serveur/resto/?action=accueil`	`action`	`accueil`

1.2 — Valeurs possibles de `$action` 🔎⚓︎

Le fichier index.php reçoit tous les paramètres GET :

🐘 PHP

if (isset($_GET["action"])) {
    $action = $_GET["action"];
} else {
    $action = "defaut";
}

$fichier = controleurPrincipal($action);
include "$racine/controleur/$fichier";

À l'aide de l'annexe 1 et de la réponse à la question précédente, indiquer les valeurs que peut prendre la variable $action.

Éléments de réponses ✅

La variable $action peut prendre les valeurs suivantes : "defaut", "recherche", "accueil" et "connexion" (et toutes les autres actions définies dans $lesActions).

1.3 — Structure de `$lesActions` 🗺️⚓︎

La fonction controleurPrincipal() (annexe 2) :

🐘 PHP

function controleurPrincipal($action) {
    $lesActions = array();

    $lesActions["defaut"]      = "listeRestos.php";
    $lesActions["liste"]       = "listeRestos.php";
    $lesActions["detail"]      = "detailResto.php";
    $lesActions["recherche"]   = "rechercheResto.php";
    $lesActions["connexion"]   = "connexion.php";
    $lesActions["deconnexion"] = "deconnexion.php";
    $lesActions["profil"]      = "monProfil.php";

    if (array_key_exists($action, $lesActions)) {
        return $lesActions[$action];
    } else {
        return $lesActions["defaut"];
    }
}

Schématiser la structure de la variable $lesActions :

📋 Texte

$lesActions
├── "defaut"      → "listeRestos.php"
├── "liste"       → "listeRestos.php"
├── ...

Éléments de réponses ✅

📋 Texte

$lesActions (tableau associatif)
├── "defaut"      → "listeRestos.php"
├── "liste"       → "listeRestos.php"
├── "detail"      → "detailResto.php"
├── "recherche"   → "rechercheResto.php"
├── "connexion"   → "connexion.php"
├── "deconnexion" → "deconnexion.php"
└── "profil"      → "monProfil.php"

1.4 — Lien avec la question 1.1 🔗⚓︎

Quelle partie de la structure $lesActions est similaire aux données trouvées en question 1.1 ?

Éléments de réponses ✅

Les clés du tableau associatif $lesActions ("connexion", "recherche", "accueil"…) sont similaires aux valeurs du paramètre action transmises dans les URL en méthode GET. C'est bien l'action reçue qui sert de clé pour retrouver le fichier contrôleur à charger.

1.5 — Valeurs transmises à `controleurPrincipal()` 📋⚓︎

À partir des questions précédentes, indiquer quelles valeurs peuvent être transmises à la fonction controleurPrincipal().

Éléments de réponses ✅

Les valeurs pouvant être transmises correspondent aux clés du tableau $lesActions : "defaut", "liste", "detail", "recherche", "connexion", "deconnexion", "profil".

1.6 — Valeurs retournées 📋⚓︎

Pour chaque valeur transmise, indiquer quelle valeur sera retournée :

Valeur de `$action`	Valeur retournée
`"liste"`	`"listeRestos.php"`
`"connexion"`
`"detail"`
`"recherche"`
`"profil"`
`"defaut"`

Éléments de réponses ✅

Valeur de `$action`	Valeur retournée
`"liste"`	`"listeRestos.php"`
`"connexion"`	`"connexion.php"`
`"detail"`	`"detailResto.php"`
`"recherche"`	`"rechercheResto.php"`
`"profil"`	`"monProfil.php"`
`"defaut"`	`"listeRestos.php"`

1.7 — Action inexistante 🤔⚓︎

Que se passe-t-il si l'action transmise n'existe pas dans $lesActions ? Quelle valeur est retournée ?

Éléments de réponses ✅

Lorsque l'action transmise n'existe pas dans $lesActions, le bloc else est exécuté et la fonction retourne $lesActions["defaut"], c'est-à-dire "listeRestos.php". L'utilisateur voit donc la liste des restaurants par défaut.

1.8 — Rôle de `array_key_exists()` 🤔⚓︎

Expliquer l'utilité de la condition utilisant array_key_exists() dans la fonction.

Documentation PHP : array_key_exists(mixed $key, array $array) : bool
Retourne true si la clé $key existe dans le tableau $array.

Éléments de réponses ✅

array_key_exists() permet de vérifier si l'action demandée existe dans le tableau $lesActions avant d'y accéder. Sans cette vérification, accéder à une clé inexistante ($lesActions["actionInexistante"]) générerait un avertissement PHP et retournerait null. La fonction protège ainsi contre les URL mal formées ou les tentatives d'accès à des actions non définies.

1.9 — Contrôleur appelé sans paramètre GET 🔎⚓︎

Quel script contrôleur est appelé par index.php lorsque la variable GET action n'est pas renseignée ?

Éléments de réponses ✅

Lorsque action n'est pas renseignée, index.php affecte "defaut" à $action. La fonction controleurPrincipal("defaut") retourne "listeRestos.php" : c'est la liste des restaurants qui s'affiche.

1.10 — Contrôleur appelé avec `action=liste` 🔎⚓︎

Quel script contrôleur est appelé par index.php lorsque action vaut "liste" ?

Éléments de réponses ✅

Lorsque action vaut "liste", la fonction retourne "listeRestos.php" — même résultat que "defaut", car les deux clés pointent vers le même fichier contrôleur.

Synthèse — Le contrôleur principal 📌⚓︎

La variable $lesActions contient l'ensemble des contrôleurs accessibles sur le site. Chaque clé correspond à un script contrôleur.

📋 Texte

URL                              index.php
?action=connexion    ─────────►  controleurPrincipal("connexion")
                                          │
                                          ▼
                                 $lesActions["connexion"]
                                          │
                                          ▼
                                 include connexion.php

Ajouter une nouvelle fonctionnalité⚓︎

Pour intégrer une nouvelle fonctionnalité, il faut :

Créer le contrôleur dans le dossier controleur/
Créer la vue dans le dossier vue/
Créer les fonctions modèle si nécessaire dans modele/
Déclarer l'action dans controleurPrincipal() :

🐘 PHP

$lesActions['uneAction'] = "scriptControleur.php";

Créer le lien pointant vers la nouvelle action :

HTML

<a href="./?action=uneAction">Lien vers la fonctionnalité</a>

Règle importante⚓︎

Les contrôleurs ne sont jamais appelés directement dans l'URL. On passe toujours par index.php et le paramètre action.

B — Intégration de contrôleurs pré-existants 🔧⚓︎

Question 2 — CGU (Conditions Générales d'Utilisation) 📜⚓︎

Documents à utiliser : fichiers du projet, annexe 4

2.1 — Action correspondant aux CGU 🔎⚓︎

Repérer dans le menu général l'action correspondant au contrôleur des CGU.

Éléments de réponses ✅

Dans le menu général, le lien vers les CGU est :

HTML

<li><a href="./?action=cgu">CGU</a></li>

L'action associée est "cgu".

2.2 — Placement des fichiers 📁⚓︎

Placer les fichiers fournis en ressource dans les dossiers appropriés (controleur/ et vue/).

Éléments de réponses ✅

cgu.php → dossier controleur/
vueCgu.php → dossier vue/

2.3 — Instruction à ajouter ✏️⚓︎

Rédiger l'instruction à ajouter dans controleurPrincipal() pour intégrer les CGU :

🐘 PHP

$lesActions["___"] = "___";

Éléments de réponses ✅

🐘 PHP

$lesActions["cgu"] = "cgu.php";

Cette ligne est à insérer dans la fonction controleurPrincipal(), juste après les autres initialisations de $lesActions.

2.4 — Test 🧪⚓︎

Ajouter la nouvelle action à la fonction, puis tester le lien CGU dans le menu.

Question 3 — Aimer un restaurant ⭐⚓︎

Documents à utiliser : fichiers du projet, annexe 5

3.1 — Vue de la fiche descriptive 🖼️⚓︎

Quelle vue permet d'afficher la fiche descriptive d'un restaurant ?

Éléments de réponses ✅

Le fichier vueDetailResto.php permet d'afficher la fiche descriptive d'un restaurant.

3.2 — Le lien de l'étoile 🔎⚓︎

Repérer dans le code de la vue le lien correspondant à l'étoile ⭐.

Éléments de réponses ✅

🐘 PHP

<?php if ($aimer != false) { ?>
    <a href="./?action=aimer&idR=<?= $unResto['idR']; ?>">
        <img class="aimer" src="images/aime.png" alt="j'aime ce restaurant">
    </a>
<?php } else { ?>
    <a href="./?action=aimer&idR=<?= $unResto['idR']; ?>">
        <img class="aimer" src="images/aimepas.png" alt="je n'aime pas encore ce restaurant">
    </a>
<?php } ?>

3.3 — Paramètres transmis en GET 📨⚓︎

Quels sont les paramètres envoyés en méthode GET lors du clic sur l'étoile ? Préciser le nom et la valeur de chaque paramètre.

Paramètre	Valeur

Éléments de réponses ✅

Paramètre	Valeur
`action`	`"aimer"`
`idR`	identifiant du restaurant affiché (ex: `7`)

3.4 — Utilisation des paramètres 🔎⚓︎

À partir du script contrôleur fourni, déterminer dans quels scripts sont utilisées les deux variables transmises en GET.

Éléments de réponses ✅

Le paramètre action est utilisé par index.php pour sélectionner le contrôleur à charger.
Le paramètre idR est utilisé par le contrôleur aimer.php pour savoir quel restaurant l'utilisateur souhaite aimer.

3.5 — Placement du fichier contrôleur 📁⚓︎

Placer le fichier contrôleur fourni dans le dossier approprié.

Éléments de réponses ✅

aimer.php est un fichier contrôleur → il doit être placé dans le dossier controleur/.

3.6 — Instruction à ajouter au contrôleur principal ✏️⚓︎

Rédiger l'instruction à ajouter dans controleurPrincipal() pour la nouvelle action "aimer" :

🐘 PHP

$lesActions["___"] = "___";

Éléments de réponses ✅

🐘 PHP

$lesActions["aimer"] = "aimer.php";

3.7 — Test 🧪⚓︎

Ajouter la nouvelle action, puis tester en cliquant sur l'étoile (vous devez être authentifié).

3.8 — Vue dans `aimer.php` 🖼️⚓︎

Le contrôleur aimer.php fait-il appel à une vue ?

Éléments de réponses ✅

Non. Le contrôleur aimer.php ne contient aucune inclusion de vue. Il effectue l'action (enregistrer le "j'aime" en base), puis redirige l'utilisateur vers la page précédente.

3.9 — Le `referer` HTTP 🌐⚓︎

En fin de contrôleur se trouve cette instruction :

🐘 PHP

header('Location: ' . $_SERVER['HTTP_REFERER']);

Rechercher la signification du terme referer en HTTP.

Pour comprendre son fonctionnement : 1. Commenter l'instruction header() ci-dessus 2. Afficher à la place la valeur de $_SERVER['HTTP_REFERER'] 3. Tester l'action d'aimer sur un restaurant

Éléments de réponses ✅

Le referer (ou referrer) HTTP est l'URL de la page sur laquelle se trouvait le lien qui a mené à la page actuelle. C'est le navigateur qui transmet cette information au serveur dans l'en-tête HTTP Referer.

3.10 — Contenu de `$_SERVER['HTTP_REFERER']` 🔎⚓︎

Que contient la variable $_SERVER['HTTP_REFERER'] ?

Éléments de réponses ✅

La variable contient l'URL de la fiche restaurant que l'on consultait, par exemple :

📋 Texte

http://serveur/resto/?action=detail&idR=7

3.11 — Rôle de l'instruction `header()` 🤔⚓︎

Déduire de vos observations le rôle de :

🐘 PHP

header('Location: ' . $_SERVER['HTTP_REFERER']);

Éléments de réponses ✅

Cette instruction redirige le navigateur vers la page précédente (la fiche du restaurant). Ainsi, après avoir cliqué sur l'étoile, l'utilisateur revient automatiquement sur la fiche du restaurant, sans que la page change visuellement — seule l'étoile change d'état.

Question 4 — Inscription 📝⚓︎

4.1 — Rendre l'inscription fonctionnelle ✏️⚓︎

Analyser le lien d'inscription, puis apporter les modifications nécessaires pour rendre l'inscription fonctionnelle.

Le modèle, la vue et le contrôleur sont déjà disponibles. Reprendre la même logique que pour les exercices précédents : 1. Identifier l'action dans le lien 2. Placer les fichiers dans les bons dossiers 3. Ajouter l'action dans controleurPrincipal() 4. Tester

Éléments de réponses ✅

Le lien d'inscription utilise l'action "inscription".
Placer les fichiers :
- inscription.php → dossier controleur/
- vueInscription.php → dossier vue/

Ajouter dans controleurPrincipal() :

🐘 PHP

$lesActions["inscription"] = "inscription.php";

Tester en cliquant sur le lien "Inscription" dans la page de connexion.

Bilan de la série de TP 🏆⚓︎

Vous avez maintenant étudié et manipulé les 4 composants d'une application MVC en PHP :

Composant	Fichiers	Rôle
Contrôleur principal	`index.php`, `controleurPrincipal.php`	Point d'entrée, routage
Contrôleur	`controleur/*.php`	Logique applicative, coordination
Vue	`vue/*.php`	Affichage HTML
Modèle	`modele/bd.*.inc.php`	Accès aux données (PDO)

Flux complet d'une requête⚓︎

📋 Texte

Navigateur
    │  GET /?action=detail&idR=3
    ▼
index.php
    │  $action = "detail"
    ▼
controleurPrincipal("detail")
    │  retourne "detailResto.php"
    ▼
controleur/detailResto.php
    │  $idR = $_GET['idR']             ← données utilisateur
    │  $unResto = getRestoByIdR($idR)  ← appel modèle
    │  $lesPhotos = getPhotosByIdR...  ← appel modèle
    ▼
modele/bd.resto.inc.php
    │  SELECT * FROM resto WHERE idR=3
    ▼
Base de données MariaDB
    │  résultat
    ▼
controleur/detailResto.php
    │  include entete.html.php
    │  include vueDetailResto.php      ← rendu HTML
    │  include pied.html.php
    ▼
Navigateur
    HTML final envoyé au client

← Partie 4 | Retour à la présentation

5. Le contrôleur principal 🚦⚓︎

Introduction⚓︎

A — Analyse du fonctionnement du contrôleur principal 🔍⚓︎

Question 1 — Analyse de l'existant 🔎⚓︎

Rappel : transmission en méthode GET⚓︎

1.1 — Paramètres GET selon les écrans 📨⚓︎

1.2 — Valeurs possibles de $action 🔎⚓︎

1.3 — Structure de $lesActions 🗺️⚓︎

1.4 — Lien avec la question 1.1 🔗⚓︎

1.5 — Valeurs transmises à controleurPrincipal() 📋⚓︎

1.6 — Valeurs retournées 📋⚓︎

1.7 — Action inexistante 🤔⚓︎

1.8 — Rôle de array_key_exists() 🤔⚓︎

1.9 — Contrôleur appelé sans paramètre GET 🔎⚓︎

1.10 — Contrôleur appelé avec action=liste 🔎⚓︎

Synthèse — Le contrôleur principal 📌⚓︎

Ajouter une nouvelle fonctionnalité⚓︎

Règle importante⚓︎

B — Intégration de contrôleurs pré-existants 🔧⚓︎

Question 2 — CGU (Conditions Générales d'Utilisation) 📜⚓︎

2.1 — Action correspondant aux CGU 🔎⚓︎

2.2 — Placement des fichiers 📁⚓︎

2.3 — Instruction à ajouter ✏️⚓︎

2.4 — Test 🧪⚓︎

Question 3 — Aimer un restaurant ⭐⚓︎

3.1 — Vue de la fiche descriptive 🖼️⚓︎

3.2 — Le lien de l'étoile 🔎⚓︎

3.3 — Paramètres transmis en GET 📨⚓︎

3.4 — Utilisation des paramètres 🔎⚓︎

3.5 — Placement du fichier contrôleur 📁⚓︎

3.6 — Instruction à ajouter au contrôleur principal ✏️⚓︎

3.7 — Test 🧪⚓︎

3.8 — Vue dans aimer.php 🖼️⚓︎

3.9 — Le referer HTTP 🌐⚓︎

3.10 — Contenu de $_SERVER['HTTP_REFERER'] 🔎⚓︎

3.11 — Rôle de l'instruction header() 🤔⚓︎

Question 4 — Inscription 📝⚓︎

4.1 — Rendre l'inscription fonctionnelle ✏️⚓︎

Bilan de la série de TP 🏆⚓︎

Flux complet d'une requête⚓︎

1.2 — Valeurs possibles de `$action` 🔎⚓︎

1.3 — Structure de `$lesActions` 🗺️⚓︎

1.5 — Valeurs transmises à `controleurPrincipal()` 📋⚓︎

1.8 — Rôle de `array_key_exists()` 🤔⚓︎

1.10 — Contrôleur appelé avec `action=liste` 🔎⚓︎

3.8 — Vue dans `aimer.php` 🖼️⚓︎

3.9 — Le `referer` HTTP 🌐⚓︎

3.10 — Contenu de `$_SERVER['HTTP_REFERER']` 🔎⚓︎

3.11 — Rôle de l'instruction `header()` 🤔⚓︎