1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
|
<?php
/**
* Code for language code and name processing.
*
* @file
* @author Robert Leverington
* @license GPL-2.0-or-later
*/
/**
* Handle language code and name processing for the Babel extension, it can also
* be used by other extension which need such functionality.
*/
class BabelLanguageCodes {
private static $mapToMediaWikiCodeCache = null;
/**
* Map BCP 47 codes or old deprecated internal codes to current MediaWiki
* internal codes (which may not be standard BCP 47 codes).
*
* @param string $code Code to try and get an internal code for
* @return string|bool Language code, or false if code is not mapped
*/
private static function mapToMediaWikiCode( $code ) {
if ( !self::$mapToMediaWikiCodeCache ) {
self::$mapToMediaWikiCodeCache = [];
// Is the code a proper BCP 47 code for one of MediaWiki's nonstandard codes?
// If so, return the internal MediaWiki code.
if ( method_exists( 'LanguageCode', 'getNonstandardLanguageCodeMapping' ) ) {
$mapping = LanguageCode::getNonstandardLanguageCodeMapping();
foreach ( $mapping as $mwCode => $bcp47code ) {
// Careful, because the nonstandardlanguagecodemapping
// also maps deprecated codes to bcp-47 equivalents; we
// don't want to return a deprecated code.
self::$mapToMediaWikiCodeCache[ strtolower( $bcp47code ) ] =
LanguageCode::replaceDeprecatedCodes( $mwCode );
}
}
// Is the code one of MediaWiki's legacy fake codes? If so, return the modern
// equivalent code (T101086)
if ( method_exists( 'LanguageCode', 'getDeprecatedCodeMapping' ) ) {
$mapping = LanguageCode::getDeprecatedCodeMapping();
foreach ( $mapping as $deprecatedCode => $mwCode ) {
self::$mapToMediaWikiCodeCache[ strtolower( $deprecatedCode ) ] =
$mwCode;
}
}
}
return self::$mapToMediaWikiCodeCache[ strtolower( $code ) ] ?? false;
}
/**
* Takes a language code, and attempt to obtain a better variant of it,
* checks the MediaWiki language codes for a match, otherwise checks the
* internal Babel language codes (preferring ISO 639-1 over ISO 639-3) map.
*
* @param string $code Code to try and get a "better" code for.
* @return string|bool Mediawiki-internal language code, or false
* for invalid language code.
*/
public static function getCode( $code ) {
// Map BCP 47 codes and/or deprecated codes to internal MediaWiki codes
$mediawiki = self::mapToMediaWikiCode( $code );
if ( $mediawiki !== false ) {
return $mediawiki;
}
// Is the code known to MediaWiki?
$mediawiki = Language::fetchLanguageName( $code );
if ( $mediawiki !== '' ) {
return strtolower( $code );
}
// Otherwise, fall back to the ISO 639 codes database
static $isoCodes = false;
if ( !$isoCodes ) {
$isoCodes = require __DIR__ . '/../codes.php';
}
if ( isset( $isoCodes[$code] ) ) {
return $isoCodes[$code];
}
return false;
}
/**
* Take a code as input, and search a language name for it in
* a given language via Language::fetchLanguageNames() or
* else via the internal Babel language names map.
*
* @param string $code Code to get name for.
* @param string|null $language Code of language to attempt to get name in,
* defaults to language of code.
* @return string|bool Name of language, or false for invalid language code.
*/
public static function getName( $code, $language = null ) {
// Get correct code, even though it should already be correct.
$code = self::getCode( $code );
if ( $code === false ) {
return false;
}
$code = strtolower( $code );
$language = $language === null ? $code : $language;
$names = Language::fetchLanguageNames( $language, 'all' );
if ( isset( $names[$code] ) ) {
return $names[$code];
}
static $isoNames = false;
if ( !$isoNames ) {
$isoNames = require __DIR__ . '/../names.php';
}
if ( isset( $isoNames[$code] ) ) {
return $isoNames[$code];
}
return false;
}
/**
* Return an appropriate category name, given a MediaWiki-internal
* language code. MediaWiki-internal codes are all-lowercase, but
* historically our category codes have been partially uppercase
* in the style of BCP 47. Eventually we should probably use true
* BCP 47 for category names, but historically we've had internal
* codes like `simple` which we don't want to rename to `en-simple`
* quite yet.
*
* @param string $code MediaWiki-internal code.
* @return string A backwards-compatible category name for this code.
* @since 1.32
*/
public static function getCategoryCode( $code ) {
if ( strpos( $code, '-' ) !== false ) {
return LanguageCode::bcp47( $code );
}
return $code;
}
}
|
GitWeb