X-Git-Url: http://git.heureux-cyclage.org/?a=blobdiff_plain;f=languages%2FLanguageCode.php;h=f50c55fe765d90de964ac630e2e06a5d90adcc4f;hb=0e052c816b21e38096d4c6d747a9beadb9d0d575;hp=7c9da77ba616309172cdf4ff7bc332ae4393fc1a;hpb=6d3217b2c6801324f17763cba5a23fb231852fba;p=lhc%2Fweb%2Fwiklou.git

diff --git a/languages/LanguageCode.php b/languages/LanguageCode.php
index 7c9da77ba6..f50c55fe76 100644
--- a/languages/LanguageCode.php
+++ b/languages/LanguageCode.php
@@ -27,6 +27,27 @@
  * @ingroup Language
  */
 class LanguageCode {
+	/**
+	 * Mapping of deprecated language codes that were used in previous
+	 * versions of MediaWiki to up-to-date, current language codes.
+	 *
+	 * @var array Mapping from language code to language code
+	 *
+	 * @since 1.30
+	 */
+	private static $deprecatedLanguageCodeMapping = [
+		// Note that als is actually a valid ISO 639 code (Tosk Albanian), but it
+		// was previously used in MediaWiki for Alsatian, which comes under gsw
+		'als' => 'gsw',
+		'bat-smg' => 'sgs',
+		'be-x-old' => 'be-tarask',
+		'fiu-vro' => 'vro',
+		'roa-rup' => 'rup',
+		'zh-classical' => 'lzh',
+		'zh-min-nan' => 'nan',
+		'zh-yue' => 'yue',
+	];
+
 	/**
 	 * Returns a mapping of deprecated language codes that were used in previous
 	 * versions of MediaWiki to up-to-date, current language codes.
@@ -36,19 +57,59 @@ class LanguageCode {
 	 * MediaWiki's localisation system.
 	 *
 	 * @return string[]
+	 *
+	 * @since 1.29
 	 */
 	public static function getDeprecatedCodeMapping() {
-		return [
-			// Note that als is actually a valid ISO 639 code (Tosk Albanian), but it
-			// was previously used in MediaWiki for Alsatian, which comes under gsw
-			'als' => 'gsw',
-			'bat-smg' => 'sgs',
-			'be-x-old' => 'be-tarask',
-			'fiu-vro' => 'vro',
-			'roa-rup' => 'rup',
-			'zh-classical' => 'lzh',
-			'zh-min-nan' => 'nan',
-			'zh-yue' => 'yue',
-		];
+		return self::$deprecatedLanguageCodeMapping;
+	}
+
+	/**
+	 * Replace deprecated language codes that were used in previous
+	 * versions of MediaWiki to up-to-date, current language codes.
+	 * Other values will returned unchanged.
+	 *
+	 * @param string $code Old language code
+	 * @return string New language code
+	 *
+	 * @since 1.30
+	 */
+	public static function replaceDeprecatedCodes( $code ) {
+		if ( isset( self::$deprecatedLanguageCodeMapping[$code] ) ) {
+			return self::$deprecatedLanguageCodeMapping[$code];
+		}
+		return $code;
+	}
+
+	/**
+	 * Get the normalised IETF language tag
+	 * See unit test for examples.
+	 * See mediawiki.language.bcp47 for the JavaScript implementation.
+	 *
+	 * @param string $code The language code.
+	 * @return string The language code which complying with BCP 47 standards.
+	 *
+	 * @since 1.31
+	 */
+	public static function bcp47( $code ) {
+		$codeSegment = explode( '-', $code );
+		$codeBCP = [];
+		foreach ( $codeSegment as $segNo => $seg ) {
+			// when previous segment is x, it is a private segment and should be lc
+			if ( $segNo > 0 && strtolower( $codeSegment[( $segNo - 1 )] ) == 'x' ) {
+				$codeBCP[$segNo] = strtolower( $seg );
+			// ISO 3166 country code
+			} elseif ( ( strlen( $seg ) == 2 ) && ( $segNo > 0 ) ) {
+				$codeBCP[$segNo] = strtoupper( $seg );
+			// ISO 15924 script code
+			} elseif ( ( strlen( $seg ) == 4 ) && ( $segNo > 0 ) ) {
+				$codeBCP[$segNo] = ucfirst( strtolower( $seg ) );
+			// Use lowercase for other cases
+			} else {
+				$codeBCP[$segNo] = strtolower( $seg );
+			}
+		}
+		$langCode = implode( '-', $codeBCP );
+		return $langCode;
 	}
 }