internationalisation-zend

Dans cet épisode, nous allons mettre en place l’internationalisation sur notre application Zend Framework. De cette façon, notre site pourra accueillir les visiteurs du monde entier ! Dans notre cas, nous allons prendre en compte la langue française ainsi que l’anglais.

Plan de l’épisode #06

La culture de l’utilisateur

Chaque utilisateur possède une culture spéciale en arrivant sur un site internet. Par exemple, nous pouvons avoir des visiteurs français (fr_FR) mais aussi des français belges (fr_BE). Avec le Zend Framework, on peut récupérer la culture de l’utilisateur par rapport à son navigateur grâce à au code :

$locale = new Zend_Locale(Zend_Locale::BROWSER);

Mais dans notre cas nous avons besoin uniquement de deux langues, le français et l’anglais, avec comme langue par défaut le français.

Mise en place de la traduction dans le bootstrap

Dans le fichier application/Bootstrap.php nous allons créer une nouvelle méthode nommée _initTranslate et configurer le module de traduction.

protected function _initTranslate()
	{
		// On récupère la session du site.
		$session = Zend_Registry::get('session');
		// On définit la langue par défaut sur le site.

		$locale = new Zend_Locale('fr');
		// On enregistre cette langue dans notre registre.
		Zend_Registry::set('Zend_Locale', $locale);
		// Si la langue existe en session, on récupère la session, sinon on prend la valeur par défaut.
		$langLocale = isset($session->lang) ? $session->lang : $locale;
		// On lance l'objet de traduction en lui passant les fichiers de langues
		$translate = new Zend_Translate('array',APPLICATION_PATH.'/languages/fr_FR.php','fr');
		$translate->addTranslation(APPLICATION_PATH.'/languages/en_US.php','en');
		// On lui passe la langue courante du site
		$translate->setLocale($langLocale);
		// Important pour utiliser le helper.
		Zend_Registry::set('Zend_Translate', $translate);

	}

Grâce à ce code, notre langue par défaut est définit et si la langue est en session, il va prendre cette langue.

De plus, il faut charger la session dans le registre, pour effectuer cela, rendez-vous dans la méthode _initSession de votre Bootstrap.php et modifier comme cela :

protected function _initSession()
	{
		// On initialise la session
		$session = new Zend_Session_Namespace('watchmydesk', true);
		Zend_Registry::set('session', $session);
		return $session;
	}

Ensuite nous charger les fichiers de traductions en fonction de la langue utilisée.

Pour créer les fichiers de langues, nous allons aller application/languages/ et créer deux fichiers, fr_FR.php et en_US.php .

Fichier fr_FR.php

< ?php
return array(
'hello' => 'Bonjour et bienvenue sur notre site',
'english' => 'Anglais',
'french' => 'Français'
);

Fichier en_US.php

< ?php
return array(
'hello' => 'Hello and welcome on the website',
'english' => 'English',
'french' => 'French'
);

Dans cet exemple, j’ai choisis le type array pour mes fichiers de traduction, mais il existe beaucoup de solution comme Array, CSV, Gettext, Ini … vous pouvez vous renseigner sur les types sur cette page..

Le changement de la langue

Notre application multi-langue est prête, mais il faut maintenant pouvoir changer la langue du site avec un lien par exemple.
Nous allons donc ouvrir le fichier application/modules/frontend/controllers/IndexController.php et ajouter cette méthode: 

public function languageAction(){
		$params = $this->getRequest()->getParams();
		if(isset($params['lang']) && in_array($params['lang'], array('en','fr'))){
			Zend_Registry::get('session')->lang = $params['lang'];
		}
		$this->_redirect('/');
	}

Cette fonction permet de changer la langue qui est en session, tout en utilisant uniquement deux langues.

Ensuite nous allons éditer quelques lignes de code dans notre fichier application/layouts/layout.phtml :

<div id="menu">
      <ul>
        <li><a href="<?= $this->link('index', 'language', null, array('lang' => 'en'))?>">Anglais</a></li>
        <li><a href="<?= $this->link('index', 'language', null, array('lang' => 'fr'))?>">Français</a></li>
      </ul>
    </div>
<?php echo $this->layout()->content ?>

Le helper utilisé ici n’existe pas dans le Zend Framework, je vous donne donc la source ici. Il faudra créer un fichier dans application/views/helpers/ , le nommer Link.php et le remplir avec le code source que je vous donne.

Le helper

Maintenant que la traduction est opérationnelle, il nous faut utiliser le helper de traduction du Zend Framework : 

$this->translate("lenomatraduire");

Nous allons donc éditer deux fichiers, layout.phtml et et /application/frontend/views/index/index.phtml.

Layout.phtml

        <li><a href="<?= $this->link('index', 'language', null, array('lang' => 'en'))?>"><?=this->translate("english"); ?></a></li>
        <li><a href="<?= $this->link('index', 'language', null, array('lang' => 'fr'))?>"><?=this->translate("french"); ?></a></li>

et index.phtml

< ?= $this->translate("hello")?>

Conclusion

Dans cet épisode, nous avons vu comment utiliser les composant Zend_Locale et Zend_Translate du Zend Framework dans le but de mettre en place l’internationalisation (i18n) de notre application. Vous trouverez la version pour Symfony sur le blog de la fermeduweb