FR

Routes d'un contrôleur

Ouvrez un contrôleur Symfony (une classe de src/Controller, avec #[Route], ou qui étend AbstractController) : un panneau Routes du contrôleur apparaît sous son code, dans le groupe de l'éditeur. Il reste caché pour tous les autres fichiers. Cliquez sa barre pour le replier ou le déplier (l'IDE s'en souvient) ; il suit ce que vous tapez (un instant après la dernière frappe) et garde la dernière bonne liste tant que le code ne se parse pas.

La barre indique le nombre de routes, le préfixe de la classe (#[Route('/blog', name: 'blog_')]) et un bouton + Ajouter une action.

Ce que montre chaque route

  • les méthodes HTTP (badges), le chemin avec le préfixe de la classe fusionné (paramètres en couleur), le nom de la route (préfixe compris) et l'action : cliquez show() pour aller à sa ligne ;
  • les contraintes (requirements: et {id<\d+>} en ligne) et les valeurs par défaut ;
  • les paramètres : les paramètres de la route face aux arguments de la méthode : une valeur de route, une entité chargée par {id} ou par #[MapEntity] / #[ParamConverter], #[MapRequestPayload], #[MapQueryString], #[MapQueryParameter], l'utilisateur courant. Un paramètre que l'action ne prend pas est marqué « inutilisé par l'action » ;
  • la sécurité : #[IsGranted] sur la classe et sur l'action, denyAccessUnlessGranted() dans le corps, et la règle access_control de config/packages/security.yaml que le chemin reçoit (le même évaluateur que la fenêtre Sécurité) ;
  • les templates rendus (render(), renderForm(), #[Template]) : cliquez pour ouvrir le fichier (barré en rouge s'il n'existe pas), les routes vers lesquelles elle redirige avec redirectToRoute() (clic : cette route, dans ce contrôleur ou un autre), les types de formulaire créés (clic : la classe) et ses réponses JSON ($this->json(), JsonResponse, avec les clés d'un tableau littéral).

Actions

  • Ouvrir dans le navigateur : l'adresse du site (celle du client HTTP : DEFAULT_URI du .env, ou le port donné par web:serve) plus le chemin ; chaque {paramètre} est demandé, avec un exemple proposé.
  • Envoyer une requête : crée la requête dans le client HTTP ({{baseUrl}} + le chemin, un corps JSON pour un #[MapRequestPayload]) dans la première collection et l'ouvre.
  • Copier l'URL, Copier le nom de la route.
  • + Ajouter une action : demande un nom, puis montre la nouvelle méthode (#[Route], public function nom(): Response, les lignes use) sous forme de différence en fin de classe avant d'écrire quoi que ce soit.