i18n.php 5.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163
  1. <?php
  2. /*
  3. @nom: i18n
  4. @auteur: Idleman (http://blog.idleman.fr)
  5. @description: Fonctions de gestion de la traduction
  6. */
  7. class Translation {
  8. // Répertoire contenant les traductions
  9. const LOCALE_DIR = 'locale';
  10. /* Langue utilisée si aucune langue n'est demandée ou si les langues
  11. * demandées ne sont pas disponibles. Idem pour les traductions.*/
  12. const DEFAULT_LANGUAGE = 'fr';
  13. // tableau associatif des traductions
  14. var $trans = array();
  15. var $language = ''; // langue courante
  16. var $translatedLanguages = array(); // langues traduites
  17. /** @param location L'endroit où se trouve le dossier 'locale'
  18. * @param languages Les langues demandées */
  19. function __construct($location, $languages=array()) {
  20. $this->location = $location;
  21. if (!is_array($languages)) $languages = array($languages);
  22. $this->translatedLanguages = $this->listLanguages();
  23. $languages[]=self::DEFAULT_LANGUAGE;
  24. $this->languages = $languages;
  25. foreach ($languages as $language) {
  26. if (empty($language)) continue;
  27. if ($this->load($language)) {
  28. $this->language = $language;
  29. break;
  30. }
  31. }
  32. }
  33. /* @return la liste des langues avec une traduction */
  34. protected function listLanguages() {
  35. $translatedLanguages = array();
  36. $files = glob($this->location.'/'.self::LOCALE_DIR.'/*.json');
  37. if (is_array($files)) {
  38. foreach($files as $file){
  39. preg_match('/([a-z]{2})\.json$/', $file, $matches);
  40. assert('!empty($matches)');
  41. $translatedLanguages [] = $matches[1];
  42. }
  43. }
  44. return $translatedLanguages;
  45. }
  46. /* Charge la traduction
  47. * @param language la langue sélectionnée
  48. * @return TRUE si le chargement s'est bien fait, FALSE sinon */
  49. protected function load($language) {
  50. if (!preg_match('/^[a-z]{2}$/', $language)) {
  51. error_log("Invalid language: '$language'");
  52. return false;
  53. }
  54. $trans = $this->loadFile($language);
  55. if (empty($trans)) return false;
  56. assert('in_array($language, $this->translatedLanguages)');
  57. if ($language!=self::DEFAULT_LANGUAGE) {
  58. $defaultTrans = $this->loadFile(self::DEFAULT_LANGUAGE);
  59. assert('!empty($defaultTrans)');
  60. $trans = array_merge($defaultTrans, $trans);
  61. }
  62. $this->trans = $trans;
  63. return true;
  64. }
  65. /* Charge un fichier
  66. * @param $language Le fichier de langue concerné
  67. * @return Tableau associatif contenant les traductions */
  68. protected function loadFile($language) {
  69. $fileName = $this->location.'/'.self::LOCALE_DIR.'/'.$language.'.json';
  70. $content = @file_get_contents($fileName);
  71. if (empty($content)) {
  72. $translations = array();
  73. } else {
  74. $translations = json_decode($content, true);
  75. foreach ($translations as $id => $translation) {
  76. if (empty($translation)) {
  77. # Retire les traductions vides afin qu'elles soient
  78. # traduites dans une autre langue si possible.
  79. unset($translations[$id]);
  80. }
  81. }
  82. if (!empty($content) && empty($translations))
  83. error_log("Error while loading '$fileName'");
  84. }
  85. return $translations;
  86. }
  87. /* Retourne la traduction et substitue les variables.
  88. * get('TEST_TRANS', array('4'))
  89. * Retournera 'Nombre : 4' si TEST_TRANS == 'Nombre : $1' */
  90. function get($key, $args=array()) {
  91. if (isset($this->trans[$key])&&!empty($this->trans[$key])) {
  92. $value = $this->trans[$key];
  93. for($i=0;$i<count($args);$i++){
  94. $value = str_replace('$'.($i+1), $args[$i], $value);
  95. }
  96. } else {
  97. $value = $key;
  98. }
  99. return $value;
  100. }
  101. /* Ajoute une traduction à la suite de celle-ci.
  102. * Note : il faudra appeler getJson() si nécessaire */
  103. function append(Translation $other) {
  104. $this->trans = array_merge($this->trans, $other->trans);
  105. }
  106. /* @return la version Json des traductions */
  107. function getJson() {
  108. return json_encode($this->trans);
  109. }
  110. /* @return un tableau des langues préférées */
  111. static function getHttpAcceptLanguages($httpAcceptLanguage=Null) {
  112. /** Exemple de directive :
  113. * eo,fr;q=0.8,fr-FR;q=0.6,en-US;q=0.4,en;q=0.2
  114. * Les langues sont séparées entre elles par des virgules.
  115. * Chaque langue est séparée du coefficient, si présent, par un point-virgule.
  116. */
  117. // Suppose que les langues préférées sont en premier.
  118. if (is_null($httpAcceptLanguage)) $httpAcceptLanguage = @$_SERVER['HTTP_ACCEPT_LANGUAGE'];
  119. $languageList = array();
  120. foreach (explode(',', $httpAcceptLanguage) as $language) {
  121. $languageList[] = substr($language, 0, 2); // fr-FR;q=0.6 --> fr
  122. }
  123. return array_unique($languageList); // en-US,en-UK --> en, en --> en
  124. }
  125. }
  126. // Initialise le singleton, avec les langues possibles
  127. function i18n_init($languages, $location){
  128. global $i18n,$i18n_js;
  129. if (!isset($i18n)) {
  130. // Charge d'abord les traductions de base
  131. $i18n = new Translation(dirname(__FILE__), $languages);
  132. // Charge ensuite la traduction demandée (celle du thème courant)
  133. $i18n->append(new Translation($location, $languages));
  134. $i18n_js = $i18n->getJson();
  135. }
  136. return $i18n->language;
  137. }
  138. // Appel rapide de la traduction
  139. function _t($key,$args=array(),$debug=false){
  140. global $i18n;
  141. return $i18n->get($key, $args);
  142. }
  143. ?>