libraries/classes/LanguageManager.php

   1 <?php
   2
   3 declare(strict_types=1);
   4
   5 namespace PhpMyAdmin;
   6
   7 use PhpMyAdmin\Html\MySQLDocumentation;
   8 use const E_USER_ERROR;
   9 use function closedir;
  10 use function count;
  11 use function explode;
  12 use function file_exists;
  13 use function is_dir;
  14 use function opendir;
  15 use function preg_grep;
  16 use function readdir;
  17 use function strtolower;
  18 use function trigger_error;
  19 use function uasort;
  20 use function ucfirst;
  21
  22 /**
  23  * Language selection manager
  24  */
  25 class LanguageManager
  26 {
  27     /**
  28      * Definition data for languages
  29      *
  30      * Each member contains:
  31      * - Language code
  32      * - English language name
  33      * - Native language name
  34      * - Match regular expression
  35      * - MySQL locale
  36      *
  37      * @var array
  38      */
  39     private static $languageData = [
  40         'af' => [
  41             'af',
  42             'Afrikaans',
  43             '',
  44             'af|afrikaans',
  45             '',
  46         ],
  47         'am' => [
  48             'am',
  49             'Amharic',
  50             'አማርኛ',
  51             'am|amharic',
  52             '',
  53         ],
  54         'ar' => [
  55             'ar',
  56             'Arabic',
  57             '&#1575;&#1604;&#1593;&#1585;&#1576;&#1610;&#1577;',
  58             'ar|arabic',
  59             'ar_AE',
  60         ],
  61         'ar_ly' => [
  62             'ar_LY',
  63             'Arabic (Libya)',
  64             'ليبي',
  65             'ar[_-]ly|arabic (libya)|libian arabic',
  66             'ar_LY',
  67         ],
  68         'az' => [
  69             'az',
  70             'Azerbaijani',
  71             'Az&#601;rbaycanca',
  72             'az|azerbaijani',
  73             '',
  74         ],
  75         'bn' => [
  76             'bn',
  77             'Bangla',
  78             'বাংলা',
  79             'bn|bangla',
  80             '',
  81         ],
  82         'be' => [
  83             'be',
  84             'Belarusian',
  85             '&#1041;&#1077;&#1083;&#1072;&#1088;&#1091;&#1089;&#1082;&#1072;&#1103;',
  86             'be|belarusian',
  87             'be_BY',
  88         ],
  89         'be@latin' => [
  90             'be@latin',
  91             'Belarusian (latin)',
  92             'Bie&#0322;aruskaja',
  93             'be[-_]lat|be@latin|belarusian latin',
  94             '',
  95         ],
  96         'ber' => [
  97             'ber',
  98             'Berber',
  99             'Tamaziɣt',
 100             'ber|berber',
 101             '',
 102         ],
 103         'bg' => [
 104             'bg',
 105             'Bulgarian',
 106             '&#1041;&#1098;&#1083;&#1075;&#1072;&#1088;&#1089;&#1082;&#1080;',
 107             'bg|bulgarian',
 108             'bg_BG',
 109         ],
 110         'bs' => [
 111             'bs',
 112             'Bosnian',
 113             'Bosanski',
 114             'bs|bosnian',
 115             '',
 116         ],
 117         'br' => [
 118             'br',
 119             'Breton',
 120             'Brezhoneg',
 121             'br|breton',
 122             '',
 123         ],
 124         'brx' => [
 125             'brx',
 126             'Bodo',
 127             'बड़ो',
 128             'brx|bodo',
 129             '',
 130         ],
 131         'ca' => [
 132             'ca',
 133             'Catalan',
 134             'Catal&agrave;',
 135             'ca|catalan',
 136             'ca_ES',
 137         ],
 138         'ckb' => [
 139             'ckb',
 140             'Sorani',
 141             'سۆرانی',
 142             'ckb|sorani',
 143             '',
 144         ],
 145         'cs' => [
 146             'cs',
 147             'Czech',
 148             'Čeština',
 149             'cs|czech',
 150             'cs_CZ',
 151         ],
 152         'cy' => [
 153             'cy',
 154             'Welsh',
 155             'Cymraeg',
 156             'cy|welsh',
 157             '',
 158         ],
 159         'da' => [
 160             'da',
 161             'Danish',
 162             'Dansk',
 163             'da|danish',
 164             'da_DK',
 165         ],
 166         'de' => [
 167             'de',
 168             'German',
 169             'Deutsch',
 170             'de|german',
 171             'de_DE',
 172         ],
 173         'el' => [
 174             'el',
 175             'Greek',
 176             '&Epsilon;&lambda;&lambda;&eta;&nu;&iota;&kappa;&#940;',
 177             'el|greek',
 178             '',
 179         ],
 180         'en' => [
 181             'en',
 182             'English',
 183             '',
 184             'en|english',
 185             'en_US',
 186         ],
 187         'en_gb' => [
 188             'en_GB',
 189             'English (United Kingdom)',
 190             '',
 191             'en[_-]gb|english (United Kingdom)',
 192             'en_GB',
 193         ],
 194         'eo' => [
 195             'eo',
 196             'Esperanto',
 197             'Esperanto',
 198             'eo|esperanto',
 199             '',
 200         ],
 201         'es' => [
 202             'es',
 203             'Spanish',
 204             'Espa&ntilde;ol',
 205             'es|spanish',
 206             'es_ES',
 207         ],
 208         'et' => [
 209             'et',
 210             'Estonian',
 211             'Eesti',
 212             'et|estonian',
 213             'et_EE',
 214         ],
 215         'eu' => [
 216             'eu',
 217             'Basque',
 218             'Euskara',
 219             'eu|basque',
 220             'eu_ES',
 221         ],
 222         'fa' => [
 223             'fa',
 224             'Persian',
 225             '&#1601;&#1575;&#1585;&#1587;&#1740;',
 226             'fa|persian',
 227             '',
 228         ],
 229         'fi' => [
 230             'fi',
 231             'Finnish',
 232             'Suomi',
 233             'fi|finnish',
 234             'fi_FI',
 235         ],
 236         'fil' => [
 237             'fil',
 238             'Filipino',
 239             'Pilipino',
 240             'fil|filipino',
 241             '',
 242         ],
 243         'fr' => [
 244             'fr',
 245             'French',
 246             'Fran&ccedil;ais',
 247             'fr|french',
 248             'fr_FR',
 249         ],
 250         'fy' => [
 251             'fy',
 252             'Frisian',
 253             'Frysk',
 254             'fy|frisian',
 255             '',
 256         ],
 257         'gl' => [
 258             'gl',
 259             'Galician',
 260             'Galego',
 261             'gl|galician',
 262             'gl_ES',
 263         ],
 264         'gu' => [
 265             'gu',
 266             'Gujarati',
 267             'ગુજરાતી',
 268             'gu|gujarati',
 269             'gu_IN',
 270         ],
 271         'he' => [
 272             'he',
 273             'Hebrew',
 274             '&#1506;&#1489;&#1512;&#1497;&#1514;',
 275             'he|hebrew',
 276             'he_IL',
 277         ],
 278         'hi' => [
 279             'hi',
 280             'Hindi',
 281             '&#2361;&#2367;&#2344;&#2381;&#2342;&#2368;',
 282             'hi|hindi',
 283             'hi_IN',
 284         ],
 285         'hr' => [
 286             'hr',
 287             'Croatian',
 288             'Hrvatski',
 289             'hr|croatian',
 290             'hr_HR',
 291         ],
 292         'hu' => [
 293             'hu',
 294             'Hungarian',
 295             'Magyar',
 296             'hu|hungarian',
 297             'hu_HU',
 298         ],
 299         'hy' => [
 300             'hy',
 301             'Armenian',
 302             'Հայերէն',
 303             'hy|armenian',
 304             '',
 305         ],
 306         'ia' => [
 307             'ia',
 308             'Interlingua',
 309             '',
 310             'ia|interlingua',
 311             '',
 312         ],
 313         'id' => [
 314             'id',
 315             'Indonesian',
 316             'Bahasa Indonesia',
 317             'id|indonesian',
 318             'id_ID',
 319         ],
 320         'ig' => [
 321             'ig',
 322             'Igbo',
 323             'Asụsụ Igbo',
 324             'ig|igbo',
 325             '',
 326         ],
 327         'it' => [
 328             'it',
 329             'Italian',
 330             'Italiano',
 331             'it|italian',
 332             'it_IT',
 333         ],
 334         'ja' => [
 335             'ja',
 336             'Japanese',
 337             '&#26085;&#26412;&#35486;',
 338             'ja|japanese',
 339             'ja_JP',
 340         ],
 341         'ko' => [
 342             'ko',
 343             'Korean',
 344             '&#54620;&#44397;&#50612;',
 345             'ko|korean',
 346             'ko_KR',
 347         ],
 348         'ka' => [
 349             'ka',
 350             'Georgian',
 351             '&#4325;&#4304;&#4320;&#4311;&#4323;&#4314;&#4312;',
 352             'ka|georgian',
 353             '',
 354         ],
 355         'kab' => [
 356             'kab',
 357             'Kabylian',
 358             'Taqbaylit',
 359             'kab|kabylian',
 360             '',
 361         ],
 362         'kk' => [
 363             'kk',
 364             'Kazakh',
 365             'Қазақ',
 366             'kk|kazakh',
 367             '',
 368         ],
 369         'km' => [
 370             'km',
 371             'Khmer',
 372             'ខ្មែរ',
 373             'km|khmer',
 374             '',
 375         ],
 376         'kn' => [
 377             'kn',
 378             'Kannada',
 379             'ಕನ್ನಡ',
 380             'kn|kannada',
 381             '',
 382         ],
 383         'ksh' => [
 384             'ksh',
 385             'Colognian',
 386             'Kölsch',
 387             'ksh|colognian',
 388             '',
 389         ],
 390         'ku' => [
 391             'ku',
 392             'Kurdish',
 393             'کوردی',
 394             'ku|kurdish',
 395             '',
 396         ],
 397         'ky' => [
 398             'ky',
 399             'Kyrgyz',
 400             'Кыргызча',
 401             'ky|kyrgyz',
 402             '',
 403         ],
 404         'li' => [
 405             'li',
 406             'Limburgish',
 407             'Lèmbörgs',
 408             'li|limburgish',
 409             '',
 410         ],
 411         'lt' => [
 412             'lt',
 413             'Lithuanian',
 414             'Lietuvi&#371;',
 415             'lt|lithuanian',
 416             'lt_LT',
 417         ],
 418         'lv' => [
 419             'lv',
 420             'Latvian',
 421             'Latvie&scaron;u',
 422             'lv|latvian',
 423             'lv_LV',
 424         ],
 425         'mk' => [
 426             'mk',
 427             'Macedonian',
 428             'Macedonian',
 429             'mk|macedonian',
 430             'mk_MK',
 431         ],
 432         'ml' => [
 433             'ml',
 434             'Malayalam',
 435             'Malayalam',
 436             'ml|malayalam',
 437             '',
 438         ],
 439         'mn' => [
 440             'mn',
 441             'Mongolian',
 442             '&#1052;&#1086;&#1085;&#1075;&#1086;&#1083;',
 443             'mn|mongolian',
 444             'mn_MN',
 445         ],
 446         'ms' => [
 447             'ms',
 448             'Malay',
 449             'Bahasa Melayu',
 450             'ms|malay',
 451             'ms_MY',
 452         ],
 453         'my' => [
 454             'my',
 455             'Burmese',
 456             'မြန်မာ',
 457             'my|burmese',
 458             '',
 459         ],
 460         'ne' => [
 461             'ne',
 462             'Nepali',
 463             'नेपाली',
 464             'ne|nepali',
 465             '',
 466         ],
 467         'nb' => [
 468             'nb',
 469             'Norwegian',
 470             'Norsk',
 471             'nb|norwegian',
 472             'nb_NO',
 473         ],
 474         'nn' => [
 475             'nn',
 476             'Norwegian Nynorsk',
 477             'Nynorsk',
 478             'nn|nynorsk',
 479             'nn_NO',
 480         ],
 481         'nl' => [
 482             'nl',
 483             'Dutch',
 484             'Nederlands',
 485             'nl|dutch',
 486             'nl_NL',
 487         ],
 488         'pa' => [
 489             'pa',
 490             'Punjabi',
 491             'ਪੰਜਾਬੀ',
 492             'pa|punjabi',
 493             '',
 494         ],
 495         'pl' => [
 496             'pl',
 497             'Polish',
 498             'Polski',
 499             'pl|polish',
 500             'pl_PL',
 501         ],
 502         'pt' => [
 503             'pt',
 504             'Portuguese',
 505             'Portugu&ecirc;s',
 506             'pt|portuguese',
 507             'pt_PT',
 508         ],
 509         'pt_br' => [
 510             'pt_BR',
 511             'Portuguese (Brazil)',
 512             'Portugu&ecirc;s (Brasil)',
 513             'pt[-_]br|portuguese (brazil)',
 514             'pt_BR',
 515         ],
 516         'rcf' => [
 517             'rcf',
 518             'R&eacute;union Creole',
 519             'Kr&eacute;ol',
 520             'rcf|creole (reunion)',
 521             '',
 522         ],
 523         'ro' => [
 524             'ro',
 525             'Romanian',
 526             'Rom&acirc;n&#259;',
 527             'ro|romanian',
 528             'ro_RO',
 529         ],
 530         'ru' => [
 531             'ru',
 532             'Russian',
 533             '&#1056;&#1091;&#1089;&#1089;&#1082;&#1080;&#1081;',
 534             'ru|russian',
 535             'ru_RU',
 536         ],
 537         'si' => [
 538             'si',
 539             'Sinhala',
 540             '&#3523;&#3538;&#3458;&#3524;&#3517;',
 541             'si|sinhala',
 542             '',
 543         ],
 544         'sk' => [
 545             'sk',
 546             'Slovak',
 547             'Sloven&#269;ina',
 548             'sk|slovak',
 549             'sk_SK',
 550         ],
 551         'sl' => [
 552             'sl',
 553             'Slovenian',
 554             'Sloven&scaron;&#269;ina',
 555             'sl|slovenian',
 556             'sl_SI',
 557         ],
 558         'sq' => [
 559             'sq',
 560             'Albanian',
 561             'Shqip',
 562             'sq|albanian',
 563             'sq_AL',
 564         ],
 565         'sr@latin' => [
 566             'sr@latin',
 567             'Serbian (latin)',
 568             'Srpski',
 569             'sr[-_]lat|sr@latin|serbian latin',
 570             'sr_YU',
 571         ],
 572         'sr' => [
 573             'sr',
 574             'Serbian',
 575             '&#1057;&#1088;&#1087;&#1089;&#1082;&#1080;',
 576             'sr|serbian',
 577             'sr_YU',
 578         ],
 579         'sv' => [
 580             'sv',
 581             'Swedish',
 582             'Svenska',
 583             'sv|swedish',
 584             'sv_SE',
 585         ],
 586         'ta' => [
 587             'ta',
 588             'Tamil',
 589             'தமிழ்',
 590             'ta|tamil',
 591             'ta_IN',
 592         ],
 593         'te' => [
 594             'te',
 595             'Telugu',
 596             'తెలుగు',
 597             'te|telugu',
 598             'te_IN',
 599         ],
 600         'th' => [
 601             'th',
 602             'Thai',
 603             '&#3616;&#3634;&#3625;&#3634;&#3652;&#3607;&#3618;',
 604             'th|thai',
 605             'th_TH',
 606         ],
 607         'tk' => [
 608             'tk',
 609             'Turkmen',
 610             'Türkmençe',
 611             'tk|turkmen',
 612             '',
 613         ],
 614         'tr' => [
 615             'tr',
 616             'Turkish',
 617             'T&uuml;rk&ccedil;e',
 618             'tr|turkish',
 619             'tr_TR',
 620         ],
 621         'tt' => [
 622             'tt',
 623             'Tatarish',
 624             'Tatar&ccedil;a',
 625             'tt|tatarish',
 626             '',
 627         ],
 628         'tzm' => [
 629             'tzm',
 630             'Central Atlas Tamazight',
 631             'Tamaziɣt',
 632             'tzm|central atlas tamazight',
 633             '',
 634         ],
 635         'ug' => [
 636             'ug',
 637             'Uyghur',
 638             'ئۇيغۇرچە',
 639             'ug|uyghur',
 640             '',
 641         ],
 642         'uk' => [
 643             'uk',
 644             'Ukrainian',
 645             '&#1059;&#1082;&#1088;&#1072;&#1111;&#1085;&#1089;&#1100;&#1082;&#1072;',
 646             'uk|ukrainian',
 647             'uk_UA',
 648         ],
 649         'ur' => [
 650             'ur',
 651             'Urdu',
 652             'اُردوُ',
 653             'ur|urdu',
 654             'ur_PK',
 655         ],
 656         'uz@latin' => [
 657             'uz@latin',
 658             'Uzbek (latin)',
 659             'O&lsquo;zbekcha',
 660             'uz[-_]lat|uz@latin|uzbek-latin',
 661             '',
 662         ],
 663         'uz' => [
 664             'uz',
 665             'Uzbek (cyrillic)',
 666             '&#1038;&#1079;&#1073;&#1077;&#1082;&#1095;&#1072;',
 667             'uz[-_]cyr|uz@cyrillic|uzbek-cyrillic',
 668             '',
 669         ],
 670         'vi' => [
 671             'vi',
 672             'Vietnamese',
 673             'Tiếng Việt',
 674             'vi|vietnamese',
 675             'vi_VN',
 676         ],
 677         'vls' => [
 678             'vls',
 679             'Flemish',
 680             'West-Vlams',
 681             'vls|flemish',
 682             '',
 683         ],
 684         'zh_tw' => [
 685             'zh_TW',
 686             'Chinese traditional',
 687             '&#20013;&#25991;',
 688             'zh[-_](tw|hk)|chinese traditional',
 689             'zh_TW',
 690         ],
 691         // only TW and HK use traditional Chinese while others (CN, SG, MY)
 692         // use simplified Chinese
 693         'zh_cn' => [
 694             'zh_CN',
 695             'Chinese simplified',
 696             '&#20013;&#25991;',
 697             'zh(?![-_](tw|hk))([-_][[:alpha:]]{2,3})?|chinese simplified',
 698             'zh_CN',
 699         ],
 700     ];
 701
 702     /** @var array */
 703     private $availableLocales;
 704
 705     /** @var array */
 706     private $availableLanguages = [];
 707
 708     /** @var bool */
 709     private $langFailedConfig = false;
 710
 711     /** @var bool */
 712     private $langFailedCookie = false;
 713
 714     /** @var bool */
 715     private $langFailedRequest = false;
 716
 717     /** @var LanguageManager */
 718     private static $instance;
 719
 720     /**
 721      * Returns LanguageManager singleton
 722      *
 723      * @return LanguageManager
 724      */
 725     public static function getInstance()
 726     {
 727         if (self::$instance === null) {
 728             self::$instance = new LanguageManager();
 729         }
 730
 731         return self::$instance;
 732     }
 733
 734     /**
 735      * Returns list of available locales
 736      *
 737      * @return array
 738      */
 739     public function listLocaleDir()
 740     {
 741         $result = ['en'];
 742
 743         /* Check for existing directory */
 744         if (! is_dir(LOCALE_PATH)) {
 745             return $result;
 746         }
 747
 748         /* Open the directory */
 749         $handle = @opendir(LOCALE_PATH);
 750         /* This can happen if the kit is English-only */
 751         if ($handle === false) {
 752             return $result;
 753         }
 754
 755         /* Process all files */
 756         while (($file = readdir($handle)) !== false) {
 757             $path = LOCALE_PATH
 758                 . '/' . $file
 759                 . '/LC_MESSAGES/phpmyadmin.mo';
 760             if ($file === '.'
 761                 || $file === '..'
 762                 || ! @file_exists($path)
 763             ) {
 764                 continue;
 765             }
 766
 767             $result[] = $file;
 768         }
 769         /* Close the handle */
 770         closedir($handle);
 771
 772         return $result;
 773     }
 774
 775     /**
 776      * Returns (cached) list of all available locales
 777      *
 778      * @return array of strings
 779      */
 780     public function availableLocales()
 781     {
 782         if (! $this->availableLocales) {
 783             if (! isset($GLOBALS['PMA_Config']) || empty($GLOBALS['PMA_Config']->get('FilterLanguages'))) {
 784                 $this->availableLocales = $this->listLocaleDir();
 785             } else {
 786                 $this->availableLocales = preg_grep(
 787                     '@' . $GLOBALS['PMA_Config']->get('FilterLanguages') . '@',
 788                     $this->listLocaleDir()
 789                 );
 790             }
 791         }
 792
 793         return $this->availableLocales;
 794     }
 795
 796     /**
 797      * Checks whether there are some languages available
 798      *
 799      * @return bool
 800      */
 801     public function hasChoice()
 802     {
 803         return count($this->availableLanguages()) > 1;
 804     }
 805
 806     /**
 807      * Returns (cached) list of all available languages
 808      *
 809      * @return Language[] array of Language objects
 810      */
 811     public function availableLanguages()
 812     {
 813         if (! $this->availableLanguages) {
 814             $this->availableLanguages = [];
 815
 816             foreach ($this->availableLocales() as $lang) {
 817                 $lang = strtolower($lang);
 818                 if (isset(static::$languageData[$lang])) {
 819                     $data = static::$languageData[$lang];
 820                     $this->availableLanguages[$lang] = new Language(
 821                         $data[0],
 822                         $data[1],
 823                         $data[2],
 824                         $data[3],
 825                         $data[4]
 826                     );
 827                 } else {
 828                     $this->availableLanguages[$lang] = new Language(
 829                         $lang,
 830                         ucfirst($lang),
 831                         ucfirst($lang),
 832                         $lang,
 833                         ''
 834                     );
 835                 }
 836             }
 837         }
 838
 839         return $this->availableLanguages;
 840     }
 841
 842     /**
 843      * Returns (cached) list of all available languages sorted
 844      * by name
 845      *
 846      * @return Language[] array of Language objects
 847      */
 848     public function sortedLanguages()
 849     {
 850         $this->availableLanguages();
 851         uasort($this->availableLanguages, static function (Language $a, Language $b) {
 852             return $a->cmp($b);
 853         });
 854
 855         return $this->availableLanguages;
 856     }
 857
 858     /**
 859      * Return Language object for given code
 860      *
 861      * @param string $code Language code
 862      *
 863      * @return Language|false Language object or false on failure
 864      */
 865     public function getLanguage($code)
 866     {
 867         $code = strtolower($code);
 868         $langs = $this->availableLanguages();
 869         if (isset($langs[$code])) {
 870             return $langs[$code];
 871         }
 872
 873         return false;
 874     }
 875
 876     /**
 877      * Return currently active Language object
 878      *
 879      * @return Language Language object
 880      */
 881     public function getCurrentLanguage()
 882     {
 883         return $this->availableLanguages[strtolower($GLOBALS['lang'])];
 884     }
 885
 886     /**
 887      * Activates language based on configuration, user preferences or
 888      * browser
 889      *
 890      * @return Language
 891      */
 892     public function selectLanguage()
 893     {
 894         // check forced language
 895         if (! empty($GLOBALS['PMA_Config']->get('Lang'))) {
 896             $lang = $this->getLanguage($GLOBALS['PMA_Config']->get('Lang'));
 897             if ($lang !== false) {
 898                 return $lang;
 899             }
 900             $this->langFailedConfig = true;
 901         }
 902
 903         // Don't use REQUEST in following code as it might be confused by cookies
 904         // with same name. Check user requested language (POST)
 905         if (! empty($_POST['lang'])) {
 906             $lang = $this->getLanguage($_POST['lang']);
 907             if ($lang !== false) {
 908                 return $lang;
 909             }
 910             $this->langFailedRequest = true;
 911         }
 912
 913         // check user requested language (GET)
 914         if (! empty($_GET['lang'])) {
 915             $lang = $this->getLanguage($_GET['lang']);
 916             if ($lang !== false) {
 917                 return $lang;
 918             }
 919             $this->langFailedRequest = true;
 920         }
 921
 922         // check previous set language
 923         if (! empty($GLOBALS['PMA_Config']->getCookie('pma_lang'))) {
 924             $lang = $this->getLanguage($GLOBALS['PMA_Config']->getCookie('pma_lang'));
 925             if ($lang !== false) {
 926                 return $lang;
 927             }
 928             $this->langFailedCookie = true;
 929         }
 930
 931         $langs = $this->availableLanguages();
 932
 933         // try to find out user's language by checking its HTTP_ACCEPT_LANGUAGE variable;
 934         $accepted_languages = Core::getenv('HTTP_ACCEPT_LANGUAGE');
 935         if ($accepted_languages) {
 936             foreach (explode(',', $accepted_languages) as $header) {
 937                 foreach ($langs as $language) {
 938                     if ($language->matchesAcceptLanguage($header)) {
 939                         return $language;
 940                     }
 941                 }
 942             }
 943         }
 944
 945         // try to find out user's language by checking its HTTP_USER_AGENT variable
 946         $user_agent = Core::getenv('HTTP_USER_AGENT');
 947         if (! empty($user_agent)) {
 948             foreach ($langs as $language) {
 949                 if ($language->matchesUserAgent($user_agent)) {
 950                     return $language;
 951                 }
 952             }
 953         }
 954
 955         // Didn't catch any valid lang : we use the default settings
 956         if (isset($langs[$GLOBALS['PMA_Config']->get('DefaultLang')])) {
 957             return $langs[$GLOBALS['PMA_Config']->get('DefaultLang')];
 958         }
 959
 960         // Fallback to English
 961         return $langs['en'];
 962     }
 963
 964     /**
 965      * Displays warnings about invalid languages. This needs to be postponed
 966      * to show messages at time when language is initialized.
 967      *
 968      * @return void
 969      */
 970     public function showWarnings()
 971     {
 972         // now, that we have loaded the language strings we can send the errors
 973         if (! $this->langFailedConfig
 974             && ! $this->langFailedCookie
 975             && ! $this->langFailedRequest
 976         ) {
 977             return;
 978         }
 979
 980         trigger_error(
 981             __('Ignoring unsupported language code.'),
 982             E_USER_ERROR
 983         );
 984     }
 985
 986     /**
 987      * Returns HTML code for the language selector
 988      *
 989      * @param Template $template     Template instance
 990      * @param bool     $use_fieldset whether to use fieldset for selection
 991      * @param bool     $show_doc     whether to show documentation links
 992      *
 993      * @return string
 994      *
 995      * @access public
 996      */
 997     public function getSelectorDisplay(Template $template, $use_fieldset = false, $show_doc = true)
 998     {
 999         $_form_params = [
1000             'db' => $GLOBALS['db'],
1001             'table' => $GLOBALS['table'],
1002         ];
1003
1004         // For non-English, display "Language" with emphasis because it's
1005         // not a proper word in the current language; we show it to help
1006         // people recognize the dialog
1007         $language_title = __('Language')
1008             . (__('Language') !== 'Language' ? ' - <em>Language</em>' : '');
1009         if ($show_doc) {
1010             $language_title .= MySQLDocumentation::showDocumentation('faq', 'faq7-2');
1011         }
1012
1013         $available_languages = $this->sortedLanguages();
1014
1015         return $template->render('select_lang', [
1016             'language_title' => $language_title,
1017             'use_fieldset' => $use_fieldset,
1018             'available_languages' => $available_languages,
1019             '_form_params' => $_form_params,
1020         ]);
1021     }
1022 }