# Programmation PHP avec Symfony/Contrôleur

* Introduction
* Service
** Contrôleur
** Commande
* Composant
** HttpClient
** Évènement
** Formulaire
** Mailer
** Stimulus
* Bundle
** Twig
** Doctrine
** API
* Introduction
* Service
** Contrôleur
** Commande
* Composant
** HttpClient
** Évènement
** Formulaire
** Mailer
** Stimulus
* Bundle
** Twig
** Doctrine
** API
[ Modifier le sommaire ]

## Principe

Les contrôleurs Symfony sont les classes qui définissent les opérations à réaliser quand on visite les pages du sites : elles transforment une requête HTTP en réponse (JSON, XML (dont HTML), etc.).
Par convention, leurs noms se terminent par Controller, les noms de leurs méthodes se terminent par "Action", et les URL qui provoquent leurs exécutions sont définies dans leurs annotations. L'exemple suivant affiche un texte quand on visite l'adresse "/" ou "/helloWorld" :
NB : en PHP < 8, remplacer l'attribut par une annotation :

## Retours

Ces méthodes peuvent déboucher sur plusieurs actions :
* Response : affiche un texte, et facultativement un code HTTP en deuxième paramètre (ex : erreur 404).
** JsonResponse ou $this->json : affiche du JSON.
** RedirectResponse : renvoie vers une autre adresse. Si elle se trouve dans la même application, on peut aussi utiliser le $this->forward hérité du contrôleur abstrait.
** BinaryFileResponse : renvoie un fichier à télécharger (à partir de son chemin).
* $this->redirect('mon_url') : redirige à une autre adresse.
* $this->redirectToRoute('nom_de_la_route'); : redirige vers une route du site par son nom.
* $this->generateUrl('app_mon_chemin',); : redirige vers une URL relative (ajouter UrlGeneratorInterface::ABSOLUTE_URL en paramètre 3 pour l'absolue, car il est à UrlGeneratorInterface::ABSOLUTE_PATH par défaut dans SF3).
* $this->container->get('router')->generate('app_mon_chemin', ['paramètre' => 'mon_paramètre']);.
* $this->render : affiche une page à partir d'un template, par exemple HTML ou Twig.

## Requêtes

L'objet Request est à préférer à la variable superglobale $_REQUEST, car il fournit une sécurité et des méthodes de manipulation. Ex :
* $request->getMethod : la méthode HTTP utilisée.
* $request->query : les arguments $_GET (query param).
* $request->request : les arguments $_POST (lui préférer $request->getContent).
* $request->files : les fichiers $_FILES (dans un itérable FileBag).

## ParamConverter

On peut injecter un ID dans l'URL ou la requête pour le CRUD d'une entité, mais grâce au paramConverter on peut aussi injecter directement l'entité. Ex :
Avant Symfony 6.2 cela fonctionne avec un composer require sensio/framework-extra-bundle.

## Flashbag

On peut aussi ajouter un bandeau de message temporaire en en-tête via :
Le Twig peut les récupérer ensuite avec :
En effet, ils sont stockés dans un Flashbag : un objet de session.
De plus, il en existe plusieurs types (chacun avec une couleur) : success, notice, info, warning, error.
Le fait de lire les flash (au moins depuis les Twig avec app.flashes) vide leur tableau.

## Accès aux paramètres et services

Les contrôleurs étendent la classe abstraite Symfony\Bundle\FrameworkBundle\Controller\AbstractController. Cela leur permettait entre autres dans Symfony 2, de récupérer les services et paramètres ainsi :
Depuis Symfony 4, il faut injecter le service service_container pour accéder à la liste des services publiques (public: true en YAML), mais la bonne pratique est d'injecter uniquement les services nécessaires dans le constructeur.
Les paramètres sont ceux des fichiers .yml du dossier "config", mais plusieurs autres paramètres sont fournis par Symfony :
* kernel.debug : renvoie vrai si le site est en préprod et faux en prod.
* kernel.project_dir : dossier racine (qui contient bin/, config/, src/, var/, vendor/).
* kernel.build_dir.
* kernel.cache_dir.
* kernel.logs_dir.
* kernel.root_dir : deprecated en SF5.3. Chemin du site dans le système de fichier.
* kernel.bundles : liste JSON des bundles chargés.

## Routing

Par exemple pour créer une nouvelle page sur l'URL :
Installer le routage :
Par défaut, la page renvoie l'exception No route found for "GET /test". Pour la créer, il faut d'abord générer un fichier contrôleur (rôle MVC), qui fera le lien entre les URL, les données (modèle) et les pages (vue).
Les URL définies dans l'attribut (ou l'annotation) "route" d'une méthode exécuteront cette dernière :
NB : en PHP < 8, remplacer l'attribut par une annotation :
Autres exemples de prérequis :
* requirements={"id"="fr|en"}
* requirements={"id"="MaClasse::MA_CONSTANTE1|MaClasse::MA_CONSTANTE2"}
* requirements={"id"="(?!api/doc|_profiler).*"}

