libraries/Language.php

   1 <?php
   2 /* vim: set expandtab sw=4 ts=4 sts=4: */
   3 /**
   4  * Hold the PMA\libraries\LanguageManager class
   5  *
   6  * @package PhpMyAdmin
   7  */
   8 namespace PMA\libraries;
   9
  10 use PMA\libraries\LanguageManager;
  11
  12
  13 /**
  14  * Language object
  15  *
  16  * @package PhpMyAdmin
  17  */
  18 class Language
  19 {
  20     protected $code;
  21     protected $name;
  22     protected $native;
  23     protected $regex;
  24     protected $mysql;
  25
  26     /**
  27      * Constructs the Language object
  28      *
  29      * @param string $code   Language code
  30      * @param string $name   English name
  31      * @param string $native Native name
  32      * @param string $regex  Match regullar expression
  33      * @param string $mysql  MySQL locale code
  34      *
  35      */
  36     public function __construct($code, $name, $native, $regex, $mysql)
  37     {
  38         $this->code = $code;
  39         $this->name = $name;
  40         $this->native = $native;
  41         if (strpos($regex, '[-_]') === false) {
  42             $regex = str_replace('|', '([-_][[:alpha:]]{2,3})?|', $regex);
  43         }
  44         $this->regex = $regex;
  45         $this->mysql = $mysql;
  46     }
  47
  48     /**
  49      * Returns native name for language
  50      *
  51      * @return string
  52      */
  53     public function getNativeName()
  54     {
  55         return $this->native;
  56     }
  57
  58     /**
  59      * Returns English name for language
  60      *
  61      * @return string
  62      */
  63     public function getEnglishName()
  64     {
  65         return $this->name;
  66     }
  67
  68     /**
  69      * Returns verbose name for language
  70      *
  71      * @return string
  72      */
  73     public function getName()
  74     {
  75         if (! empty($this->native)) {
  76             return $this->native . ' - ' . $this->name;
  77         } else {
  78             return $this->name;
  79         }
  80     }
  81
  82     /**
  83      * Returns language code
  84      *
  85      * @return string
  86      */
  87     public function getCode()
  88     {
  89         return $this->code;
  90     }
  91
  92     /**
  93      * Returns MySQL locale code, can be empty
  94      *
  95      * @return string
  96      */
  97     public function getMySQLLocale()
  98     {
  99         return $this->mysql;
 100     }
 101
 102     /**
 103      * Compare function used for sorting
 104      *
 105      * @param Language $other Other object to compare
 106      *
 107      * @return int same as strcmp
 108      */
 109     public function cmp($other)
 110     {
 111         return strcmp($this->name, $other->name);
 112     }
 113
 114     /**
 115      * Checks whether language is currently active.
 116      *
 117      * @return bool
 118      */
 119     public function isActive()
 120     {
 121         return $GLOBALS['lang'] == $this->code;
 122     }
 123
 124     /**
 125      * Checks whether language matches HTTP header Accept-Language.
 126      *
 127      * @param string $header Header content
 128      *
 129      * @return bool
 130      */
 131     public function matchesAcceptLanguage($header)
 132     {
 133         $pattern = '/^('
 134             . addcslashes($this->regex, '/')
 135             . ')(;q=[0-9]\\.[0-9])?$/i';
 136         return preg_match($pattern, $header);
 137     }
 138
 139     /**
 140      * Checks whether language matches HTTP header User-Agent
 141      *
 142      * @param string $header Header content
 143      *
 144      * @return bool
 145      */
 146     public function matchesUserAgent($header)
 147     {
 148         $pattern = '/(\(|\[|;[[:space:]])('
 149             . addcslashes($this->regex, '/')
 150             . ')(;|\]|\))/i';
 151         return preg_match($pattern, $header);
 152     }
 153
 154     /**
 155      * Checks whether langauge is RTL
 156      *
 157      * @return bool
 158      */
 159     public function isRTL()
 160     {
 161         return in_array($this->code, array('ar', 'fa', 'he', 'ur'));
 162     }
 163
 164     /**
 165      * Activates given translation
 166      *
 167      * @return bool
 168      */
 169     public function activate()
 170     {
 171         $GLOBALS['lang'] = $this->code;
 172
 173         // Set locale
 174         _setlocale(LC_MESSAGES, $this->code);
 175         _bindtextdomain('phpmyadmin', LOCALE_PATH);
 176         _bind_textdomain_codeset('phpmyadmin', 'UTF-8');
 177         _textdomain('phpmyadmin');
 178
 179         /* Text direction for language */
 180         if ($this->isRTL()) {
 181             $GLOBALS['text_dir'] = 'rtl';
 182         } else {
 183             $GLOBALS['text_dir'] = 'ltr';
 184         }
 185
 186         /* TCPDF */
 187         $GLOBALS['l'] = array();
 188
 189         /* TCPDF settings */
 190         $GLOBALS['l']['a_meta_charset'] = 'UTF-8';
 191         $GLOBALS['l']['a_meta_dir'] = $GLOBALS['text_dir'];
 192         $GLOBALS['l']['a_meta_language'] = $this->code;
 193
 194         /* TCPDF translations */
 195         $GLOBALS['l']['w_page'] = __('Page number:');
 196
 197         /* Show possible warnings from langauge selection */
 198         LanguageManager::getInstance()->showWarnings();
 199     }
 200 }