Requêtes HTTP

Parcours d’une requête HTTP sous Symfony

1. Le client via le navigateur tape une URL et arrive sur notre application.

2. Il arrive sur index.php (dans public), qui retourne juste une instance de la classe kernel.php.

3. Selon la route choisie, le kernel dirige vers le contrôleur concerné, qui appelle le Twig associé qui, lui, retourne la page HTML.

4. Pour afficher le Twig, le contrôleur requête une base de données via l’entité concernée.

Quand quelqu’un arrive sur le site, une instance de Request est créée. La requête au serveur se fait donc par une URL et est gérée par le fichier .htaccess, qui redirige forcément sur index.php et bloque l’accès aux autres dossiers.

Le système de routage se fait avec une URL qui correspond à une méthode. Chaque URL est appelée une route et porte un nom unique.

Les contrôleurs contiennent les fonctions appelées par le système de routage. Un contrôleur peut contenir plusieurs fonctions et donc correspondre à plusieurs routes.

Ils héritent de AbstractController, qui connait toutes les méthodes servant à retourner des réponses HTTP, grâce au paquet ...\HttpFoundation\Response.

Le moteur de templates remplace le PHP et génère du HTML, ce qui simplifie la lecture et l’écriture. Il correspond à la Vue du modèle MVC.

Conventions :

- dans le dossier templates/ - une extension .html.twig

- un fichier twig par méthode de contrôleur

- le même nom que la méthode associée (ça va bloquer sinon)

- dans un sous-dossier qui porte le même nom que le contrôleur

- sans majuscules (snake_case pour les noms de méthodes)

Pour déclencher l’affichage du fichier twig, on met un return dans la méthode du contrôleur qui conduit vers le twig : $this->render("main/home.html.twig");.

Premiers contrôleur et Twig

Dans le terminal de l’IDE (ici, PhpStorm) :

• on installe le paquet requis : composer require symfony/maker-bundle --dev

• on crée le contrôleur : symfony console make:controller
  • choix du nom (on peut aussi écrire le nom directement dans la commande) : Home

  ℹ️

  Il renomme automatiquement tous les contrôleurs en ajoutant Controller à la fin : HomeController.

• Le contrôleur est créé et mis au bon endroit : src/Controller/HomeController.php

Tout est pré-défini et généré.

C’est une classe PHP qui hérite bien de AbstratController, avec une méthode index() à modifier à façon.

BP : Le nom de la route est par convention “nomducontroleur_nomdelamethode”. Il y a beaucoup de routes, il faut s’appliquer.

<?php

namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\Routing\Annotation\Route;

class HomeController extends AbstractController
{
    #[Route('/', name: 'home_index')]
    public function index(): Response
{
      return $this->json([
          'message' => 'Welcome to your new controller!',
          'path' => 'src/Controller/HomeController.php',
      ]);
}

Le # peut être appelé métadata ou attribut : le Kernel lit cette ligne pour connaître le nom unique et l’url liés à cette méthode.

class HomeController extends AbstractController
{
		/**
		* @Route('/', name= 'home_index')
		*/
    public function index(): Response
{
      return $this->json([
          'message' => 'Welcome to your new controller!',
          'path' => 'src/Controller/HomeController.php',
      ]);
}

Lorsqu’on lance le serveur symfony server:start et qu’on écrit l’url voulue du contrôleur, le résultat de la fonction s’affiche.

Néanmoins, on ne veut pas du JSON mais du HTML : on télécharge le moteur de templates Twig : composer require twig.

On modifie le contrôleur pour qu’il retourne un Twig :

• le type retourné par la fonction est Response

• on importe le bon module : use Symfony\Component\HttpFoundation\Response;

• on utilise la fonction render(), qui retourne un fichier .html.twig

class HomeController extends AbstractController
{
    #[Route('/', name: 'home_index')]
    public function index(): Response
    {
        return $this->render('home/index.html.twig');
    }
}

Le fichier Twig n’existe, l’IDE propose de le créer.

Il est maintenant disponible dans templates/home/index.html.twg.

On peut y ajouter du html et lorsqu’on va sur l’url, la page HTML s’affiche.

<!doctype html>
<html lang="fr">
<head>
    <meta charset="UTF-8">
    <title>Hello Symfony</title>
</head>
<body>
    <h1>Un premier Twig</h1>
    <p>C'est ma page d'accueil.</p>
</body>
</html>

Parcours d’une requête HTTP