LanguageCode Class Reference

Methods for dealing with language codes. More...

Static Public Member Functions
static	bcp47 ( $code)
	Get the normalised IETF language tag See unit test for examples.
static	getDeprecatedCodeMapping ()
	Returns a mapping of deprecated language codes that were used in previous versions of MediaWiki to up-to-date, current language codes.
static	getNonstandardLanguageCodeMapping ()
	Returns a mapping of non-standard language codes used by (current and previous version of) MediaWiki, mapped to standard BCP 47 names.
static	isWellFormedLanguageTag (string $code, bool $lenient=false)
	Returns true if a language code string is a well-formed language tag according to RFC 5646.
static	replaceDeprecatedCodes ( $code)
	Replace deprecated language codes that were used in previous versions of MediaWiki to up-to-date, current language codes.

Detailed Description

Methods for dealing with language codes.

Since

1.29

Definition at line 27 of file LanguageCode.php.

Member Function Documentation

bcp47()

static LanguageCode::bcp47 ( $code )

static

Get the normalised IETF language tag See unit test for examples.

See mediawiki.language.bcp47 for the JavaScript implementation.

Parameters

string

$code

The language code.

Returns

string A language code complying with BCP 47 standards.

Since

1.31

Definition at line 175 of file LanguageCode.php.

getDeprecatedCodeMapping()

static LanguageCode::getDeprecatedCodeMapping ( )

static

Returns a mapping of deprecated language codes that were used in previous versions of MediaWiki to up-to-date, current language codes.

This array is merged into $wgDummyLanguageCodes in Setup.php, along with the fake language codes 'qqq' and 'qqx', which are used internally by MediaWiki's localisation system.

Returns

string[]

Since

1.29

Definition at line 124 of file LanguageCode.php.

getNonstandardLanguageCodeMapping()

static LanguageCode::getNonstandardLanguageCodeMapping ( )

static

Returns a mapping of non-standard language codes used by (current and previous version of) MediaWiki, mapped to standard BCP 47 names.

This array is exported to JavaScript to ensure mediawiki.language.bcp47 stays in sync with LanguageCode::bcp47().

Returns

string[]

Since

1.32

Definition at line 140 of file LanguageCode.php.

isWellFormedLanguageTag()

static LanguageCode::isWellFormedLanguageTag ( string $code, bool $lenient = false )

static

Returns true if a language code string is a well-formed language tag according to RFC 5646.

This function only checks well-formedness; it doesn't check that language, script or variant codes actually exist in the repositories.

Based on regexes by Mark Davis of the Unicode Consortium: https://github.com/unicode-org/icu/blob/37e295627156bc334e1f1e88807025fac984da0e/icu4j/main/tests/translit/src/com/ibm/icu/dev/test/translit/langtagRegex.txt

Parameters

string	$code
bool	$lenient	Whether to allow '_' as separator. The default is only '-'.

Returns

bool

Since

1.39

Definition at line 216 of file LanguageCode.php.

replaceDeprecatedCodes()

static LanguageCode::replaceDeprecatedCodes ( $code )

static

Replace deprecated language codes that were used in previous versions of MediaWiki to up-to-date, current language codes.

Other values will returned unchanged.

Parameters

string

$code

Old language code

Returns

string New language code

Since

1.30

Definition at line 161 of file LanguageCode.php.

---

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

• includes/language/LanguageCode.php