1: <?php
  2: /**
  3:  * Localization
  4:  *
  5:  * CakePHP(tm) : Rapid Development Framework (http://cakephp.org)
  6:  * Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
  7:  *
  8:  * Licensed under The MIT License
  9:  * For full copyright and license information, please see the LICENSE.txt
 10:  * Redistributions of files must retain the above copyright notice.
 11:  *
 12:  * @copyright     Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
 13:  * @link          http://cakephp.org CakePHP(tm) Project
 14:  * @package       Cake.I18n
 15:  * @since         CakePHP(tm) v 1.2.0.4116
 16:  * @license       http://www.opensource.org/licenses/mit-license.php MIT License
 17:  */
 18: 
 19: App::uses('CakeRequest', 'Network');
 20: 
 21: /**
 22:  * Localization
 23:  *
 24:  * @package       Cake.I18n
 25:  */
 26: class L10n {
 27: 
 28: /**
 29:  * The language for current locale
 30:  *
 31:  * @var string
 32:  */
 33:     public $language = 'English (United States)';
 34: 
 35: /**
 36:  * Locale search paths
 37:  *
 38:  * @var array
 39:  */
 40:     public $languagePath = array('en_us', 'eng');
 41: 
 42: /**
 43:  * ISO 639-3 for current locale
 44:  *
 45:  * @var string
 46:  */
 47:     public $lang = 'eng';
 48: 
 49: /**
 50:  * Locale
 51:  *
 52:  * @var string
 53:  */
 54:     public $locale = 'en_us';
 55: 
 56: /**
 57:  * Default language.
 58:  *
 59:  * If config value 'Config.language' is set in an application this will be set
 60:  * as a fall back else if DEFAULT_LANGUAGE it defined it will be used.
 61:  * Constant DEFAULT_LANGUAGE has been deprecated in 2.4
 62:  *
 63:  * @var string
 64:  */
 65:     public $default = null;
 66: 
 67: /**
 68:  * Encoding used for current locale
 69:  *
 70:  * @var string
 71:  */
 72:     public $charset = 'utf-8';
 73: 
 74: /**
 75:  * Text direction for current locale
 76:  *
 77:  * @var string
 78:  */
 79:     public $direction = 'ltr';
 80: 
 81: /**
 82:  * Maps ISO 639-3 to I10n::_l10nCatalog
 83:  * The terminological codes (first one per language) should be used if possible.
 84:  * They are the ones building the path in `/APP/Locale/[code]/`
 85:  * The bibliographic codes are aliases.
 86:  *
 87:  * @var array
 88:  */
 89:     protected $_l10nMap = array(
 90:         /* Afrikaans */ 'afr' => 'af',
 91:         /* Albanian */ 'sqi' => 'sq',
 92:         /* Albanian - bibliographic */ 'alb' => 'sq',
 93:         /* Arabic */ 'ara' => 'ar',
 94:         /* Armenian/Armenia */ 'hye' => 'hy',
 95:         /* Basque */ 'eus' => 'eu',
 96:         /* Basque */ 'baq' => 'eu',
 97:         /* Tibetan */ 'bod' => 'bo',
 98:         /* Tibetan - bibliographic */ 'tib' => 'bo',
 99:         /* Bosnian */ 'bos' => 'bs',
100:         /* Bulgarian */ 'bul' => 'bg',
101:         /* Byelorussian */ 'bel' => 'be',
102:         /* Catalan */ 'cat' => 'ca',
103:         /* Chinese */ 'zho' => 'zh',
104:         /* Chinese - bibliographic */ 'chi' => 'zh',
105:         /* Croatian */ 'hrv' => 'hr',
106:         /* Czech */ 'ces' => 'cs',
107:         /* Czech - bibliographic */ 'cze' => 'cs',
108:         /* Danish */ 'dan' => 'da',
109:         /* Dutch (Standard) */ 'nld' => 'nl',
110:         /* Dutch (Standard) - bibliographic */ 'dut' => 'nl',
111:         /* English */ 'eng' => 'en',
112:         /* Estonian */ 'est' => 'et',
113:         /* Faeroese */ 'fao' => 'fo',
114:         /* Farsi/Persian */ 'fas' => 'fa',
115:         /* Farsi/Persian - bibliographic */ 'per' => 'fa',
116:         /* Finnish */ 'fin' => 'fi',
117:         /* French (Standard) */ 'fra' => 'fr',
118:         /* French (Standard)  - bibliographic */ 'fre' => 'fr',
119:         /* Gaelic (Scots) */ 'gla' => 'gd',
120:         /* Galician */ 'glg' => 'gl',
121:         /* German (Standard) */ 'deu' => 'de',
122:         /* German (Standard) - bibliographic */ 'ger' => 'de',
123:         /* Greek */ 'gre' => 'el',
124:         /* Greek */ 'ell' => 'el',
125:         /* Hebrew */ 'heb' => 'he',
126:         /* Hindi */ 'hin' => 'hi',
127:         /* Hungarian */ 'hun' => 'hu',
128:         /* Icelandic */ 'isl' => 'is',
129:         /* Icelandic - bibliographic */ 'ice' => 'is',
130:         /* Indonesian */ 'ind' => 'id',
131:         /* Irish */ 'gle' => 'ga',
132:         /* Italian */ 'ita' => 'it',
133:         /* Japanese */ 'jpn' => 'ja',
134:         /* Kazakh */ 'kaz' => 'kk',
135:         /* Kalaallisut (Greenlandic) */ 'kal' => 'kl',
136:         /* Korean */ 'kor' => 'ko',
137:         /* Latvian */ 'lav' => 'lv',
138:         /* Limburgish */ 'lim' => 'li',
139:         /* Lithuanian */ 'lit' => 'lt',
140:         /* Macedonian */ 'mkd' => 'mk',
141:         /* Macedonian - bibliographic */ 'mac' => 'mk',
142:         /* Malaysian */ 'msa' => 'ms',
143:         /* Malaysian - bibliographic */ 'may' => 'ms',
144:         /* Maltese */ 'mlt' => 'mt',
145:         /* Norwegian */ 'nor' => 'no',
146:         /* Norwegian Bokmal */ 'nob' => 'nb',
147:         /* Norwegian Nynorsk */ 'nno' => 'nn',
148:         /* Polish */ 'pol' => 'pl',
149:         /* Portuguese (Portugal) */ 'por' => 'pt',
150:         /* Rhaeto-Romanic */ 'roh' => 'rm',
151:         /* Romanian */ 'ron' => 'ro',
152:         /* Romanian - bibliographic */ 'rum' => 'ro',
153:         /* Russian */ 'rus' => 'ru',
154:         /* Sami */ 'sme' => 'se',
155:         /* Serbian */ 'srp' => 'sr',
156:         /* Slovak */ 'slk' => 'sk',
157:         /* Slovak - bibliographic */ 'slo' => 'sk',
158:         /* Slovenian */ 'slv' => 'sl',
159:         /* Sorbian */ 'wen' => 'sb',
160:         /* Spanish (Spain - Traditional) */ 'spa' => 'es',
161:         /* Swedish */ 'swe' => 'sv',
162:         /* Thai */ 'tha' => 'th',
163:         /* Tsonga */ 'tso' => 'ts',
164:         /* Tswana */ 'tsn' => 'tn',
165:         /* Turkish */ 'tur' => 'tr',
166:         /* Ukrainian */ 'ukr' => 'uk',
167:         /* Urdu */ 'urd' => 'ur',
168:         /* Venda */ 'ven' => 've',
169:         /* Vietnamese */ 'vie' => 'vi',
170:         /* Welsh */ 'cym' => 'cy',
171:         /* Welsh - bibliographic */ 'wel' => 'cy',
172:         /* Xhosa */ 'xho' => 'xh',
173:         /* Yiddish */ 'yid' => 'yi',
174:         /* Zulu */ 'zul' => 'zu'
175:     );
176: 
177: /**
178:  * HTTP_ACCEPT_LANGUAGE catalog
179:  *
180:  * holds all information related to a language
181:  *
182:  * @var array
183:  */
184:     protected $_l10nCatalog = array(
185:         'af' => array('language' => 'Afrikaans', 'locale' => 'afr', 'localeFallback' => 'afr', 'charset' => 'utf-8', 'direction' => 'ltr'),
186:         'ar' => array('language' => 'Arabic', 'locale' => 'ara', 'localeFallback' => 'ara', 'charset' => 'utf-8', 'direction' => 'rtl'),
187:         'ar-ae' => array('language' => 'Arabic (U.A.E.)', 'locale' => 'ar_ae', 'localeFallback' => 'ara', 'charset' => 'utf-8', 'direction' => 'rtl'),
188:         'ar-bh' => array('language' => 'Arabic (Bahrain)', 'locale' => 'ar_bh', 'localeFallback' => 'ara', 'charset' => 'utf-8', 'direction' => 'rtl'),
189:         'ar-dz' => array('language' => 'Arabic (Algeria)', 'locale' => 'ar_dz', 'localeFallback' => 'ara', 'charset' => 'utf-8', 'direction' => 'rtl'),
190:         'ar-eg' => array('language' => 'Arabic (Egypt)', 'locale' => 'ar_eg', 'localeFallback' => 'ara', 'charset' => 'utf-8', 'direction' => 'rtl'),
191:         'ar-iq' => array('language' => 'Arabic (Iraq)', 'locale' => 'ar_iq', 'localeFallback' => 'ara', 'charset' => 'utf-8', 'direction' => 'rtl'),
192:         'ar-jo' => array('language' => 'Arabic (Jordan)', 'locale' => 'ar_jo', 'localeFallback' => 'ara', 'charset' => 'utf-8', 'direction' => 'rtl'),
193:         'ar-kw' => array('language' => 'Arabic (Kuwait)', 'locale' => 'ar_kw', 'localeFallback' => 'ara', 'charset' => 'utf-8', 'direction' => 'rtl'),
194:         'ar-lb' => array('language' => 'Arabic (Lebanon)', 'locale' => 'ar_lb', 'localeFallback' => 'ara', 'charset' => 'utf-8', 'direction' => 'rtl'),
195:         'ar-ly' => array('language' => 'Arabic (Libya)', 'locale' => 'ar_ly', 'localeFallback' => 'ara', 'charset' => 'utf-8', 'direction' => 'rtl'),
196:         'ar-ma' => array('language' => 'Arabic (Morocco)', 'locale' => 'ar_ma', 'localeFallback' => 'ara', 'charset' => 'utf-8', 'direction' => 'rtl'),
197:         'ar-om' => array('language' => 'Arabic (Oman)', 'locale' => 'ar_om', 'localeFallback' => 'ara', 'charset' => 'utf-8', 'direction' => 'rtl'),
198:         'ar-qa' => array('language' => 'Arabic (Qatar)', 'locale' => 'ar_qa', 'localeFallback' => 'ara', 'charset' => 'utf-8', 'direction' => 'rtl'),
199:         'ar-sa' => array('language' => 'Arabic (Saudi Arabia)', 'locale' => 'ar_sa', 'localeFallback' => 'ara', 'charset' => 'utf-8', 'direction' => 'rtl'),
200:         'ar-sy' => array('language' => 'Arabic (Syria)', 'locale' => 'ar_sy', 'localeFallback' => 'ara', 'charset' => 'utf-8', 'direction' => 'rtl'),
201:         'ar-tn' => array('language' => 'Arabic (Tunisia)', 'locale' => 'ar_tn', 'localeFallback' => 'ara', 'charset' => 'utf-8', 'direction' => 'rtl'),
202:         'ar-ye' => array('language' => 'Arabic (Yemen)', 'locale' => 'ar_ye', 'localeFallback' => 'ara', 'charset' => 'utf-8', 'direction' => 'rtl'),
203:         'be' => array('language' => 'Byelorussian', 'locale' => 'bel', 'localeFallback' => 'bel', 'charset' => 'utf-8', 'direction' => 'ltr'),
204:         'bg' => array('language' => 'Bulgarian', 'locale' => 'bul', 'localeFallback' => 'bul', 'charset' => 'utf-8', 'direction' => 'ltr'),
205:         'bo' => array('language' => 'Tibetan', 'locale' => 'bod', 'localeFallback' => 'bod', 'charset' => 'utf-8', 'direction' => 'ltr'),
206:         'bo-cn' => array('language' => 'Tibetan (China)', 'locale' => 'bo_cn', 'localeFallback' => 'bod', 'charset' => 'utf-8', 'direction' => 'ltr'),
207:         'bo-in' => array('language' => 'Tibetan (India)', 'locale' => 'bo_in', 'localeFallback' => 'bod', 'charset' => 'utf-8', 'direction' => 'ltr'),
208:         'bs' => array('language' => 'Bosnian', 'locale' => 'bos', 'localeFallback' => 'bos', 'charset' => 'utf-8', 'direction' => 'ltr'),
209:         'ca' => array('language' => 'Catalan', 'locale' => 'cat', 'localeFallback' => 'cat', 'charset' => 'utf-8', 'direction' => 'ltr'),
210:         'cs' => array('language' => 'Czech', 'locale' => 'ces', 'localeFallback' => 'ces', 'charset' => 'utf-8', 'direction' => 'ltr'),
211:         'da' => array('language' => 'Danish', 'locale' => 'dan', 'localeFallback' => 'dan', 'charset' => 'utf-8', 'direction' => 'ltr'),
212:         'da-dk' => array('language' => 'Danish (Denmark)', 'locale' => 'da_dk', 'localeFallback' => 'dan', 'charset' => 'utf-8', 'direction' => 'ltr'),
213:         'de' => array('language' => 'German (Standard)', 'locale' => 'deu', 'localeFallback' => 'deu', 'charset' => 'utf-8', 'direction' => 'ltr'),
214:         'de-at' => array('language' => 'German (Austria)', 'locale' => 'de_at', 'localeFallback' => 'deu', 'charset' => 'utf-8', 'direction' => 'ltr'),
215:         'de-ch' => array('language' => 'German (Swiss)', 'locale' => 'de_ch', 'localeFallback' => 'deu', 'charset' => 'utf-8', 'direction' => 'ltr'),
216:         'de-de' => array('language' => 'German (Germany)', 'locale' => 'de_de', 'localeFallback' => 'deu', 'charset' => 'utf-8', 'direction' => 'ltr'),
217:         'de-li' => array('language' => 'German (Liechtenstein)', 'locale' => 'de_li', 'localeFallback' => 'deu', 'charset' => 'utf-8', 'direction' => 'ltr'),
218:         'de-lu' => array('language' => 'German (Luxembourg)', 'locale' => 'de_lu', 'localeFallback' => 'deu', 'charset' => 'utf-8', 'direction' => 'ltr'),
219:         'el' => array('language' => 'Greek', 'locale' => 'ell', 'localeFallback' => 'ell', 'charset' => 'utf-8', 'direction' => 'ltr'),
220:         'en' => array('language' => 'English', 'locale' => 'eng', 'localeFallback' => 'eng', 'charset' => 'utf-8', 'direction' => 'ltr'),
221:         'en-au' => array('language' => 'English (Australian)', 'locale' => 'en_au', 'localeFallback' => 'eng', 'charset' => 'utf-8', 'direction' => 'ltr'),
222:         'en-bz' => array('language' => 'English (Belize)', 'locale' => 'en_bz', 'localeFallback' => 'eng', 'charset' => 'utf-8', 'direction' => 'ltr'),
223:         'en-ca' => array('language' => 'English (Canadian)', 'locale' => 'en_ca', 'localeFallback' => 'eng', 'charset' => 'utf-8', 'direction' => 'ltr'),
224:         'en-gb' => array('language' => 'English (British)', 'locale' => 'en_gb', 'localeFallback' => 'eng', 'charset' => 'utf-8', 'direction' => 'ltr'),
225:         'en-ie' => array('language' => 'English (Ireland)', 'locale' => 'en_ie', 'localeFallback' => 'eng', 'charset' => 'utf-8', 'direction' => 'ltr'),
226:         'en-jm' => array('language' => 'English (Jamaica)', 'locale' => 'en_jm', 'localeFallback' => 'eng', 'charset' => 'utf-8', 'direction' => 'ltr'),
227:         'en-nz' => array('language' => 'English (New Zealand)', 'locale' => 'en_nz', 'localeFallback' => 'eng', 'charset' => 'utf-8', 'direction' => 'ltr'),
228:         'en-tt' => array('language' => 'English (Trinidad)', 'locale' => 'en_tt', 'localeFallback' => 'eng', 'charset' => 'utf-8', 'direction' => 'ltr'),
229:         'en-us' => array('language' => 'English (United States)', 'locale' => 'en_us', 'localeFallback' => 'eng', 'charset' => 'utf-8', 'direction' => 'ltr'),
230:         'en-za' => array('language' => 'English (South Africa)', 'locale' => 'en_za', 'localeFallback' => 'eng', 'charset' => 'utf-8', 'direction' => 'ltr'),
231:         'es' => array('language' => 'Spanish (Spain - Traditional)', 'locale' => 'spa', 'localeFallback' => 'spa', 'charset' => 'utf-8', 'direction' => 'ltr'),
232:         'es-ar' => array('language' => 'Spanish (Argentina)', 'locale' => 'es_ar', 'localeFallback' => 'spa', 'charset' => 'utf-8', 'direction' => 'ltr'),
233:         'es-bo' => array('language' => 'Spanish (Bolivia)', 'locale' => 'es_bo', 'localeFallback' => 'spa', 'charset' => 'utf-8', 'direction' => 'ltr'),
234:         'es-cl' => array('language' => 'Spanish (Chile)', 'locale' => 'es_cl', 'localeFallback' => 'spa', 'charset' => 'utf-8', 'direction' => 'ltr'),
235:         'es-co' => array('language' => 'Spanish (Colombia)', 'locale' => 'es_co', 'localeFallback' => 'spa', 'charset' => 'utf-8', 'direction' => 'ltr'),
236:         'es-cr' => array('language' => 'Spanish (Costa Rica)', 'locale' => 'es_cr', 'localeFallback' => 'spa', 'charset' => 'utf-8', 'direction' => 'ltr'),
237:         'es-do' => array('language' => 'Spanish (Dominican Republic)', 'locale' => 'es_do', 'localeFallback' => 'spa', 'charset' => 'utf-8', 'direction' => 'ltr'),
238:         'es-ec' => array('language' => 'Spanish (Ecuador)', 'locale' => 'es_ec', 'localeFallback' => 'spa', 'charset' => 'utf-8', 'direction' => 'ltr'),
239:         'es-es' => array('language' => 'Spanish (Spain)', 'locale' => 'es_es', 'localeFallback' => 'spa', 'charset' => 'utf-8', 'direction' => 'ltr'),
240:         'es-gt' => array('language' => 'Spanish (Guatemala)', 'locale' => 'es_gt', 'localeFallback' => 'spa', 'charset' => 'utf-8', 'direction' => 'ltr'),
241:         'es-hn' => array('language' => 'Spanish (Honduras)', 'locale' => 'es_hn', 'localeFallback' => 'spa', 'charset' => 'utf-8', 'direction' => 'ltr'),
242:         'es-mx' => array('language' => 'Spanish (Mexican)', 'locale' => 'es_mx', 'localeFallback' => 'spa', 'charset' => 'utf-8', 'direction' => 'ltr'),
243:         'es-ni' => array('language' => 'Spanish (Nicaragua)', 'locale' => 'es_ni', 'localeFallback' => 'spa', 'charset' => 'utf-8', 'direction' => 'ltr'),
244:         'es-pa' => array('language' => 'Spanish (Panama)', 'locale' => 'es_pa', 'localeFallback' => 'spa', 'charset' => 'utf-8', 'direction' => 'ltr'),
245:         'es-pe' => array('language' => 'Spanish (Peru)', 'locale' => 'es_pe', 'localeFallback' => 'spa', 'charset' => 'utf-8', 'direction' => 'ltr'),
246:         'es-pr' => array('language' => 'Spanish (Puerto Rico)', 'locale' => 'es_pr', 'localeFallback' => 'spa', 'charset' => 'utf-8', 'direction' => 'ltr'),
247:         'es-py' => array('language' => 'Spanish (Paraguay)', 'locale' => 'es_py', 'localeFallback' => 'spa', 'charset' => 'utf-8', 'direction' => 'ltr'),
248:         'es-sv' => array('language' => 'Spanish (El Salvador)', 'locale' => 'es_sv', 'localeFallback' => 'spa', 'charset' => 'utf-8', 'direction' => 'ltr'),
249:         'es-uy' => array('language' => 'Spanish (Uruguay)', 'locale' => 'es_uy', 'localeFallback' => 'spa', 'charset' => 'utf-8', 'direction' => 'ltr'),
250:         'es-ve' => array('language' => 'Spanish (Venezuela)', 'locale' => 'es_ve', 'localeFallback' => 'spa', 'charset' => 'utf-8', 'direction' => 'ltr'),
251:         'et' => array('language' => 'Estonian', 'locale' => 'est', 'localeFallback' => 'est', 'charset' => 'utf-8', 'direction' => 'ltr'),
252:         'et-ee' => array('language' => 'Estonian (Estonia)', 'locale' => 'et_ee', 'localeFallback' => 'est', 'charset' => 'utf-8', 'direction' => 'ltr'),
253:         'eu' => array('language' => 'Basque', 'locale' => 'eus', 'localeFallback' => 'eus', 'charset' => 'utf-8', 'direction' => 'ltr'),
254:         'fa' => array('language' => 'Farsi', 'locale' => 'fas', 'localeFallback' => 'fas', 'charset' => 'utf-8', 'direction' => 'rtl'),
255:         'fi' => array('language' => 'Finnish', 'locale' => 'fin', 'localeFallback' => 'fin', 'charset' => 'utf-8', 'direction' => 'ltr'),
256:         'fi-fi' => array('language' => 'Finnish (Finland)', 'locale' => 'fi_fi', 'localeFallback' => 'fin', 'charset' => 'utf-8', 'direction' => 'ltr'),
257:         'fo' => array('language' => 'Faeroese', 'locale' => 'fao', 'localeFallback' => 'fao', 'charset' => 'utf-8', 'direction' => 'ltr'),
258:         'fr' => array('language' => 'French (Standard)', 'locale' => 'fra', 'localeFallback' => 'fra', 'charset' => 'utf-8', 'direction' => 'ltr'),
259:         'fr-be' => array('language' => 'French (Belgium)', 'locale' => 'fr_be', 'localeFallback' => 'fra', 'charset' => 'utf-8', 'direction' => 'ltr'),
260:         'fr-ca' => array('language' => 'French (Canadian)', 'locale' => 'fr_ca', 'localeFallback' => 'fra', 'charset' => 'utf-8', 'direction' => 'ltr'),
261:         'fr-ch' => array('language' => 'French (Swiss)', 'locale' => 'fr_ch', 'localeFallback' => 'fra', 'charset' => 'utf-8', 'direction' => 'ltr'),
262:         'fr-fr' => array('language' => 'French (France)', 'locale' => 'fr_fr', 'localeFallback' => 'fra', 'charset' => 'utf-8', 'direction' => 'ltr'),
263:         'fr-lu' => array('language' => 'French (Luxembourg)', 'locale' => 'fr_lu', 'localeFallback' => 'fra', 'charset' => 'utf-8', 'direction' => 'ltr'),
264:         'ga' => array('language' => 'Irish', 'locale' => 'gle', 'localeFallback' => 'gle', 'charset' => 'utf-8', 'direction' => 'ltr'),
265:         'gd' => array('language' => 'Gaelic (Scots)', 'locale' => 'gla', 'localeFallback' => 'gla', 'charset' => 'utf-8', 'direction' => 'ltr'),
266:         'gd-ie' => array('language' => 'Gaelic (Irish)', 'locale' => 'gd_ie', 'localeFallback' => 'gla', 'charset' => 'utf-8', 'direction' => 'ltr'),
267:         'gl' => array('language' => 'Galician', 'locale' => 'glg', 'localeFallback' => 'glg', 'charset' => 'utf-8', 'direction' => 'ltr'),
268:         'he' => array('language' => 'Hebrew', 'locale' => 'heb', 'localeFallback' => 'heb', 'charset' => 'utf-8', 'direction' => 'rtl'),
269:         'hi' => array('language' => 'Hindi', 'locale' => 'hin', 'localeFallback' => 'hin', 'charset' => 'utf-8', 'direction' => 'ltr'),
270:         'hr' => array('language' => 'Croatian', 'locale' => 'hrv', 'localeFallback' => 'hrv', 'charset' => 'utf-8', 'direction' => 'ltr'),
271:         'hu' => array('language' => 'Hungarian', 'locale' => 'hun', 'localeFallback' => 'hun', 'charset' => 'utf-8', 'direction' => 'ltr'),
272:         'hy' => array('language' => 'Armenian - Armenia', 'locale' => 'hye', 'localeFallback' => 'hye', 'charset' => 'utf-8', 'direction' => 'ltr'),
273:         'id' => array('language' => 'Indonesian', 'locale' => 'ind', 'localeFallback' => 'ind', 'charset' => 'utf-8', 'direction' => 'ltr'),
274:         'is' => array('language' => 'Icelandic', 'locale' => 'isl', 'localeFallback' => 'isl', 'charset' => 'utf-8', 'direction' => 'ltr'),
275:         'is-is' => array('language' => 'Icelandic (Iceland)', 'locale' => 'is_is', 'localeFallback' => 'isl', 'charset' => 'utf-8', 'direction' => 'ltr'),
276:         'it' => array('language' => 'Italian', 'locale' => 'ita', 'localeFallback' => 'ita', 'charset' => 'utf-8', 'direction' => 'ltr'),
277:         'it-ch' => array('language' => 'Italian (Swiss) ', 'locale' => 'it_ch', 'localeFallback' => 'ita', 'charset' => 'utf-8', 'direction' => 'ltr'),
278:         'ja' => array('language' => 'Japanese', 'locale' => 'jpn', 'localeFallback' => 'jpn', 'charset' => 'utf-8', 'direction' => 'ltr'),
279:         'kk' => array('language' => 'Kazakh', 'locale' => 'kaz', 'localeFallback' => 'kaz', 'charset' => 'utf-8', 'direction' => 'ltr'),
280:         'kl' => array('language' => 'Kalaallisut (Greenlandic)', 'locale' => 'kal', 'localeFallback' => 'kal', 'charset' => 'kl', 'direction' => 'ltr'),
281:         'kl-gl' => array('language' => 'Kalaallisut (Greenland)', 'locale' => 'kl_gl', 'localeFallback' => 'kal', 'charset' => 'kl', 'direction' => 'ltr'),
282:         'ko' => array('language' => 'Korean', 'locale' => 'kor', 'localeFallback' => 'kor', 'charset' => 'kr', 'direction' => 'ltr'),
283:         'ko-kp' => array('language' => 'Korea (North)', 'locale' => 'ko_kp', 'localeFallback' => 'kor', 'charset' => 'kr', 'direction' => 'ltr'),
284:         'ko-kr' => array('language' => 'Korea (South)', 'locale' => 'ko_kr', 'localeFallback' => 'kor', 'charset' => 'kr', 'direction' => 'ltr'),
285:         'koi8-r' => array('language' => 'Russian', 'locale' => 'koi8_r', 'localeFallback' => 'rus', 'charset' => 'koi8-r', 'direction' => 'ltr'),
286:         'li' => array('language' => 'Limburgish', 'locale' => 'lim', 'localeFallback' => 'nld', 'charset' => 'utf-8', 'direction' => 'ltr'),
287:         'lt' => array('language' => 'Lithuanian', 'locale' => 'lit', 'localeFallback' => 'lit', 'charset' => 'utf-8', 'direction' => 'ltr'),
288:         'lv' => array('language' => 'Latvian', 'locale' => 'lav', 'localeFallback' => 'lav', 'charset' => 'utf-8', 'direction' => 'ltr'),
289:         'mk' => array('language' => 'FYRO Macedonian', 'locale' => 'mkd', 'localeFallback' => 'mkd', 'charset' => 'utf-8', 'direction' => 'ltr'),
290:         'mk-mk' => array('language' => 'Macedonian', 'locale' => 'mk_mk', 'localeFallback' => 'mkd', 'charset' => 'utf-8', 'direction' => 'ltr'),
291:         'ms' => array('language' => 'Malaysian', 'locale' => 'msa', 'localeFallback' => 'msa', 'charset' => 'utf-8', 'direction' => 'ltr'),
292:         'mt' => array('language' => 'Maltese', 'locale' => 'mlt', 'localeFallback' => 'mlt', 'charset' => 'utf-8', 'direction' => 'ltr'),
293:         'nb' => array('language' => 'Norwegian Bokmal', 'locale' => 'nob', 'localeFallback' => 'nor', 'charset' => 'utf-8', 'direction' => 'ltr'),
294:         'nb-no' => array('language' => 'Norwegian Bokmål (Norway)', 'locale' => 'nb_no', 'localeFallback' => 'nor', 'charset' => 'utf-8', 'direction' => 'ltr'),
295:         'nl' => array('language' => 'Dutch (Standard)', 'locale' => 'nld', 'localeFallback' => 'nld', 'charset' => 'utf-8', 'direction' => 'ltr'),
296:         'nl-be' => array('language' => 'Dutch (Belgium)', 'locale' => 'nl_be', 'localeFallback' => 'nld', 'charset' => 'utf-8', 'direction' => 'ltr'),
297:         'nl-nl' => array('language' => 'Dutch (Netherlands)', 'locale' => 'nl_nl', 'localeFallback' => 'nld', 'charset' => 'utf-8', 'direction' => 'ltr'),
298:         'nn' => array('language' => 'Norwegian Nynorsk', 'locale' => 'nno', 'localeFallback' => 'nor', 'charset' => 'utf-8', 'direction' => 'ltr'),
299:         'nn-no' => array('language' => 'Norwegian Nynorsk (Norway)', 'locale' => 'nn_no', 'localeFallback' => 'nor', 'charset' => 'utf-8', 'direction' => 'ltr'),
300:         'no' => array('language' => 'Norwegian', 'locale' => 'nor', 'localeFallback' => 'nor', 'charset' => 'utf-8', 'direction' => 'ltr'),
301:         'pl' => array('language' => 'Polish', 'locale' => 'pol', 'localeFallback' => 'pol', 'charset' => 'utf-8', 'direction' => 'ltr'),
302:         'pt' => array('language' => 'Portuguese (Portugal)', 'locale' => 'por', 'localeFallback' => 'por', 'charset' => 'utf-8', 'direction' => 'ltr'),
303:         'pt-br' => array('language' => 'Portuguese (Brazil)', 'locale' => 'pt_br', 'localeFallback' => 'por', 'charset' => 'utf-8', 'direction' => 'ltr'),
304:         'rm' => array('language' => 'Rhaeto-Romanic', 'locale' => 'roh', 'localeFallback' => 'roh', 'charset' => 'utf-8', 'direction' => 'ltr'),
305:         'ro' => array('language' => 'Romanian', 'locale' => 'ron', 'localeFallback' => 'ron', 'charset' => 'utf-8', 'direction' => 'ltr'),
306:         'ro-mo' => array('language' => 'Romanian (Moldavia)', 'locale' => 'ro_mo', 'localeFallback' => 'ron', 'charset' => 'utf-8', 'direction' => 'ltr'),
307:         'ro-ro' => array('language' => 'Romanian (Romania)', 'locale' => 'ro_ro', 'localeFallback' => 'ron', 'charset' => 'utf-8', 'direction' => 'ltr'),
308:         'ru' => array('language' => 'Russian', 'locale' => 'rus', 'localeFallback' => 'rus', 'charset' => 'utf-8', 'direction' => 'ltr'),
309:         'ru-mo' => array('language' => 'Russian (Moldavia)', 'locale' => 'ru_mo', 'localeFallback' => 'rus', 'charset' => 'utf-8', 'direction' => 'ltr'),
310:         'sb' => array('language' => 'Sorbian', 'locale' => 'wen', 'localeFallback' => 'wen', 'charset' => 'utf-8', 'direction' => 'ltr'),
311:         'sk' => array('language' => 'Slovak', 'locale' => 'slk', 'localeFallback' => 'slk', 'charset' => 'utf-8', 'direction' => 'ltr'),
312:         'sl' => array('language' => 'Slovenian', 'locale' => 'slv', 'localeFallback' => 'slv', 'charset' => 'utf-8', 'direction' => 'ltr'),
313:         'sq' => array('language' => 'Albanian', 'locale' => 'sqi', 'localeFallback' => 'sqi', 'charset' => 'utf-8', 'direction' => 'ltr'),
314:         'sr' => array('language' => 'Serbian', 'locale' => 'srp', 'localeFallback' => 'srp', 'charset' => 'utf-8', 'direction' => 'ltr'),
315:         'sv' => array('language' => 'Swedish', 'locale' => 'swe', 'localeFallback' => 'swe', 'charset' => 'utf-8', 'direction' => 'ltr'),
316:         'sv-se' => array('language' => 'Swedish (Sweden)', 'locale' => 'sv_se', 'localeFallback' => 'swe', 'charset' => 'utf-8', 'direction' => 'ltr'),
317:         'sv-fi' => array('language' => 'Swedish (Finland)', 'locale' => 'sv_fi', 'localeFallback' => 'swe', 'charset' => 'utf-8', 'direction' => 'ltr'),
318:         'se' => array('language' => 'Sami', 'locale' => 'sme', 'localeFallback' => 'sme', 'charset' => 'utf-8', 'direction' => 'ltr'),
319:         'th' => array('language' => 'Thai', 'locale' => 'tha', 'localeFallback' => 'tha', 'charset' => 'utf-8', 'direction' => 'ltr'),
320:         'tn' => array('language' => 'Tswana', 'locale' => 'tsn', 'localeFallback' => 'tsn', 'charset' => 'utf-8', 'direction' => 'ltr'),
321:         'tr' => array('language' => 'Turkish', 'locale' => 'tur', 'localeFallback' => 'tur', 'charset' => 'utf-8', 'direction' => 'ltr'),
322:         'ts' => array('language' => 'Tsonga', 'locale' => 'tso', 'localeFallback' => 'tso', 'charset' => 'utf-8', 'direction' => 'ltr'),
323:         'uk' => array('language' => 'Ukrainian', 'locale' => 'ukr', 'localeFallback' => 'ukr', 'charset' => 'utf-8', 'direction' => 'ltr'),
324:         'ur' => array('language' => 'Urdu', 'locale' => 'urd', 'localeFallback' => 'urd', 'charset' => 'utf-8', 'direction' => 'rtl'),
325:         've' => array('language' => 'Venda', 'locale' => 'ven', 'localeFallback' => 'ven', 'charset' => 'utf-8', 'direction' => 'ltr'),
326:         'vi' => array('language' => 'Vietnamese', 'locale' => 'vie', 'localeFallback' => 'vie', 'charset' => 'utf-8', 'direction' => 'ltr'),
327:         'cy' => array('language' => 'Welsh', 'locale' => 'cym', 'localeFallback' => 'cym', 'charset' => 'utf-8', 'direction' => 'ltr'),
328:         'xh' => array('language' => 'Xhosa', 'locale' => 'xho', 'localeFallback' => 'xho', 'charset' => 'utf-8', 'direction' => 'ltr'),
329:         'yi' => array('language' => 'Yiddish', 'locale' => 'yid', 'localeFallback' => 'yid', 'charset' => 'utf-8', 'direction' => 'ltr'),
330:         'zh' => array('language' => 'Chinese', 'locale' => 'zho', 'localeFallback' => 'zho', 'charset' => 'utf-8', 'direction' => 'ltr'),
331:         'zh-cn' => array('language' => 'Chinese (PRC)', 'locale' => 'zh_cn', 'localeFallback' => 'zho', 'charset' => 'GB2312', 'direction' => 'ltr'),
332:         'zh-hk' => array('language' => 'Chinese (Hong Kong)', 'locale' => 'zh_hk', 'localeFallback' => 'zho', 'charset' => 'utf-8', 'direction' => 'ltr'),
333:         'zh-sg' => array('language' => 'Chinese (Singapore)', 'locale' => 'zh_sg', 'localeFallback' => 'zho', 'charset' => 'utf-8', 'direction' => 'ltr'),
334:         'zh-tw' => array('language' => 'Chinese (Taiwan)', 'locale' => 'zh_tw', 'localeFallback' => 'zho', 'charset' => 'utf-8', 'direction' => 'ltr'),
335:         'zu' => array('language' => 'Zulu', 'locale' => 'zul', 'localeFallback' => 'zul', 'charset' => 'utf-8', 'direction' => 'ltr')
336:     );
337: 
338: /**
339:  * Class constructor
340:  */
341:     public function __construct() {
342:         if (defined('DEFAULT_LANGUAGE')) {
343:             $this->default = DEFAULT_LANGUAGE;
344:         }
345:         $default = Configure::read('Config.language');
346:         if ($default) {
347:             $this->default = $default;
348:         }
349:     }
350: 
351: /**
352:  * Gets the settings for $language.
353:  * If $language is null it attempt to get settings from L10n::_autoLanguage(); if this fails
354:  * the method will get the settings from L10n::_setLanguage();
355:  *
356:  * @param string $language Language (if null will use DEFAULT_LANGUAGE if defined)
357:  * @return mixed
358:  */
359:     public function get($language = null) {
360:         if ($language !== null) {
361:             return $this->_setLanguage($language);
362:         }
363: 
364:         if (!$this->_autoLanguage()) {
365:             $this->_setLanguage();
366:         }
367:         return $this->lang;
368:     }
369: 
370: /**
371:  * Sets the class vars to correct values for $language.
372:  * If $language is null it will use the L10n::$default if defined
373:  *
374:  * @param string $language Language (if null will use L10n::$default if defined)
375:  * @return mixed
376:  */
377:     protected function _setLanguage($language = null) {
378:         $catalog = false;
379:         if ($language !== null) {
380:             $catalog = $this->catalog($language);
381:         }
382: 
383:         if (!$catalog && $this->default) {
384:             $language = $this->default;
385:             $catalog = $this->catalog($language);
386:         }
387: 
388:         if ($catalog) {
389:             $this->language = $catalog['language'];
390:             $this->languagePath = array_unique(array(
391:                 $catalog['locale'],
392:                 $catalog['localeFallback']
393:             ));
394:             $this->lang = $language;
395:             $this->locale = $catalog['locale'];
396:             $this->charset = $catalog['charset'];
397:             $this->direction = $catalog['direction'];
398:         } elseif ($language) {
399:             $this->lang = $language;
400:             $this->languagePath = array($language);
401:         }
402: 
403:         if ($this->default && $language !== $this->default) {
404:             $catalog = $this->catalog($this->default);
405:             $fallback = $catalog['localeFallback'];
406:             if (!in_array($fallback, $this->languagePath)) {
407:                 $this->languagePath[] = $fallback;
408:             }
409:         }
410: 
411:         if (Configure::read('Config.language') === null) {
412:             Configure::write('Config.language', $this->lang);
413:         }
414: 
415:         if ($language) {
416:             return $language;
417:         }
418:     }
419: 
420: /**
421:  * Attempts to find the locale settings based on the HTTP_ACCEPT_LANGUAGE variable
422:  *
423:  * @return bool Success
424:  */
425:     protected function _autoLanguage() {
426:         $_detectableLanguages = CakeRequest::acceptLanguage();
427:         foreach ($_detectableLanguages as $langKey) {
428:             if (isset($this->_l10nCatalog[$langKey])) {
429:                 $this->_setLanguage($langKey);
430:                 return true;
431:             }
432:             if (strpos($langKey, '-') !== false) {
433:                 $langKey = substr($langKey, 0, 2);
434:                 if (isset($this->_l10nCatalog[$langKey])) {
435:                     $this->_setLanguage($langKey);
436:                     return true;
437:                 }
438:             }
439:         }
440:         return false;
441:     }
442: 
443: /**
444:  * Attempts to find locale for language, or language for locale
445:  *
446:  * @param string|array $mixed 2/3 char string (language/locale), array of those strings, or null
447:  * @return string|array|bool string language/locale, array of those values, whole map as an array,
448:  *    or false when language/locale doesn't exist
449:  */
450:     public function map($mixed = null) {
451:         if (is_array($mixed)) {
452:             $result = array();
453:             foreach ($mixed as $_mixed) {
454:                 if ($_result = $this->map($_mixed)) {
455:                     $result[$_mixed] = $_result;
456:                 }
457:             }
458:             return $result;
459:         }
460:         if (is_string($mixed)) {
461:             if (strlen($mixed) === 2 && in_array($mixed, $this->_l10nMap)) {
462:                 return array_search($mixed, $this->_l10nMap);
463:             }
464:             if (isset($this->_l10nMap[$mixed])) {
465:                 return $this->_l10nMap[$mixed];
466:             }
467:             return false;
468:         }
469:         return $this->_l10nMap;
470:     }
471: 
472: /**
473:  * Attempts to find catalog record for requested language
474:  *
475:  * @param string|array $language string requested language, array of requested languages, or null for whole catalog
476:  * @return array|bool array catalog record for requested language, array of catalog records, whole catalog,
477:  *    or false when language doesn't exist
478:  */
479:     public function catalog($language = null) {
480:         if (is_array($language)) {
481:             $result = array();
482:             foreach ($language as $_language) {
483:                 if ($_result = $this->catalog($_language)) {
484:                     $result[$_language] = $_result;
485:                 }
486:             }
487:             return $result;
488:         }
489:         if (is_string($language)) {
490:             if (isset($this->_l10nCatalog[$language])) {
491:                 return $this->_l10nCatalog[$language];
492:             }
493:             if (isset($this->_l10nMap[$language]) && isset($this->_l10nCatalog[$this->_l10nMap[$language]])) {
494:                 return $this->_l10nCatalog[$this->_l10nMap[$language]];
495:             }
496:             return false;
497:         }
498:         return $this->_l10nCatalog;
499:     }
500: 
501: }
502: