Le routage

Organisation de l’application

Dans notre application, nous n’avons pour l’instant qu’un seul contrôleur, TestController, et, à l’intérieur de celui-ci, deux actions : index() et redirection(). Il est facile d’imaginer que, dans la pratique, vous aurez plusieurs contrôleurs et plusieurs actions disponibles. Chaque action correspondra à une requête de l’utilisateur.

Il faut commencer à se poser la question du découpage de l’application.

Combien vais-je avoir de contrôleurs ?

Combien d’actions aurais-je pour chaque contrôleur ?

Il n’y a pas de règles précises, mais sachez que plus votre application est découpée, mieux c’est.

Pour vous aider dans votre découpage, rappelez-vous qu’une action permet d’afficher une vue. Autrement dit, une action peut être définie pour l’affichage de chacune de vos pages affichées.

Un contrôleur va regrouper plusieurs actions. On peut définir un contrôleur pour chaque type de page, par exemple. Une pratique assez répandue (mais ce n’est pas la seule) est d’avoir un contrôleur pour la partie Front et un contrôleur qui gère le Back Office, c’est-à-dire l’administration de votre site. Un autre critère pour votre découpage est que vos actions...

Intérêt des routes

Les routes sont des indications pour permettre, en fonction d’une requête utilisateur (une URL), de retrouver le contrôleur et l’action à exécuter.

Les routes qui vont permettre d’exécuter les actions sont définies par défaut grâce aux annotations.

Reprenons notre TestController tel qu’il est écrit :

class TestController extends AbstractController 
{ 
 
#[Route('/test', name: 'app_test',methods: ['GET', 'HEAD'] )] 
    public function index(Request $request): Response 
    { 
 
        $response=new Response(); 
 
        $response->setContent('Hello World'); 
        $response->headers->setCookie(Cookie::create('nom', 'Yves')); 
        return $response; 
    } 
} 

L’annotation #Route indique que la requête /test (localhost:8000/test dans le navigateur) va exécuter l’action qui suit, c’est-à-dire index(Request $request). 

Mais comment Symfony sait-il où se trouve le contrôleur à instancier ?

Tout ceci est défini...

Paramètres des routes

Il est possible de définir des paramètres dans une route (comme dans une fonction PHP). Ces paramètres seront automatiquement transmis à l’action dans l’ordre où ils sont donnés.

Prenons un exemple.

Créons une troisième action dans TestController.

Appelons-la hello().

Appliquons-lui une route qui s’appellera /hello :

    #[Route('/hello', name: 'hello')] 
    public function hello() 
    { 
        $response=new Response("Hello !");  
    } 

Si nous souhaitons transmettre le nom et le prénom en paramètres de la route, il faut les indiquer entre {}, comme ci-dessous :

    #[Route('/hello/{nom}/{prenom}', name: 'hello')] 
    public function hello(Request $request,$nom,$prenom) 
    { 
        return new Response("Hello $prenom $nom !");  
 
    }   

Les paramètres sont transmis dans l’ordre donné dans la route et sont récupérés dans la méthode hello ($nom et $prenom), en faisant abstraction de l’objet...

Validation des paramètres

Il est toujours prudent de vérifier les valeurs transmises par le client dans la requête. Celui-ci peut en effet essayer de faire passer du code dans les paramètres (en JavaScript généralement) pour exécuter un traitement qui piratera vos données. C’est le principe d’une faille de sécurité appelée Cross-Site Scripting. 

Pour éviter cela, vous pouvez tester le type des paramètres transmis (comme dans n’importe quelle fonction PHP).

Prenons un exemple.

Ajoutons le paramètre age dans la route, mais en précisant le type du paramètre dans l’action hello() :

    #[Route('/hello/{age}/{nom}/{prenom}', name: 'hello')] 
    public function hello(Request $request, int $age, $nom, $prenom='') 
    { 
 
        return new Response("Hello $prenom $nom vous avez $age   ans!"); 
    } 

int $age précise que le paramètre $age doit être un entier.

Il est possible d’aller plus loin dans les tests des valeurs des paramètres en utilisant l’option requirements.

Cette option permet de définir pour chaque paramètre une expression...