frankdejonge/symfony-i18n-routing

Internationalised routing for Symfony 4

Internationalized routing for Symfony 4

This bundle provides i18n routing for Symfony 4., _(*1)

, _(*2)

Purpose

This bundle provides a method of internationalization of route definitions. This means you can define a path per locale and still have them route to the same controller action., _(*3)

Installation

composer req frankdejonge/symfony-i18n-routing

Register the bundle in bundles.php, _(*4)

<?php

return [
    FrankDeJonge\SymfonyI18nRouting\I18nRoutingBundle::class => ['all' => true],
    // ...
];

Note that if you want to use the annotations you'll need to ensure this bundle is loaded BEFORE the FrameworkBundle., _(*5)

Configuration

frankdejonge_i18n_routing:
    default_locale: en
    use_annotations: false # set to true to enable annotation loading

Yaml usage

From your main config/routes.yml import your localized routes:, _(*6)

i18n_routes:
    resource: ./i18n_routes/routes.yml
    type: i18n_routes

Now you can define i18n routes in config/i18n_routes/routes.yml:, _(*7)

contact:
    controller: ContactController::formAction
    locales:
        en: /send-us-an-email
        nl: /stuur-ons-een-email

This is effectively the same as defining:, _(*8)

contact.en:
    controller: ContactController::formAction
    path: /send-us-an-email
    defaults:
        _locale: en

contact.nl:
    controller: ContactController::formAction
    path: /stuur-ons-een-email
    defaults:
        _locale: nl

As you can see this saves you a bit of typing and prevents you from having to keep 2 definitions in sync (less error prone)., _(*9)

Annotation usage

The annotation loader supports both normal route annotations and localized ones. The @I18nROute and @Route annotations can be be mixed at will., _(*10)

<?php

use FrankDeJonge\SymfonyI18nRouting\Routing\Annotation\I18nRoute;

class ContactController
{
    /**
     * @I18nRoute({"en": "/send-us-an-email", "nl": "/stuur-ons-een-email"}, name="contact") 
     */
    public function formAction()
    {

    }
}

/** 
 * @Route("/prefix") 
 */
class PrefixedContactController
{
    /**
     * @I18nRoute({"en": "/send-us-an-email", "nl": "/stuur-ons-een-email"}, name="prefix_contact") 
     */
    public function formAction()
    {

    }
}

Generating routes

Generating routes can be done using the specified route name., _(*11)

<?php
/** @var UrlGeneratorInterface $urlGenerator */
$urlWithCurrentLocale = $urlGenerator->generate('contact');
$urlWithSpecifiedLocale = $urlGenerator->generate('contact', ['_locale' => 'nl']);