libraries/select_lang.lib.php

   1 <?php
   2 /* vim: set expandtab sw=4 ts=4 sts=4: */
   3 /**
   4  * phpMyAdmin Language Loading File
   5  *
   6  * @package PhpMyAdmin
   7  */
   8 if (! defined('PHPMYADMIN')) {
   9     exit;
  10 }
  11
  12 /**
  13  * Returns language name
  14  *
  15  * @param string $tmplang
  16  *
  17  * @return string
  18  */
  19 function PMA_langName($tmplang)
  20 {
  21     $lang_name = ucfirst(substr(strrchr($tmplang[0], '|'), 1));
  22
  23     // Include native name if non empty
  24     if (!empty($tmplang[2])) {
  25         $lang_name = $tmplang[2] . ' - ' . $lang_name;
  26     }
  27
  28     return $lang_name;
  29 }
  30
  31 /**
  32  * Tries to find the language to use
  33  *
  34  * @return bool  success if valid lang is found, otherwise false
  35  */
  36 function PMA_langCheck()
  37 {
  38     // check forced language
  39     if (! empty($GLOBALS['cfg']['Lang'])) {
  40         if (PMA_langSet($GLOBALS['cfg']['Lang'])) {
  41             return true;
  42         } else {
  43             $GLOBALS['lang_failed_cfg'] = $GLOBALS['cfg']['Lang'];
  44         }
  45     }
  46
  47     // Don't use REQUEST in following code as it might be confused by cookies
  48     // with same name. Check user requested language (POST)
  49     if (! empty($_POST['lang'])) {
  50         if (PMA_langSet($_POST['lang'])) {
  51             return true;
  52         } elseif (!is_string($_POST['lang'])) {
  53             /* Faked request, don't care on localisation */
  54             $GLOBALS['lang_failed_request'] = 'Yes';
  55         } else {
  56             $GLOBALS['lang_failed_request'] = $_POST['lang'];
  57         }
  58     }
  59
  60     // check user requested language (GET)
  61     if (! empty($_GET['lang'])) {
  62         if (PMA_langSet($_GET['lang'])) {
  63             return true;
  64         } elseif (!is_string($_GET['lang'])) {
  65             /* Faked request, don't care on localisation */
  66             $GLOBALS['lang_failed_request'] = 'Yes';
  67         } else {
  68             $GLOBALS['lang_failed_request'] = $_GET['lang'];
  69         }
  70     }
  71
  72     // check previous set language
  73     if (! empty($_COOKIE['pma_lang'])) {
  74         if (PMA_langSet($_COOKIE['pma_lang'])) {
  75             return true;
  76         } elseif (!is_string($_COOKIE['pma_lang'])) {
  77             /* Faked request, don't care on localisation */
  78             $GLOBALS['lang_failed_cookie'] = 'Yes';
  79         } else {
  80             $GLOBALS['lang_failed_cookie'] = $_COOKIE['pma_lang'];
  81         }
  82     }
  83
  84     // try to find out user's language by checking its HTTP_ACCEPT_LANGUAGE variable;
  85     // prevent XSS
  86     $accepted_languages = PMA_getenv('HTTP_ACCEPT_LANGUAGE');
  87     if ($accepted_languages && false === strpos($accepted_languages, '<')) {
  88         foreach (explode(',', $accepted_languages) as $lang) {
  89             if (PMA_langDetect($lang, 1)) {
  90                 return true;
  91             }
  92         }
  93     }
  94     unset($accepted_languages);
  95
  96     // try to find out user's language by checking its HTTP_USER_AGENT variable
  97     if (PMA_langDetect(PMA_getenv('HTTP_USER_AGENT'), 2)) {
  98         return true;
  99     }
 100
 101     // Didn't catch any valid lang : we use the default settings
 102     if (PMA_langSet($GLOBALS['cfg']['DefaultLang'])) {
 103         return true;
 104     }
 105
 106     return false;
 107 }
 108
 109 /**
 110  * checks given lang and sets it if valid
 111  * returns true on success, otherwise false
 112  *
 113  * @param string &$lang language to set
 114  *
 115  * @return bool  success
 116  */
 117 function PMA_langSet(&$lang)
 118 {
 119     /* Partial backward compatibility with 3.3 and older branches */
 120     $lang = str_replace('-utf-8', '', $lang);
 121
 122     if (!is_string($lang) || empty($lang) || empty($GLOBALS['available_languages'][$lang])) {
 123         return false;
 124     }
 125     $GLOBALS['lang'] = $lang;
 126     return true;
 127 }
 128
 129 /**
 130  * Analyzes some PHP environment variables to find the most probable language
 131  * that should be used
 132  *
 133  * @param string  $str     string to analyze
 134  * @param integer $envType type of the PHP environment variable which value is $str
 135  *
 136  * @return bool    true on success, otherwise false
 137  *
 138  * @access  private
 139  */
 140 function PMA_langDetect($str, $envType)
 141 {
 142     if (empty($str)) {
 143         return false;
 144     }
 145     if (empty($GLOBALS['available_languages'])) {
 146         return false;
 147     }
 148
 149     foreach ($GLOBALS['available_languages'] as $lang => $value) {
 150         // $envType =  1 for the 'HTTP_ACCEPT_LANGUAGE' environment variable,
 151         //             2 for the 'HTTP_USER_AGENT' one
 152         $expr = $value[0];
 153         if (strpos($expr, '[-_]') === false) {
 154             $expr = str_replace('|', '([-_][[:alpha:]]{2,3})?|', $expr);
 155         }
 156         if (($envType == 1 && preg_match('/^(' . addcslashes($expr, '/') . ')(;q=[0-9]\\.[0-9])?$/i', $str))
 157             || ($envType == 2 && preg_match('/(\(|\[|;[[:space:]])(' . addcslashes($expr, '/') . ')(;|\]|\))/i', $str))
 158         ) {
 159             if (PMA_langSet($lang)) {
 160                 return true;
 161             }
 162         }
 163     }
 164
 165     return false;
 166 } // end of the 'PMA_langDetect()' function
 167
 168
 169 /**
 170  * All the supported languages have to be listed in the array below.
 171  * 1. The key must be the "official" ISO 639 language code and, if required,
 172  *    the dialect code. It can also contain some information about the
 173  *    charset (see the Russian case).
 174  * 2. The first of the values associated to the key is used in a regular
 175  *    expression to find some keywords corresponding to the language inside two
 176  *    environment variables.
 177  *    These values contain:
 178  *    - the "official" ISO language code and, if required, the dialect code
 179  *      too ('bu' for Bulgarian, 'fr([-_][[:alpha:]]{2})?' for all French
 180  *      dialects, 'zh[-_]tw' for Chinese traditional...), the dialect has to
 181  *      be specified first;
 182  *    - the '|' character (it means 'OR');
 183  *    - the full language name.
 184  * 3. The second value associated to the key is the language code as defined by
 185  *    the RFC1766.
 186  * 4. The third value is its native name in html entities or UTF-8.
 187  *
 188  * Beware that the sorting order (first values associated to keys by
 189  * alphabetical reverse order in the array) is important: 'zh-tw' (chinese
 190  * traditional) must be detected before 'zh' (chinese simplified) for
 191  * example.
 192  *
 193  * @param string $lang language
 194  *
 195  * @return array
 196  */
 197 function PMA_langDetails($lang)
 198 {
 199     switch ($lang) {
 200     case 'af':
 201         return array('af|afrikaans', 'af', '');
 202     case 'ar':
 203         return array('ar|arabic', 'ar', '&#1575;&#1604;&#1593;&#1585;&#1576;&#1610;&#1577;');
 204     case 'az':
 205         return array('az|azerbaijani', 'az', 'Az&#601;rbaycanca');
 206     case 'bn':
 207         return array('bn|bangla', 'bn', 'বাংলা');
 208     case 'be':
 209         return array('be|belarusian', 'be', '&#1041;&#1077;&#1083;&#1072;&#1088;&#1091;&#1089;&#1082;&#1072;&#1103;');
 210     case 'be@latin':
 211         return array('be[-_]lat|belarusian latin', 'be-lat', 'Bie&#0322;aruskaja');
 212     case 'bg':
 213         return array('bg|bulgarian', 'bg', '&#1041;&#1098;&#1083;&#1075;&#1072;&#1088;&#1089;&#1082;&#1080;');
 214     case 'bs':
 215         return array('bs|bosnian', 'bs', 'Bosanski');
 216     case 'br':
 217         return array('br|breton', 'br', 'Brezhoneg');
 218     case 'ca':
 219         return array('ca|catalan', 'ca', 'Catal&agrave;');
 220     case 'ckb':
 221         return array('ckb', 'ckb', 'سۆرانی');
 222     case 'cs':
 223         return array('cs|czech', 'cs', 'Čeština');
 224     case 'cy':
 225         return array('cy|welsh', 'cy', 'Cymraeg');
 226     case 'da':
 227         return array('da|danish', 'da', 'Dansk');
 228     case 'de':
 229         return array('de|german', 'de', 'Deutsch');
 230     case 'el':
 231         return array('el|greek', 'el', '&Epsilon;&lambda;&lambda;&eta;&nu;&iota;&kappa;&#940;');
 232     case 'en':
 233         return array('en|english', 'en', '');
 234     case 'en_GB':
 235         return array('en[_-]gb|english (United Kingdom)', 'en-gb', '');
 236     case 'es':
 237         return array('es|spanish', 'es', 'Espa&ntilde;ol');
 238     case 'et':
 239         return array('et|estonian', 'et', 'Eesti');
 240     case 'eu':
 241         return array('eu|basque', 'eu', 'Euskara');
 242     case 'fa':
 243         return array('fa|persian', 'fa', '&#1601;&#1575;&#1585;&#1587;&#1740;');
 244     case 'fi':
 245         return array('fi|finnish', 'fi', 'Suomi');
 246     case 'fr':
 247         return array('fr|french', 'fr', 'Fran&ccedil;ais');
 248     case 'gl':
 249         return array('gl|galician', 'gl', 'Galego');
 250     case 'he':
 251         return array('he|hebrew', 'he', '&#1506;&#1489;&#1512;&#1497;&#1514;');
 252     case 'hi':
 253         return array('hi|hindi', 'hi', '&#2361;&#2367;&#2344;&#2381;&#2342;&#2368;');
 254     case 'hr':
 255         return array('hr|croatian', 'hr', 'Hrvatski');
 256     case 'hu':
 257         return array('hu|hungarian', 'hu', 'Magyar');
 258     case 'hy':
 259         return array('hy|armenian', 'hy', 'Հայերէն');
 260     case 'id':
 261         return array('id|indonesian', 'id', 'Bahasa Indonesia');
 262     case 'it':
 263         return array('it|italian', 'it', 'Italiano');
 264     case 'ja':
 265         return array('ja|japanese', 'ja', '&#26085;&#26412;&#35486;');
 266     case 'ko':
 267         return array('ko|korean', 'ko', '&#54620;&#44397;&#50612;');
 268     case 'ka':
 269         return array('ka|georgian', 'ka', '&#4325;&#4304;&#4320;&#4311;&#4323;&#4314;&#4312;');
 270     case 'kk':
 271         return array('kk|kazakh', 'kk', 'Қазақ');
 272     case 'lt':
 273         return array('lt|lithuanian', 'lt', 'Lietuvi&#371;');
 274     case 'lv':
 275         return array('lv|latvian', 'lv', 'Latvie&scaron;u');
 276     case 'mk':
 277         return array('mk|macedonian', 'mk', 'Macedonian');
 278     case 'ml':
 279         return array('ml|malayalam', 'ml', 'Malayalam');
 280     case 'mn':
 281         return array('mn|mongolian', 'mn', '&#1052;&#1086;&#1085;&#1075;&#1086;&#1083;');
 282     case 'ms':
 283         return array('ms|malay', 'ms', 'Bahasa Melayu');
 284     case 'nl':
 285         return array('nl|dutch', 'nl', 'Nederlands');
 286     case 'nb':
 287         return array('nb|norwegian', 'nb', 'Norsk');
 288     case 'pa':
 289         return array('pa|punjabi', 'pa', 'ਪੰਜਾਬੀ');
 290     case 'pl':
 291         return array('pl|polish', 'pl', 'Polski');
 292     case 'pt_BR':
 293         return array('pt[-_]br|brazilian portuguese', 'pt-BR', 'Portugu&ecirc;s');
 294     case 'pt':
 295         return array('pt|portuguese', 'pt', 'Portugu&ecirc;s');
 296     case 'ro':
 297         return array('ro|romanian', 'ro', 'Rom&acirc;n&#259;');
 298     case 'ru':
 299         return array('ru|russian', 'ru', '&#1056;&#1091;&#1089;&#1089;&#1082;&#1080;&#1081;');
 300     case 'si':
 301         return array('si|sinhala', 'si', '&#3523;&#3538;&#3458;&#3524;&#3517;');
 302     case 'sk':
 303         return array('sk|slovak', 'sk', 'Sloven&#269;ina');
 304     case 'sl':
 305         return array('sl|slovenian', 'sl', 'Sloven&scaron;&#269;ina');
 306     case 'sq':
 307         return array('sq|albanian', 'sq', 'Shqip');
 308     case 'sr@latin':
 309         return array('sr[-_]lat|serbian latin', 'sr-lat', 'Srpski');
 310     case 'sr':
 311         return array('sr|serbian', 'sr', '&#1057;&#1088;&#1087;&#1089;&#1082;&#1080;');
 312     case 'sv':
 313         return array('sv|swedish', 'sv', 'Svenska');
 314     case 'ta':
 315         return array('ta|tamil', 'ta', 'தமிழ்');
 316     case 'te':
 317         return array('te|telugu', 'te', 'తెలుగు');
 318     case 'th':
 319         return array('th|thai', 'th', '&#3616;&#3634;&#3625;&#3634;&#3652;&#3607;&#3618;');
 320     case 'tk':
 321         return array('tk|turkmen', 'tk', 'türkmençe');
 322     case 'tr':
 323         return array('tr|turkish', 'tr', 'T&uuml;rk&ccedil;e');
 324     case 'tt':
 325         return array('tt|tatarish', 'tt', 'Tatar&ccedil;a');
 326     case 'ug':
 327         return array('ug|uyghur', 'ug', 'ئۇيغۇرچە');
 328     case 'uk':
 329         return array('uk|ukrainian', 'uk', '&#1059;&#1082;&#1088;&#1072;&#1111;&#1085;&#1089;&#1100;&#1082;&#1072;');
 330     case 'ur':
 331         return array('ur|urdu', 'ur', 'اُردوُ');
 332     case 'uz@latin':
 333         return array('uz[-_]lat|uzbek-latin', 'uz-lat', 'O&lsquo;zbekcha');
 334     case 'uz':
 335         return array('uz[-_]cyr|uzbek-cyrillic', 'uz-cyr', '&#1038;&#1079;&#1073;&#1077;&#1082;&#1095;&#1072;');
 336     case 'zh_TW':
 337         return array('zh[-_](tw|hk)|chinese traditional', 'zh-TW', '&#20013;&#25991;');
 338     case 'zh_CN':
 339         // only TW and HK use traditional Chinese while others (CN, SG, MY)
 340         // use simplified Chinese
 341         return array(
 342             'zh(?![-_](tw|hk))([-_][[:alpha:]]{2,3})?|chinese simplified',
 343             'zh',
 344             '&#20013;&#25991;'
 345         );
 346     }
 347     return array("$lang|$lang", $lang, $lang);
 348 }
 349
 350 /**
 351  * Returns list of languages supported by phpMyAdmin
 352  *
 353  * @return array
 354  */
 355 function PMA_langList()
 356 {
 357     /* We can always speak English */
 358     $result = array('en' => PMA_langDetails('en'));
 359
 360     /* Check for existing directory */
 361     if (!is_dir($GLOBALS['lang_path'])) {
 362         return $result;
 363     }
 364
 365     /* Open the directory */
 366     $handle = @opendir($GLOBALS['lang_path']);
 367     /* This can happen if the kit is English-only */
 368     if ($handle === false) {
 369         return $result;
 370     }
 371
 372     /* Process all files */
 373     while (false !== ($file = readdir($handle))) {
 374         if ($file != "."
 375             && $file != ".."
 376             && file_exists($GLOBALS['lang_path'] . '/' . $file . '/LC_MESSAGES/phpmyadmin.mo')
 377         ) {
 378             $result[$file] = PMA_langDetails($file);
 379         }
 380     }
 381     /* Close the handle */
 382     closedir($handle);
 383
 384     return $result;
 385 }
 386
 387 /**
 388  * @global string  path to the translations directory; may be absent if the kit is English-only
 389  */
 390 $GLOBALS['lang_path'] = './locale/';
 391
 392 /**
 393  * Load gettext functions.
 394  */
 395 require_once GETTEXT_INC;
 396
 397 /**
 398  * @global string  interface language
 399  */
 400 $GLOBALS['lang'] = 'en';
 401 /**
 402  * @global boolean whether loading lang from cfg failed
 403  */
 404 $GLOBALS['lang_failed_cfg'] = false;
 405 /**
 406  * @global boolean whether loading lang from cookie failed
 407  */
 408 $GLOBALS['lang_failed_cookie'] = false;
 409 /**
 410  * @global boolean whether loading lang from user request failed
 411  */
 412 $GLOBALS['lang_failed_request'] = false;
 413 /**
 414  * @global string text direction ltr or rtl
 415  */
 416 $GLOBALS['text_dir'] = 'ltr';
 417
 418 /**
 419  * @global array supported languages
 420  */
 421 $GLOBALS['available_languages'] = PMA_langList();
 422
 423 // Language filtering support
 424 if (! empty($GLOBALS['cfg']['FilterLanguages'])) {
 425     $new_lang = array();
 426     foreach ($GLOBALS['available_languages'] as $key => $val) {
 427         if (preg_match('@' . $GLOBALS['cfg']['FilterLanguages'] . '@', $key)) {
 428             $new_lang[$key] = $val;
 429         }
 430     }
 431     if (count($new_lang) > 0) {
 432         $GLOBALS['available_languages'] = $new_lang;
 433     }
 434     unset($key, $val, $new_lang);
 435 }
 436
 437 /**
 438  * @global array MySQL charsets map
 439  */
 440 $GLOBALS['mysql_charset_map'] = array(
 441     'big5'         => 'big5',
 442     'cp-866'       => 'cp866',
 443     'euc-jp'       => 'ujis',
 444     'euc-kr'       => 'euckr',
 445     'gb2312'       => 'gb2312',
 446     'gbk'          => 'gbk',
 447     'iso-8859-1'   => 'latin1',
 448     'iso-8859-2'   => 'latin2',
 449     'iso-8859-7'   => 'greek',
 450     'iso-8859-8'   => 'hebrew',
 451     'iso-8859-8-i' => 'hebrew',
 452     'iso-8859-9'   => 'latin5',
 453     'iso-8859-13'  => 'latin7',
 454     'iso-8859-15'  => 'latin1',
 455     'koi8-r'       => 'koi8r',
 456     'shift_jis'    => 'sjis',
 457     'tis-620'      => 'tis620',
 458     'utf-8'        => 'utf8',
 459     'windows-1250' => 'cp1250',
 460     'windows-1251' => 'cp1251',
 461     'windows-1252' => 'latin1',
 462     'windows-1256' => 'cp1256',
 463     'windows-1257' => 'cp1257',
 464 );
 465
 466 /*
 467  * Do the work!
 468  */
 469
 470 if (! PMA_langCheck()) {
 471     // fallback language
 472     $fall_back_lang = 'en';
 473     $line = __LINE__;
 474     if (! PMA_langSet($fall_back_lang)) {
 475         trigger_error(
 476             'phpMyAdmin-ERROR: invalid lang code: '
 477             . __FILE__ . '#' . $line . ', check hard coded fall back language.',
 478             E_USER_WARNING
 479         );
 480         // stop execution
 481         // and tell the user that his chosen language is invalid
 482         PMA_fatalError('Could not load any language, please check your language settings and folder.');
 483     }
 484 }
 485
 486 // Set locale
 487 _setlocale(LC_MESSAGES, $GLOBALS['lang']);
 488 _bindtextdomain('phpmyadmin', $GLOBALS['lang_path']);
 489 _bind_textdomain_codeset('phpmyadmin', 'UTF-8');
 490 _textdomain('phpmyadmin');
 491
 492 /**
 493  * Messages for phpMyAdmin.
 494  *
 495  * These messages are here for easy transition to Gettext.
 496  * You should not add any messages here, use instead gettext directly
 497  * in your template/PHP file.
 498  */
 499
 500 if (! function_exists('__')) {
 501     PMA_fatalError('Bad invocation!');
 502 }
 503
 504 /* Text direction for language */
 505 if (in_array($GLOBALS['lang'], array('ar', 'fa', 'he', 'ur'))) {
 506     $GLOBALS['text_dir'] = 'rtl';
 507 } else {
 508     $GLOBALS['text_dir'] = 'ltr';
 509 }
 510
 511 /* TCPDF */
 512 $GLOBALS['l'] = array();
 513
 514 /* TCPDF settings */
 515 $GLOBALS['l']['a_meta_charset'] = 'UTF-8';
 516 $GLOBALS['l']['a_meta_dir'] = $GLOBALS['text_dir'];
 517 $GLOBALS['l']['a_meta_language'] = $GLOBALS['lang'];
 518
 519 /* TCPDF translations */
 520 $GLOBALS['l']['w_page'] = __('Page number:');
 521
 522
 523 // now, that we have loaded the language strings we can send the errors
 524 if ($GLOBALS['lang_failed_cfg']) {
 525     trigger_error(
 526         sprintf(
 527             __('Unknown language: %1$s.'),
 528             htmlspecialchars($GLOBALS['lang_failed_cfg'])
 529         ),
 530         E_USER_ERROR
 531     );
 532 }
 533 if ($GLOBALS['lang_failed_cookie']) {
 534     trigger_error(
 535         sprintf(
 536             __('Unknown language: %1$s.'),
 537             htmlspecialchars($GLOBALS['lang_failed_cookie'])
 538         ),
 539         E_USER_ERROR
 540     );
 541 }
 542 if ($GLOBALS['lang_failed_request']) {
 543     trigger_error(
 544         sprintf(
 545             __('Unknown language: %1$s.'),
 546             htmlspecialchars($GLOBALS['lang_failed_request'])
 547         ),
 548         E_USER_ERROR
 549     );
 550 }
 551
 552 unset(
 553     $line, $fall_back_lang, $GLOBALS['lang_failed_cfg'],
 554     $GLOBALS['lang_failed_cookie'], $GLOBALS['lang_failed_request']
 555 );
 556 ?>