33 lines
2.6 KiB
Markdown
33 lines
2.6 KiB
Markdown
# 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.
|