Développer une application, c'est bien. La distribuer où l'utiliser, c'est mieux. Cependant, tout le monde ne parle pas votre langue, d'où l'intérêt de l'internationaliser (et paf, une introduction toute pourrie \o/). Dans ce billet, je vous présenterai donc comment j'utilise gettext dans CodingTeam, afin de traduire l'application.

Traduire une application se fait généralement à l'aide d'outils dédiés comme gettext. Vous écrivez votre code en mettant tous vos textes traduisibles d'une certaine manière et il va aller les chercher pour en faire un fichier modèle (pot), qui servira ensuite à générer des fichiers de langue (po).
En PHP et comme dans beaucoup d'autres langages, il y a déjà quelque chose de tout préparé, ce qui permet de l'utiliser directement, sans rien installer d'autre.

Ma façon d'utiliser gettext est inspirée de la lecture de bon nombre d'articles sur le net. En gros, j'utilise ce code pour charger gettext :
setlocale(LC_ALL, $lang.'.UTF-8');

bindtextdomain('nomdedomaine', 'i18n');
textdomain('nomdedomaine');
bind_textdomain_codeset('nomdedomaine', 'UTF-8');
Dans cet exemple, $lang doit valoir quelque chose comme en_GB ou fr_FR et nomdedomaine devrait être le nom de votre application.
Dans le répertoire i18n, il devrait se trouver un dossier fr_FR contenant un autre dossier LC_MESSAGES qui accueillera le binaire produit par gettext (mo).

De même, on peut faire en sorte que la langue soit enregistrée par l'utilisateur, donnée dans l'URL, lue depuis l'en-tête adéquate... Voilà une manière assez rapide^Wmoche et ne respectant pas les spécifications, de se baser sur la langue du navigateur :
$langlist = array('fr' => 'fr_FR', 'en' => 'en_GB');
$accept_language = explode(',', $_SERVER['HTTP_ACCEPT_LANGUAGE']);

foreach ($accept_language as $value)
{
    $choice = mb_substr($value, 0, 2);

    if (array_key_exists($choice, $langlist))
    {
           $lang = $langlist[$choice];
            break;
    }

}

if (empty($lang))
    $lang = 'en_GB';
À noter qu'il n'y a pas besoin de générer de .po/.mo pour la langue dans laquelle vous écrivez vos textes au sein de votre application vu qu'ils sont chargés par défaut si gettext n'arrive pas à trouver les traductions qui vont bien.

Pour créer le modèle, j'utilise ce script, qui est bien sûr adaptable. Dès que j'ai créé le .pot, je peux lancer cet autre script qui va me créer le fichier de traduction pour la langue que je désire. Une fois que j'ai traduit toutes les chaines, il me reste à lancer ce dernier script pour générer le binaire !

C'est là qu'on arrive au point relativement intéressant de ce billet (l'avant-ici a des airs de déjà-vu). J'ai toujours utilisé la fonction _() ou gettext() couplée à sprintf() afin de remplacer des éléments par d'autres. Exemple, si je veux traduire « Toto a mangé 4 bananes », j'écris : sprintf(_('Toto a mangé %d bananes'), 4); jusqu'au jour où je me suis rendu compte que si je voulais insérer plusieurs éléments dans la chaine tout en les nommant (afin de pouvoir changer leur ordre), j'allais au devant d'une syntaxe affreuse, repoussante, typiquement-php, à jeter par la fenêtre : sprintf(_('Le %2$s achète %1$d bananes.'), 42, 'monsieur'); !
%2$s, %1$s ! Mais qui est allé pondre cette horreur ?

Nostalgique de la façon bien plus propre de remplacer des occurrences dans des chaines en Python, j'ai donc écrit cette fonction, que je vous partage. Et j'espère qu'elle vous sera utile. En tout cas, c'est bien plus facile de ne pas se tromper, le traducteur a en face de lui quelque chose qui a une signification et ça ne fait pas tâche.

/**
 * Translate a string and add arguments
 *
 * Gets the translated string from gettext and add arguments in it with
 * the Python way instead of the *ugly* PHP way (sprintf).
 *
 * @param $str
 *   The string to be translated.
 * @param $args
 *   All arguments to be added.
 * @return
 *   The translated and formatted string.
 */
function i18n($str, $args=array())
{
    // Get the translated string
    $str = gettext($str);

    // Add arguments to the string if exist
    if (count($args) > 0)
        // Fetching all arguments
        foreach ($args as $key => $value)
        {
            // Decimal value
            if (is_numeric($value))
                $type = 'd';
            // String value
            elseif (is_string($value))
                $type = 's';

            // Replace
            $str = str_replace('%('.$key.')'.$type, $value, $str);
        }

    // Return the translated string with arguments
    return $str;
}