Un site multilingue avec CakePHP

Bonjour Pierre-Emmanuel,

Excellent article comme d’habitude. Je consulte ton blog avec beaucoup d’intérêt depuis des mois. Il a le mérite compiler brillamment sous forme de cas clairs, les centaines de lectures que j’ingurgite sur cakePhp au fil du net.

Ma contribution. A moins que quelque chose m’ait échappé, je pense qu’il n’est pas utile de recopier le contenu de la méthode ‘link’ dans ton helper I18n.
Le helper peut se résumer à mon sens à ceci :

class I18nHelper extends AppHelper {
   	var $helpers = array('Html');
 
	function url($url = null, $full = false) {
		return '/' .
			   Configure::read('Config.langCode') .
			   parent::url($url, $full);
	}
 
	function link($title, $url = null, $htmlAttributes = array(), $confirmMessage = false, $escapeTitle = true) {
		 $url = $this->url($url);
		 return $this->Html->link($title, $url, $htmlAttributes, $confirmMessage, $escapeTitle);
	}
}

Qu’en penses-tu ?

Aussi, pour éviter d’utiliser un nouvel helper i18n->link qui obligerait à rééditer un site déjà construit avec le helper d’origine $html->link, on peut éditer ‘app_helper.php’ à la racine et y ajouter :

class AppHelper extends Helper {
	function url($url = null, $full = false) {
		return '/' .
		   Configure::read('Config.langCode') .
		   parent::url($url, $full);
	}
}

Aussi, et c’est peut être de ça dont tu parles dans ta note à propos du bug, la fonction __() n’était pas reconnue dans les $validate lors de mes derniers essais (avec beta antérieure à la récente RC1).

'message' => __("Donnez un titre à l'article.", true)

Je n’ai pas essayé depuis et j’espère que c’est corrigé car très ennuyeux pour un site multilangue… Je suis inquiet.

