Aller au contenu principal
Version: 26.0.9.0

route

La fonction route() permet de générer des URLs en utilisant le nom des routes définies dans votre application. Elle s'appuie sur le service Router d'Elementum.

Utilisation​

{{ route(nom_de_la_route, parametres, reference_type) }}

Exemples​

Lien simple vers une route​

<a href="{{ route('accueil') }}">Page d'accueil</a>

Lien avec des paramètres​

{# Pour une route comme /article/{slug} #}
<a href="{{ route('article_show', {'slug': 'mon-article'}) }}">
    Voir l'article
</a>

Lien absolu​

{# Génère une URL absolue #}
{{ route('contact', {}, true) }}

Paramètres​

ParamètreTypeDescription
routeNamestringRequis Nom de la route telle que définie dans votre configuration de routage
parametersarrayOptionnel Tableau associatif des paramètres de la route. Par défaut : []
referenceTypeboolOptionnel Si true, génère une URL absolue. Si false (défaut), génère un chemin relatif.

Définition des routes​

Les routes sont généralement définies dans vos contrôleurs à l'aide d'attributs :

class ArticleController
{
    #[Route('/article/{slug}', name: 'article_show')]
    public function show(string $slug)
    {
        // ...
    }
}

Bonne pratique​

Utilisez toujours les noms de route plutôt que des URLs en dur tant que possible.

Remarque​

Cette fonction est particulièrement utile pour créer des liens dynamiques qui s'adapteront automatiquement aux changements de structure d'URL dans votre application.