TD1 – Paquets PHP Composer, Routage via l'URL

Récupérer le code de base en forkant vous-même ce dépôt GitLab.

setfacl -R -m u:www-data:r-x .

Comme le site enregistre une photo de profil pour chaque utilisateur, il faut donner les droits en écriture sur le dossier ressources/img/utilisateurs/.

setfacl -R -m u:www-data:rwx ./ressources/img/utilisateurs

• Pour MySQL, vous devez :
  • exécuter le script d’import MySQL,
  • mettre à jour le fichier de configuration src/Configuration/ConfigurationBDDMySQL.php avec votre login et mot de passe.
• Pour PostgreSQL, vous devez :
  • exécuter le script d’import PostgreSQL,
  • mettre à jour le fichier de configuration src/Configuration/ConfigurationBDDPostgreSQL.php avec votre login et mot de passe,
  • préciser la bonne classe de configuration ConfigurationBDDPostgreSQL au niveau du constructeur de src/Modele/Repository/ConnexionBaseDeDonnees.php
  • dans les classes PublicationRepository et UtilisateurRepository, modifier les $data['nomDeColonne'] pour mettre tous les noms de colonnes en minuscule. En effet, PostgreSQL passe en minuscule tous les identifiants (sauf s’ils sont entourés de guillemets doubles ", auquel car il faudra toujours y faire référence avec des guillemets doubles).

Créez un nouvel utilisateur et une nouvelle publication.
Souvenez-vous bien de votre identifiant et mot de passe car nous nous en resservirons.

Créer un fichier composer.json à la racine du site Web avec le contenu suivant

{
   "autoload": {
      "psr-4": {
         "TheFeed\\": "src"
      }
   }
}

composer update

Aide : Pour ceux qui sont sur leur machine personnelle, vous devrez installer composer sur votre machine. Aller voir la documentation de composer à cet effet. Pour Linux, il suffit d’installer un paquet. Pour Windows avec XAMPP, l’installateur Windows marche très bien.

Quand on installe une application ou un nouveau composant, composer place les librairies téléchargées dans un dossier vendor. Il n’est pas nécessaire de versionner ce dossier souvent volumineux.
Rajoutez donc une ligne /vendor/ à votre .gitignore. Dites aussi à Git d’ignorer son fichier de configuration interne /composer.lock.

Modifiez le fichier web/controleurFrontal.php comme suit :

-use TheFeed\Lib\Psr4AutoloaderClass;
-
-require_once __DIR__ . '/../src/Lib/Psr4AutoloaderClass.php';
-
-// initialisation en désactivant l'affichage de débogage
-$chargeurDeClasse = new Psr4AutoloaderClass(false);
-$chargeurDeClasse->register();
-// enregistrement d'une association "espace de nom" → "dossier"
-$chargeurDeClasse->addNamespace('TheFeed', __DIR__ . '/../src');
+require_once __DIR__ . '/../vendor/autoload.php';

Aide : Ce format montre une modification de fichier, similaire à la sortie de git diff. Les lignes qui commencent par des + sont à ajouter, et les lignes avec des - à supprimer.

Dans le fichier web/controleurFrontal.php, faites le changement suivant. Toutes les lignes supprimées de ce fichier doivent être déplacées dans la méthode statique traiterRequete d’une nouvelle classe src/Controleur/RouteurQueryString.php.

-// Syntaxe alternative
-// The null coalescing operator returns its first operand if it exists and is not null
-$action = $_REQUEST['action'] ?? 'afficherListe';
-
-
-$controleur = "publication";
-if (isset($_REQUEST['controleur']))
-    $controleur = $_REQUEST['controleur'];
-
-$controleurClassName = 'TheFeed\Controleur\Controleur' . ucfirst($controleur);
-
-if (class_exists($controleurClassName)) {
-    if (in_array($action, get_class_methods($controleurClassName))) {
-        $controleurClassName::$action();
-    } else {
-        $controleurClassName::afficherErreur("Erreur d'action");
-    }
-} else {
-    \TheFeed\Controleur\ControleurGenerique::afficherErreur("Erreur de contrôleur");
-}
+\TheFeed\Controleur\RouteurQueryString::traiterRequete();

Testez votre site qui doit marcher normalement.

Créez une nouvelle classe src/Controleur/RouteurURL.php vide avec le code suivant.

<?php
namespace TheFeed\Controleur;

class RouteurURL
{
   public static function traiterRequete() { }
}

Appelez ce nouveau routeur en modifiant web/controleurFrontal.php :

-TheFeed\Controleur\RouteurQueryString::traiterRequete();
+TheFeed\Controleur\RouteurURL::traiterRequete();

Exécutez la commande suivante dans le terminal ouvert au niveau de la racine de votre site web

composer require symfony/http-foundation

Remarque : Certaines dépendances de Symfony nécessite une version de PHP > 8.1. Si vous n’avez pas cette version sur votre machine personnelle, vous pouvez peut-être demander une version plus ancienne de cette dépendance.

use Symfony\Component\HttpFoundation\Request;

$requete = Request::createFromGlobals();

Explication : La méthode createFromGlobals() récupère les informations de la requête depuis les variables globales $_GET, $_POST, … Elle est à peu près équivalente à

$requete = new Request($_GET,$_POST,[],$_COOKIE,$_FILES,$_SERVER);

La méthode $requete->getPathInfo() permet d’accéder au bout d’URL qui nous intéresse (/publications, /connexion ou /inscription).

Affichez cette variable dans RouteurURL::traiterRequete() et accédez aux URL précédentes pour voir le chemin s’afficher.

composer require symfony/routing

Créez votre première route avec le code suivant à insérer dans RouteurURL::traiterRequete() :

use Symfony\Component\Routing\Route;
use Symfony\Component\Routing\RouteCollection;

$routes = new RouteCollection();

// Route afficherListe
$route = new Route("/publications", [
   "_controller" => "\TheFeed\Controleur\ControleurPublication::afficherListe",
]);
$routes->add("afficherListe", $route);

Explication : Une nouvelle Route $route associe au chemin /publications la méthode afficherListe() de ControleurPublication. Puis cette route est ajoutée dans l’ensemble de toutes les routes RouteCollection $routes.

use Symfony\Component\Routing\RequestContext;

$contexteRequete = (new RequestContext())->fromRequest($requete);

Ajoutez cette ligne et affichez temporairement son contenu.

use Symfony\Component\Routing\Matcher\UrlMatcher;

$associateurUrl = new UrlMatcher($routes, $contexteRequete);
$donneesRoute = $associateurUrl->match($requete->getPathInfo());

Ajoutez ce code et affichez temporairement le contenu de $donneesRoute. Où se trouve l’information de la méthode PHP à appeler ?

call_user_func($donneesRoute["_controller"]);

Explication : La fonction call_user_func($nomFonction) exécute la fonction dont le nom est stocké dans $nomFonction. Elle est proche du code $nomFonction(), mais accepte des entrées plus générales – nous la préférerons donc.

Ajoutez la deuxième route :

use TheFeed\Controleur\ControleurUtilisateur;

// Route afficherFormulaireConnexion
$route = new Route("/connexion", [
   "_controller" => "\TheFeed\Controleur\ControleurUtilisateur::afficherFormulaireConnexion",
   // Syntaxes équivalentes 
   // "_controller" => ControleurUtilisateur::class . "::afficherFormulaireConnexion",
   // "_controller" => [ControleurUtilisateur::class, "afficherFormulaireConnexion"],
]);
$routes->add("afficherFormulaireConnexion", $route);

Notez les syntaxes équivalentes :

• l’attribut statique constant NomDeClasse::class d’une classe NomDeClasse est remplacé par le nom de classe qualifié, c.-à-d. le nom de classe précédé du nom de package. Ici, ControleurUtilisateur::class a pour valeur la chaîne de caractères \TheFeed\Controleur\ControleurUtilisateur.
• De manière générale, la valeur associée à _controller devra être au format callable, car c’est ce qui est accepté par call_user_func(). Parmi les callable, on trouve le format "NomDeClasseQualifie::NomMethodeStatique ou ["NomDeClasseQualifie", "NomMethodeStatique"] pour les méthodes statiques, ou encore [$instanceDeLaClasse, "NomMethode"] pour les méthodes classiques.

Testez la page web/controleurFrontal.php/connexion qui doit marcher, sauf les liens vers le CSS et les photos qui deviennent invalides. Cherchez pourquoi ces liens se sont cassés.

Aide : Dans le code source de la page Web (Ctrl+U), cliquez sur ces liens cassés pour voir sur quel URL ils renvoient.

Enregistrez ce fichier de configuration d’Apache fourni par Symfony à la place de web/.htaccess.

Remarque :

• Si la réécriture d’URL ne marche pas à l’IUT (message d’erreur Internal Server Error), vous avez peut-être enregistré le fichier dans .htaccess au lieu de web/.htaccess.
• Si la réécriture d’URL sur votre machine personnelle ne marche pas, une cause possible est qu’il faut activer le module mod_rewrite de votre serveur Apache.

Testez que la page web/connexion marche et que le CSS et les images sont revenus. En effet, l’URL de base des liens relatifs est de nouveau web/.

Changez les liens dans vueGenerale.php :

-<a href="controleurFrontal.php?controleur=publication&action=afficherListe"><span>The Feed</span></a>
+<a href="./publications"><span>The Feed</span></a>

-<a href="controleurFrontal.php?controleur=publication&action=afficherListe">Accueil</a>
+<a href="./publications">Accueil</a>

-<a href="controleurFrontal.php?action=afficherFormulaireConnexion&controleur=utilisateur">Connexion</a>
+<a href="./connexion">Connexion</a>

Modifiez votre routeur pour avoir les 2 routes web/connexion selon la méthode HTTP.

Attention : Le nom de chaque route doit être unique ($routes->add("nomRoute", $route);). Si vous définissez deux routes avec le même nom, la deuxième écrase la première.

Corrigez l’URL vers laquelle renvoie src/vue/utilisateur/formulaireConnexion.php.

Essayez de vous connecter au site : vous devez avoir une erreur Uncaught Symfony\...\NoConfigurationException. En effet, si la connexion réussit, alors elle redirige vers l’ancienne adresse web/?action=afficherListe&controleur=publication. Comme cette adresse est désormais inconnue, Symfony nous renvoie NoConfigurationException.

Pour régler temporairement le problème des redirections (qui sera traité proprement à la fin du TD), rajoutons une route pour l’URL web/. Dupliquez la route afficherListe en changeant le path (/publications → /) et en donnant une autre nom à la route pour ne pas écraser la précédente.

Essayez de vous connecter au site. Cela doit marche normalement.

• URL /deconnexion, méthode GET → action deconnecter du contrôleur utilisateur
• URL /inscription, méthode GET → action afficherFormulaireCreation du contrôleur utilisateur
• URL /inscription, méthode POST → action creerDepuisFormulaire du contrôleur utilisateur
• URL /publications, méthode POST → action creerDepuisFormulaire du contrôleur publication.
  Attention : Il y a déjà une autre route associée à l’URL /publications (action afficherListe). Il faudra donc spécifier que l’autre route est limité à la méthode GET.

• src/vue/publication/liste.php,
• src/vue/utilisateur/formulaireCreation.php
• src/vue/vueGenerale.php.

• URL /utilisateurs/{idUtilisateur}/publications, méthode GET → action afficherPublications du contrôleur utilisateur

Modifiez afficherPublications() pour qu’il prenne $idUtilisateur en argument au lieu de le lire depuis le query string avec $_REQUEST['idUtilisateur'].

-public static function afficherPublications(): void
+public static function afficherPublications($idUtilisateur): void

-    if (isset($_REQUEST['idUtilisateur'])) {
-        $idUtilisateur = $_REQUEST['idUtilisateur'];

-    } else {
-        MessageFlash::ajouter("error", "Login manquant.");
-        ControleurUtilisateur::rediriger("publication", "afficherListe");
-    }

Si vous testez la route, vous verrez qu’elle ne marche pas, car call_user_func appelle afficherPublications sans lui donner d’arguments (il attend $idUtilisateur).

Importez le composant HttpKernel

composer require symfony/http-kernel

Faites évoluer le code de RouteurURL en rajoutant à la fin (juste avant call_user_func)

use Symfony\Component\HttpKernel\Controller\ArgumentResolver;
use Symfony\Component\HttpKernel\Controller\ControllerResolver;

$requete->attributes->add($donneesRoute);

$resolveurDeControleur = new ControllerResolver();
$controleur = $resolveurDeControleur->getController($requete);

$resolveurDArguments = new ArgumentResolver();
$arguments = $resolveurDArguments->getArguments($requete, $controleur);

et en modifiant

-call_user_func($donneesRoute["_controller"]);
+call_user_func_array($controleur, $arguments);

Testez la route web/utilisateurs/19/publications en remplaçant 19 par un identifiant d’utilisateur ayant quelques publications. La page doit remarcher, mais pas le CSS ni les images.

Créez une classe src/Lib/Conteneur.php avec le code suivant :

<?php

namespace TheFeed\Lib;

class Conteneur
{
   private static array $listeServices;

   public static function ajouterService(string $nom, $service) : void {
      Conteneur::$listeServices[$nom] = $service;
   }

   public static function recupererService(string $nom) {
      return Conteneur::$listeServices[$nom];
   }
}

Initialisez les deux services $assistantUrl et $generateurUrl dans RouteurUrl (cf. code plus haut). Puis stockez-les dans le conteneur.

$generateurUrl = new UrlGenerator($routes, $contexteRequete);
$assistantUrl = new UrlHelper(new RequestStack(), $contexteRequete);

Conteneur::ajouterService("generateurUrl", $generateurUrl);
Conteneur::ajouterService("assistantUrl", $assistantUrl);

Récupérez les deux services en haut de la vue vueGenerale.php.

use Symfony\Component\HttpFoundation\UrlHelper;
use Symfony\Component\Routing\Generator\UrlGenerator;
use TheFeed\Lib\Conteneur;

/** @var UrlGenerator $generateurUrl */
$generateurUrl = Conteneur::recupererService("generateurUrl");
/** @var UrlHelper $assistantUrl */
$assistantUrl = Conteneur::recupererService("assistantUrl");

Puis utilisez-les dans toutes les vues pour passer tous les liens en URL absolues, soit à partir du nom d’une route, soit à partir du chemin relatif d’un asset. À la fin, vous devez avoir corrigé tous les liens : <a href="">, <img src="">, <form action=""> et <link href="">.

Remarques :

• $generateurUrl->generate() échappe les caractères spéciaux des URL. Vous devez donc lui donner les données brutes, et non celles échappées par rawurlencode().
• $assistantUrl->getAbsoluteUrl() n’échappe pas les caractères spéciaux des URL. À vous de le faire.
• Vous pouvez utiliser la syntaxe raccourcie <?= $var ?> équivalente à <?php echo $var ?> pour améliorer la lisibilité de vos vues.

Changer la méthode ControleurGenerique::rediriger() pour qu’elle prenne en entrée le nom d’une route et un tableau optionnel de paramètres pour les routes variables (mêmes arguments que $generateurUrl->generate()). Cette fonction doit maintenant rediriger vers l’URL absolue correspondante. Vous aurez besoin de récupérer un service du Conteneur.

Mettez-à-jour tous les appels à ControleurGenerique::rediriger().

Testez votre site.