Content d’avoir participé
Encore mieux le ‘return parent::link(…’ !

J’ai lu que le non fonctionnement du __() dans $validate est un sujet qui leur a été reporté, ils l’ont changé dans une précédente revision et sont revenus en arrière un dans la revision d’après.
Je suppose qu’ils partent du principe que c’est pas très MVC de donner accès à cette fonction dans le Modèle… Dans ce cas pourquoi donner la possibilité de définir un message d’erreur dans celui-ci ?

La team cakePhp a la réputation d’être bornée et parfois déconcertante.

1. C’est une question de principe et un peu de sécurité, par commodité d’usage il est tentant de modifier $_GET et $_POST, mais par nature, elles représentent des données transmises par le client et ne devraient pas être reconstruites/modifiées/complétées, même si rien ne l’interdit ! C’est un risque d’erreur (si on utilise à nouveau $_GET ou $_POST plus loin dans le code).

2. Je ne parle pas d’éditer les “.mo”, Poedit le fait tout seul à partir du “.pot” ou du “.po”. Tu m’as donné un argument : en utilisant directement un “.mo” on ne demande plus à Cake de compiler ! On gagne donc en performance. Il y avait aussi un argument stabilité je crois, lu à travers le GoogleGroups ou sur un blog d’un Master of Cake…

3. OK, désolé, nous aprendrons donc ensemble !

4. Ben non, cette opération peut-être exécutée plusieurs fois par projet, dès lors que l’on utilise les Nightly Builds ou que l’on souhaite utiliser un nouveau Component/Behavior/Helper du coeur…

Bonjour, et merci pour ce tuto.

Cependant j’avoue être très étonné par la “compléxité” de mise en oeuvre.

Il est assez étrange que CakePhp ne gère pas cela d’origine…

Devoir créer un helper pour gérer l’identifiant de langue dans l’URL, je trouve ça anormal pour un framework de cette envergure.

Idem pour toute la partie “Analyse de l’URL”, comment ont-ils pu laisser passer quelque chose comme ça ?

J’utilise actuellement un framework que je me suis développé tout seul, et bien que n’était pas un super expert de Php, il gère sans problème le code de langue dans l’URL, c’est la moindre des choses quand on prévoie un framework capable de gérer l’i18n.

En tout cas, encore merci pour le tuto, mais du coup je suis pas sûr de me séparer de mon framework perso.

Bonne continuation

@pizaninja
Tu peux creer autant de po que tu veux. Pour afficher il suffit de remplacer __(), par __d(’filename’, ‘msgid’).
Supposons un fichier error.po, tu peux ainsi faire __d(’error’, ‘msgerrorid’).

Salut,

Très bon article globalement. J’ai découvert poedit, qui va m’être extrêmement utile.

Une petite remarque néanmoins concernant le gros bloc de code de boostrap utilisé pour le routing quand on a le paramètre de langue : il existe une façon plus propre de le gérer, en utilisant la récupération de paramètres du Router.

Dans routes.php, on peut créer la route suivante :
Router::connect(’/:langue/:controller/:action/*’, array(), array(’langue’=>’fr|en’));

En indiquant ceci au Router, dans le cas ou le premier paramètre est “fr” ou “en”, il l’extraiera de l’url et le transmettra à l’application via params.

Il ne reste plus qu’à initialiser la langue courante depuis le app_controller, en checkant $this->params['langue'] .

Concernant le transport du paramètre de langue, on peut le gérer uniquement en surclassant la fonction url() dans app_helper. La méthode que j’utilise actuellement n’est pas suffisament propre (pour être présentée ici), mais à priori on doit pouvoir le gérer en rajoutant uniquement le paramètre “langue” tel qu’on l’a défini dans les routes, à l’url passée ($url['langue'] = Configure::read(’langue’)). Grace au reverse routing, cake se débrouille pour le placer là ou il faut dans l’url.

Bon multilingue à tous !
Sébastien

Optimisation de la méthode pour faire du multilangue:
grâce au commentaire de Sébastien Charrier, j’ai pu simplifier le code (surtout le bootstrap).

// vider bootstrap.php et ajouter :
Configure::write('Config.languages', array(
  'fr' => 'fre',
  'en' => 'eng',
);
 
// ajouter dans router.php :
Router::connect('/:lang/:controller/:action/*', // format de l'url
  array('lang' => 'fr'), // langue par défaut
  array('lang' => 'fr|en')); // langues gérées
 
// créer app_helper.php et y saisir :
class AppHelper extends Helper {
  // surcharger la fonction appelée par $html->link()
  function url($url = null, $full = false) {
    // si l'url est sous form de array et que le paramètre lang n'y est pas déjà déclaré
    if (is_array($url) && array_key_exists('lang', $url)) {
      $url['lang'] = Configure::read('Config.language');
    }
    return parent::url($url, $full);
  }
}
 
// app_controller.php, ajouter dans beforeFilter :
// récupérer la langue détectée par le Router
$lang = $this->params['lang'];
// I18n ne récupère plus la langue du 'Config.language' (bizarre, je vais contacter les core dev pour leur demander si c'est normal), donc on lui force la langue :
App::import('Core', 'i18n');
$I18n =& I18n::getInstance();
$I18n->l10n->get($lang);
 
// Configure inutile car I18n le fait déjà
//Configure::write('Config.language',  $lang);

Et avec ces modifs:
- les urls /fr/articles et /en/articles sont gérées
- les liens contiennent le code de langue, sans changer de helper
- on se repose plus sur l’automatisme de Cake

Quelques commentaires et questions à propos de la dernière solution proposée par Djiize.

Tout d’abord deux détails :
- il manque une parenthèse fermante pour le bout de code à ajouter dans le bootstrap.
- et si je ne me trompe pas dans l’helper, il faudrait plutôt écrire !array_key_exists(’lang’, $url).

Pour les questions :
- Ne faudrait-t-il pas vérifier dans le app_controller que $this->params['lang'] existe bien ? Que se passe-t-il si tu appelles la route / par exemple ?
- Et que deviennent les liens du tutoriel pour changer de langue ?

@Djiize : merci pour les réponses.

A propos du array_key_exists(), je ne suis pas sur de bien comprendre ce que tu veux dire par “le array_key_exists() est plus approprié comme test”. Simplement je voulais souligner le fait que ton commentaire dans le code et le code ne semblent pas se correspondre. Il manque le point d’exclamation devant array_key_exists pour que le test fonctionne. Si j’ai bien compris, cela nous permet d’ajouter le paramètre ‘lang’ dans l’URL quand il n’y est pas.

D’autre part, j’ai rajouté comme tu le disais dans ton commentaire le paramètre ‘lang’ sur la route ‘/’ parce que sinon on se retrouve avec une erreur de ce type “Undefined index: lang [APP/app_controller.php, line 20]“.

un truc sur lequel je viens de tomber, le coeur de cake n’utilise pas encore les fonctions mb_* en interne, il faut pour le moment utiliser la classe Multibyte qui récupère le App.encoding et simplifie l’utilisation des fonctions mb_*. Par contre je sais qu’il y a des problèmes sur les validations notamment sur la longueur des chaînes de caractères.

// inclure Multibyte
dans bootstrap.php :
App::import('Core', 'Multibyte');
 
// utiliser à la place des fonctions mb_*
Multibyte::strtolower('ÀÉÔÏ');
au lieu de
mb_strtolower('ÀÉÔÏ', 'UTF-8');
 
remplacer ucfirst :
$string = Multibyte::strtolower($string);
$string = sprintf(
    '%s%s',
    Multibyte::strtoupper(Multibyte::substr($string,0,1)),
    Multibyte::substr($string,1));

à mettre dans une class custom type MyMultibyte::ucfirst() peut-être.. si quelqu’un a plus propre je suis preneur !

// utiliser dans la validation
dans app_model.php
function between($check, $min, $max) { 
    $length = Multibyte::strlen($check); 
    if ($length >= $min && $length <= $max) { 
        return true; 
    } else { 
        return false; 
    } 
}

Salut !

Heureux de voir que ma contribution a pu faire avancer le shmilblick.

Je suis confronté actuellement à une partie dont on ne parle pas dans cet article, mais qui est bel et bien liée à l’internationalisation d’un site : la gestion des champs spéciaux de type date ou monnaie.

En effet, peu importe la langue dans laquelle est configurée le site, quand on affiche un input de type datetime ou date ($form->input(’name’,array(’type’=>’datetime’)), les inputs affichés sont au format anglais.

J’ai vu que l’on pouvait gérer le format via les paramètres dateformat/timeformat, mais rien d’automatique …

Nos formateurs préférés auraient ils une esquisse de solution ? (je n’ai rien trouvé de probant sur le net jusqu’à présent :s)

Hello. D’abord merci pour cet excellent article qui tombe à pic.

J’ai mis en place mon application multilingue en suivant la procédure proposée par Pierre-Emmanuel Fringant puis l’ai modifiée selon la proposition de Djiize. Globalement, ça marche bien sous CakePHP 1.2.0.7296 RC2.

Toutefois, je rencontre le problème suivant: lors de la création/modification d’un enregistrement dans la base de données, le champ field n’est pas renseigné. Aussi, un champ non traduit (user_created) n’est pas non plus renseigné dans la table articles.

Je me casse la tête là-dessus depuis un moment sans trouver la solution. Quelqu’un a-t-il rencontré le même problème et trouvé la parade?

Mon code est repri

Bonjour,

Trois problèmes pour lesquels je n’ai pas trouvé de solution malgré mes recherches:

- lorsque je supprime un enregistrement, seul l’enregistrement de la table “principale” est supprimé. Les champs traduits dans la table i18n ne sont pas supprimés. A terme, ça risque de devenir gênant d’avoir une table i18n surchargée d’infos obsolètes.
Voici ma fonction de suppression:

function delete($id = null)
	{
    $this->Article->del($id);
 
		if(!$this->Article->exists())
		{
			$this->Session->setFlash(__('Enregistrement introuvable',true),'message_error');
		}
		else
		{
			$this->Article->del();
			$this->Session->setFlash(__('Données supprimées',true),'message_ok');
		}
		$this->redirect($this->referer());
	}

- En utilisant la méthode de Djiize, le routage admin standard de Cakephp ne fonctionne plus. Y-a-t-il un moyen de contourner ce problème? J’ai essayé plusieurs variantes de routes dans routes.php sans succès.
- Les messages d’erreur lors de la validation ne sont pas affichés dans la vue du formulaire.
Je traite l’enregistrement comme suit dans le contrôleur:

  function edit($id = null)
  	{
 
	// Save
	if(isset($this->data))
	{
if($this->Article->save($this->data)){
$this->redirect('gestion');
}
}
$this->data = $this->Article->read(null, $id);
	}

et dans la vue je place la fonction d’affichage de l’erreur:

[...]
echo $form->error('Article.titre.'.$locale);
[...]

Suite du message précédent :

Je viens de voir que Djiize propose une solution proche de la mienne dans ces mêmes commentaires.

J’attaque enfin ma première appli avec i18n complète, et ce tutorial est vraiment une très bonne base : BRAVO !

Un petit point qui me tracasse, au niveau de la vue d’édition : pourquoi manipuler les tableaux au sein de la vue en elle-même ? Ne serait-ce pas plutôt au controller de faire ça ?

En tout cas, voici un bout de code que j’ai écrit afin d’éviter d’avoir une variable par champ et de reformater tout d’un coup … si cela peut aider quelqu’un !

$dirtyContent = $this->Content->read(null, $id);
foreach($this->Content->actsAs['Translate'] as $realFieldName => $storedFieldName){
            $this->data['Content'][$realFieldName] = Set::combine($dirtyContent[$storedFieldName], '{n}.locale', '{n}.content');
}

Bonjour,
Concernant la redirection vers l’admin j’ai pour ma part rajouté une route avant la gestion des langues (en partant du principe que la zone d’admin n’est accessible qu’en fr).

Router::connect('/admin/:controller/:action/*', array('lang'=>'fr','admin'=>true));
Router::connect('/:lang/:controller/:action/*', // format de l'url
	array('lang' => 'fr', 'action'=>'index'), // langue par défaut
    array('lang' => 'fr|en|de', 'controller'=>'pages|candidatures|offres') // langues gérées
);

On devrait pouvoir l’adapter pour une administration multilingue.

Effectivement, si je pars d’une version vierge (ici cake_1.2.1.8004) avec juste les deux modèles que sont i18n et articles, et que j’applique ton tutoriel, l’ajout et l’édition fonctionnent très bien.
Il faut que je regarde ce qui peut bloquer sur mon appli.

Bonjour a tous,

Meci déja pour ce super tuto, mais au moment de créer la base de donner avec la console “cake i18n ->I”

il me dit

Error: schema.php could not be loaded

j’ai beau chercher sur le net mais je trouve pas la solution à se problème. Est ce que vous aurez une solution à se petit problème à fin que je puisse continuer se super tuto

Merci d’avance pour vos réponse

Rebonjour,

J’explique mon probleme sur les redirections sur le forum francophone de cakephp:

http://forum.cakephp-fr.org/viewtopic.php?id=265

J’ai toujours pas de solution donc si vous avez une idee, n’hesitez pas.

Merci.

Bonjour,

J’ai utilisé votre tutoriel pour un site anglais/français sur lequel je travaille présentement.

Seulement, j’ai un petit problème, je m’explique :

- Tous les textes provenant de la BD s’affichent correctement. Autant en français qu’en anglais. C’est merveilleux.

- Seulement, si j’utilise la fonction __() pour afficher une string provenant du fichier .po, les accents sont remplacés par des points d’interrogations. Exemple : “Notre ?quipe”

- Pire encore, si j’utilise la fonction $html->link comme suit :

echo $html->link(__('Notre équipe',true),'http://www.unsite.com')

Le lien ne s’affiche pas, comme si la fonction __() renvoyait une chaine vide.

J’ai pourtant vérifié, html->charset() retourne bien utf-8, mon App.enconding dans mon fichier core.php est bien utf-8. Bref, je suis dans le flou le plus total.

Merci d’avance.

En effet,

mon fichier default.ctp est encodé en Latin….

Ainsi, même si mes views étaient en utf-8, rien ne pouvait fonctionner.

Merci!

Bonjour François,
Si ta question n’est pas relative à l’article, tu devrais la poster sur le forum des utilisateurs de CakePHP : http://forum.cakephp-fr.org/
Fred

Bonjour, ma question concerne le point 4.3 Les actions de consultation.

Dans l’exemple présenté, on peut consulter les enregistrements dans une langue ou un autre selon l’URL. Cela me semble très bien pour le frontend d’une application.

Maintenant dans un backend, imaginons que nous traduisions en “fr” et “en”, il peut être intéressant pour la personne chargée de créer et traduire les enregistrements de voir les traductions “fr” et “en” du dit enregistrement sur la même page.

Comment récupérer donc la traduction pour mes deux langages et les afficher ainsi dans la même vue?

Merci

Bonjour,

Bien que ces lignes figures dans mon code, il ne me récupère que l’espagnol (je gère deux langues : anglais et espagnol, l’espagnol étant la langue par défaut).

De fait, si j’utilise l’index basic fourni dans l’article:

function index() {
  $this->set('data', $this->paginate());
}

$data est vide et je dois ajouter les deux lignes que tu m’as donné précédemment pour obtenir des résultats. Peut être ai-je raté quelquechose.