ILIAS  release_5-3 Revision v5.3.23-19-g915713cf615
Static Public Member Functions | Data Fields | Static Public Attributes | Static Private Member Functions | Static Private Attributes
Gettext\Languages\CldrData Class Reference

Holds the CLDR data. More...

+ Collaboration diagram for Gettext\Languages\CldrData:

Static Public Member Functions

static getLanguageNames ()
 Returns a dictionary containing the language names. More...
 
static getTerritoryNames ()
 Return a dictionary containing the territory names (in US English). More...
 
static getScriptNames ($standAlone)
 Return a dictionary containing the script names (in US English). More...
 
static getPlurals ()
 
static getSupersededLanguages ()
 Return a list of superseded language codes. More...
 
static getLanguageInfo ($id)
 Retrieve the name of a language, as well as if a language code is deprecated in favor of another language code. More...
 

Data Fields

const OTHER_CATEGORY = 'other'
 

Static Public Attributes

static $categories = array('zero', 'one', 'two', 'few', 'many', self::OTHER_CATEGORY)
 

Static Private Member Functions

static getData ($key)
 Returns the loaded CLDR data. More...
 

Static Private Attributes

static $data
 
static $plurals
 

Detailed Description

Holds the CLDR data.

Definition at line 9 of file CldrData.php.

Member Function Documentation

◆ getData()

static Gettext\Languages\CldrData::getData (   $key)
staticprivate

Returns the loaded CLDR data.

Parameters
string$keyCan be 'languages', 'territories', 'plurals', 'supersededLanguages', 'scripts', 'standAloneScripts'

Definition at line 30 of file CldrData.php.

References $data, Gettext\Languages\CldrData\$data, $key, $list, $m, $result, and array.

31  {
32  if (!isset(self::$data)) {
33  $fixKeys = function ($list, &$standAlone = null) {
34  $result = array();
35  $standAlone = array();
36  $match = null;
37  foreach ($list as $key => $value) {
38  $variant = '';
39  if (preg_match('/^(.+)-alt-(short|variant|stand-alone|long)$/', $key, $match)) {
40  $key = $match[1];
41  $variant = $match[2];
42  }
43  $key = str_replace('-', '_', $key);
44  switch ($key) {
45  case 'root': // Language: Root
46  case 'und': // Language: Unknown Language
47  case 'zxx': // Language: No linguistic content
48  case 'ZZ': // Territory: Unknown Region
49  case 'Zinh': // Script: Inherited
50  case 'Zmth': // Script: Mathematical Notation
51  case 'Zsym': // Script: Symbols
52  case 'Zxxx': // Script: Unwritten
53  case 'Zyyy': // Script: Common
54  case 'Zzzz': // Script: Unknown Script
55  break;
56  default:
57  switch ($variant) {
58  case 'stand-alone':
59  $standAlone[$key] = $value;
60  break;
61  case '':
62  $result[$key] = $value;
63  break;
64  }
65  break;
66  }
67  }
68 
69  return $result;
70  };
71  $data = array();
72  $json = json_decode(file_get_contents(__DIR__.'/cldr-data/main/en-US/languages.json'), true);
73  $data['languages'] = $fixKeys($json['main']['en-US']['localeDisplayNames']['languages']);
74  $json = json_decode(file_get_contents(__DIR__.'/cldr-data/main/en-US/territories.json'), true);
75  $data['territories'] = $fixKeys($json['main']['en-US']['localeDisplayNames']['territories']);
76  $json = json_decode(file_get_contents(__DIR__.'/cldr-data/supplemental/plurals.json'), true);
77  $data['plurals'] = $fixKeys($json['supplemental']['plurals-type-cardinal']);
78  $json = json_decode(file_get_contents(__DIR__.'/cldr-data/main/en-US/scripts.json'), true);
79  $data['scripts'] = $fixKeys($json['main']['en-US']['localeDisplayNames']['scripts'], $data['standAloneScripts']);
80  $data['standAloneScripts'] = array_merge($data['scripts'], $data['standAloneScripts']);
81  $data['scripts'] = array_merge($data['standAloneScripts'], $data['scripts']);
82  $data['supersededLanguages'] = array();
83  // Remove the languages for which we don't have plurals
84  $m = null;
85  foreach (array_keys(array_diff_key($data['languages'], $data['plurals'])) as $missingPlural) {
86  if (preg_match('/^([a-z]{2,3})_/', $missingPlural, $m)) {
87  if (!isset($data['plurals'][$m[1]])) {
88  unset($data['languages'][$missingPlural]);
89  }
90  } else {
91  unset($data['languages'][$missingPlural]);
92  }
93  }
94  // Fix the languages for which we have plurals
95  $formerCodes = array(
96  'in' => 'id', // former Indonesian
97  'iw' => 'he', // former Hebrew
98  'ji' => 'yi', // former Yiddish
99  'jw' => 'jv', // former Javanese
100  'mo' => 'ro_MD', // former Moldavian
101  );
102  $knownMissingLanguages = array(
103  'bh' => 'Bihari',
104  'guw' => 'Gun',
105  'nah' => 'Nahuatl',
106  'smi' => 'Sami',
107  );
108  foreach (array_keys(array_diff_key($data['plurals'], $data['languages'])) as $missingLanguage) {
109  if (isset($formerCodes[$missingLanguage]) && isset($data['languages'][$formerCodes[$missingLanguage]])) {
110  $data['languages'][$missingLanguage] = $data['languages'][$formerCodes[$missingLanguage]];
111  $data['supersededLanguages'][$missingLanguage] = $formerCodes[$missingLanguage];
112  } else {
113  if (isset($knownMissingLanguages[$missingLanguage])) {
114  $data['languages'][$missingLanguage] = $knownMissingLanguages[$missingLanguage];
115  } else {
116  throw new Exception("We have the plural rule for the language '$missingLanguage' but we don't have its language name");
117  }
118  }
119  }
120  ksort($data['languages'], SORT_STRING);
121  ksort($data['territories'], SORT_STRING);
122  ksort($data['plurals'], SORT_STRING);
123  ksort($data['scripts'], SORT_STRING);
124  ksort($data['standAloneScripts'], SORT_STRING);
125  ksort($data['supersededLanguages'], SORT_STRING);
126  self::$data = $data;
127  }
128  if (!@isset(self::$data[$key])) {
129  throw new Exception("Invalid CLDR data key: '$key'");
130  }
131 
132  return self::$data[$key];
133  }
$list
if(isset($_REQUEST['delete'])) $list
Definition: registry.php:41
$result
$result
Definition: CleanUpTest.php:463
$m
$m
Definition: show_metadata.php:25
array
Create styles array
The data for the language used.
Definition: 40duplicateStyle.php:19
$key
$key
Definition: croninfo.php:18