### Alias

Pour créer des alias, c'est-à-dire plusieurs autres URL pointant vers la page ci-dessus, on peut l'ajouter dans les annotations des contrôleurs, ou bien dans config/routes.yaml (anciennement app\config\routing.yml sur Symfony < 4) :
À présent http://localhost:8000/test/1 ou http://localhost:8000/test/2 affichent "Hello World!".
* Une fois le YAML sauvegardé, l'URL fournie en annotation (/test) ne fonctionne plus.
* S'il y a des annotations précédant @Route dans le même bloc, cela peut inhiber son fonctionnement.

### Redirection vers la dernière page visitée

Une astuce pour rediriger l'utilisateur vers la dernière page qu'il avait visité :

### Annotations.yaml

Ce fichier permet de définir des groupes de contrôleurs, dont les routes sont préfixées. Ex :
Dans le cas où les contrôleurs ont des contrôles d'accès différents dans security.yaml, il est impératif de les préfixer ainsi pour éviter toute collision des gardiens.

### Paramètres spéciaux

Il existe quatre paramètres spéciaux que l'on peut placer dans routes.yaml ou en argument des méthodes des contrôleurs :
* _controller : contrôleur appelé par le chemin.
* _ format : format de requête (ex : html, xml).
* _fragment : partie de l'URL après "#".
* _locale : langue de la requête (code ISO, ex : fr, en).
Exemple :

## Vue

Pour commencer à créer des pages plus complexes, il suffit de remplacer :
par une vue issue d'un moteur de template. Celui de Symfony est Twig :
Pour installer les bibliothèques JavaScript qui agiront sur ces pages, se positionner dans /public. Exemple :
Ensuite il suffit de les appeler dans /templates/helloWorld.html.twig pour pouvoir les utiliser :

## Modèle

Pour gérer le modèle du MVC, c'est-à-dire la structure des données stockées, l'ORM officiel de Symfony se nomme Doctrine.
Par défaut, ses classes sont :
* src/Entity : les entités, reflets des tables.
* src/Repository : les requêtes SELECT SQL (ou find MongoDB).

## Tester un contrôleur

    Pour plus de détails voir : Programmation PHP avec Symfony/HttpClient#Tests.

## Références

* ↑ https://symfony.com/doc/current/controller.html
* ↑ https://stackoverflow.com/questions/14449967/symfony-setting-flash-and-checking-in-twig
* ↑ https://symfony.com/doc/current/best_practices.html#use-dependency-injection-to-get-services
* ↑ https://symfony.com/doc/4.0/best_practices/controllers.html#fetching-services
* ↑ https://symfony.com/doc/current/security/voters.html
* ↑ https://symfony.com/doc/current/routing.html#special-routing-parameters