CakePHP
  • Documentation
    • Book
    • API
    • Videos
    • Reporting Security Issues
    • Privacy Policy
    • Logos & Trademarks
  • Business Solutions
  • Swag
  • Road Trip
  • Team
  • Community
    • Community
    • Get Involved
    • Issues (GitHub)
    • Bakery
    • Featured Resources
    • Training
    • Meetups
    • My CakePHP
    • CakeFest
    • Newsletter
    • Linkedin
    • YouTube
    • Facebook
    • Twitter
    • Mastodon
    • Help & Support
    • Forum
    • Stack Overflow
    • Slack
    • Paid Support
CakePHP

C CakePHP 2.0 API

  • Overview
  • Tree
  • Deprecated
  • Version:
    • 2.0
      • 4.2
      • 4.1
      • 4.0
      • 3.9
      • 3.8
      • 3.7
      • 3.6
      • 3.5
      • 3.4
      • 3.3
      • 3.2
      • 3.1
      • 3.0
      • 2.10
      • 2.9
      • 2.8
      • 2.7
      • 2.6
      • 2.5
      • 2.4
      • 2.3
      • 2.2
      • 2.1
      • 2.0
      • 1.3
      • 1.2

Packages

  • Cake
    • Cache
      • Engine
    • Configure
    • Console
      • Command
        • Task
    • Controller
      • Component
        • Auth
    • Core
    • Error
    • I18n
    • Log
      • Engine
    • Model
      • Behavior
      • Datasource
        • Database
        • Session
    • Network
      • Email
      • Http
    • Routing
      • Route
    • TestSuite
      • Coverage
      • Fixture
      • Reporter
    • Utility
    • View
      • Helper

Classes

  • I18n
  • L10n
  • Multibyte

Functions

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

Generated using CakePHP API Docs