◆ getLanguageInfo()

static Gettext\Languages\CldrData::getLanguageInfo (   $id)
static

Retrieve the name of a language, as well as if a language code is deprecated in favor of another language code.

Parameters
string$idThe language identifier.
Returns
array|null Returns an array with the keys 'id' (normalized), 'name', 'supersededBy' (optional), 'territory' (optional), 'script' (optional), 'baseLanguage' (optional), 'categories'. If $id is not valid returns null.

Definition at line 199 of file CldrData.php.

References $id, Gettext\Languages\CldrData\$plurals, $result, and array.

Referenced by Gettext\Languages\Language\getAll(), and Gettext\Languages\Language\getById().

200  {
201  $result = null;
202  $matches = array();
203  if (preg_match('/^([a-z]{2,3})(?:[_\-]([a-z]{4}))?(?:[_\-]([a-z]{2}|[0-9]{3}))?(?:$|-)/i', $id, $matches)) {
204  $languageId = strtolower($matches[1]);
205  $scriptId = (isset($matches[2]) && ($matches[2] !== '')) ? ucfirst(strtolower($matches[2])) : null;
206  $territoryId = (isset($matches[3]) && ($matches[3] !== '')) ? strtoupper($matches[3]) : null;
207  $normalizedId = $languageId;
208  if (isset($scriptId)) {
209  $normalizedId .= '_'.$scriptId;
210  }
211  if (isset($territoryId)) {
212  $normalizedId .= '_'.$territoryId;
213  }
214  // Structure precedence: see Likely Subtags - http://www.unicode.org/reports/tr35/tr35-31/tr35.html#Likely_Subtags
215  $variants = array();
216  $variantsWithScript = array();
217  $variantsWithTerritory = array();
218  if (isset($scriptId) && isset($territoryId)) {
219  $variantsWithTerritory[] = $variantsWithScript[] = $variants[] = "{$languageId}_{$scriptId}_{$territoryId}";
220  }
221  if (isset($scriptId)) {
222  $variantsWithScript[] = $variants[] = "{$languageId}_{$scriptId}";
223  }
224  if (isset($territoryId)) {
225  $variantsWithTerritory[] = $variants[] = "{$languageId}_{$territoryId}";
226  }
227  $variants[] = $languageId;
228  $allGood = true;
229  $scriptName = null;
230  $scriptStandAloneName = null;
231  if (isset($scriptId)) {
232  $scriptNames = self::getScriptNames(false);
233  if (isset($scriptNames[$scriptId])) {
234  $scriptName = $scriptNames[$scriptId];
235  $scriptStandAloneNames = self::getScriptNames(true);
236  $scriptStandAloneName = $scriptStandAloneNames[$scriptId];
237  } else {
238  $allGood = false;
239  }
240  }
241  $territoryName = null;
242  if (isset($territoryId)) {
243  $territoryNames = self::getTerritoryNames();
244  if (isset($territoryNames[$territoryId])) {
245  if ($territoryId !== '001') {
246  $territoryName = $territoryNames[$territoryId];
247  }
248  } else {
249  $allGood = false;
250  }
251  }
252  $languageName = null;
253  $languageNames = self::getLanguageNames();
254  foreach ($variants as $variant) {
255  if (isset($languageNames[$variant])) {
256  $languageName = $languageNames[$variant];
257  if (isset($scriptName) && (!in_array($variant, $variantsWithScript))) {
258  $languageName = $scriptName.' '.$languageName;
259  }
260  if (isset($territoryName) && (!in_array($variant, $variantsWithTerritory))) {
261  $languageName .= ' ('.$territoryNames[$territoryId].')';
262  }
263  break;
264  }
265  }
266  if (!isset($languageName)) {
267  $allGood = false;
268  }
269  $baseLanguage = null;
270  if (isset($scriptId) || isset($territoryId)) {
271  if (isset($languageNames[$languageId]) && ($languageNames[$languageId] !== $languageName)) {
272  $baseLanguage = $languageNames[$languageId];
273  }
274  }
275  $plural = null;
276  $plurals = self::getPlurals();
277  foreach ($variants as $variant) {
278  if (isset($plurals[$variant])) {
279  $plural = $plurals[$variant];
280  break;
281  }
282  }
283  if (!isset($plural)) {
284  $allGood = false;
285  }
286  $supersededBy = null;
287  $supersededBys = self::getSupersededLanguages();
288  foreach ($variants as $variant) {
289  if (isset($supersededBys[$variant])) {
290  $supersededBy = $supersededBys[$variant];
291  break;
292  }
293  }
294  if ($allGood) {
295  $result = array();
296  $result['id'] = $normalizedId;
297  $result['name'] = $languageName;
298  if (isset($supersededBy)) {
299  $result['supersededBy'] = $supersededBy;
300  }
301  if (isset($scriptStandAloneName)) {
302  $result['script'] = $scriptStandAloneName;
303  }
304  if (isset($territoryName)) {
305  $result['territory'] = $territoryName;
306  }
307  if (isset($baseLanguage)) {
308  $result['baseLanguage'] = $baseLanguage;
309  }
310  $result['categories'] = $plural;
311  }
312  }
313 
314  return $result;
315  }
$result
$result
Definition: CleanUpTest.php:463
$id
if(!array_key_exists('StateId', $_REQUEST)) $id
Definition: expirywarning.php:14
array
Create styles array
The data for the language used.
Definition: 40duplicateStyle.php:19
+ Here is the caller graph for this function:

◆ getLanguageNames()

static Gettext\Languages\CldrData::getLanguageNames ( )
static

Returns a dictionary containing the language names.

The keys are the language identifiers. The values are the language names in US English.

Returns
string[]

Definition at line 140 of file CldrData.php.

Referenced by Gettext\Languages\Language\getAll().

141  {
142  return self::getData('languages');
143  }
+ Here is the caller graph for this function:

◆ getPlurals()

static Gettext\Languages\CldrData::getPlurals ( )
static

Definition at line 182 of file CldrData.php.

183  {
184  return self::getData('plurals');
185  }

◆ getScriptNames()

static Gettext\Languages\CldrData::getScriptNames (   $standAlone)
static

Return a dictionary containing the script names (in US English).

The keys are the script identifiers. The values are the script names in US English.

Parameters
bool$standAloneSet to true to retrieve the stand-alone script names, false otherwise.
Returns
string[]

Definition at line 161 of file CldrData.php.

162  {
163  return self::getData($standAlone ? 'standAloneScripts' : 'scripts');
164  }

◆ getSupersededLanguages()

static Gettext\Languages\CldrData::getSupersededLanguages ( )
static

Return a list of superseded language codes.

Returns
array Keys are the former language codes, values are the new language/locale codes.

Definition at line 190 of file CldrData.php.

191  {
192  return self::getData('supersededLanguages');
193  }

◆ getTerritoryNames()

static Gettext\Languages\CldrData::getTerritoryNames ( )
static

Return a dictionary containing the territory names (in US English).

The keys are the territory identifiers. The values are the territory names in US English.

Returns
string[]

Definition at line 150 of file CldrData.php.

151  {
152  return self::getData('territories');
153  }

Field Documentation

◆ $categories

Gettext\Languages\CldrData::$categories = array('zero', 'one', 'two', 'few', 'many', self::OTHER_CATEGORY)
static

Definition at line 20 of file CldrData.php.

Referenced by Gettext\Languages\Category\__construct(), and Gettext\Languages\Language\__construct().

◆ $data

Gettext\Languages\CldrData::$data
staticprivate

Definition at line 25 of file CldrData.php.

Referenced by Gettext\Languages\CldrData\getData().

◆ $plurals

Gettext\Languages\CldrData::$plurals
staticprivate

Definition at line 168 of file CldrData.php.

Referenced by Gettext\Languages\CldrData\getLanguageInfo().

◆ OTHER_CATEGORY

const Gettext\Languages\CldrData::OTHER_CATEGORY = 'other'

Definition at line 15 of file CldrData.php.

Referenced by Gettext\Languages\Category\__construct(), Gettext\Languages\Language\__construct(), Gettext\Languages\Language\checkAllCategoriesWithExamples(), and Gettext\Languages\Language\checkAlwaysTrueCategories().

The documentation for this class was generated from the following file: