wikimedia/bcp-47-code

Simple interface representing languages which have a BCP 47 code

Package info

github.com/wikimedia/mediawiki-libs-Bcp47Code

Homepage

pkg:composer/wikimedia/bcp-47-code

Statistics

Installs: 228 351

Dependents: 3

Suggesters: 0

Stars: 1

v2.0.3 2026-02-13 05:50 UTC

Requires

  • php: >=8.1

Suggests

None

Provides

None

Conflicts

None

Replaces

None

GPL-2.0-or-later e089a54126ec00d095fc6619eaf52c306fb4f74e

This package is auto-updated.

Last update: 2026-06-05 06:38:07 UTC

README

👁 Latest Stable Version
👁 License

Bcp47Code

Simple interface representing languages which have a BCP 47 code.

This abstracts the details of a "language" object in MediaWiki (or your code) and exposes only the ability to convert this opaque object to an interoperable BCP 47 code, which is the standard used in HTML and HTTP.

The BCP 47 standard was originally RFC 4647, and is now maintained by the IETF based on the IANA language registry.

Additional documentation about this library can be found on mediawiki.org.

Usage

use Wikimedia\Bcp47Code\Bcp47Code;

class YourCode {
 public function generateHtml(Bcp47Code $language, $content) {
 return "<html><body lang='" . $language->toBcp47() . "'>" .
 "$content</body></html>";
 }
}

Running tests

composer install
composer test

History

This library was first introduced in MediaWiki 1.40 as a way to abstract the internal MediaWiki Language class in a way that could be used by external libraries such as [Parsoid], as well as making the interfaces between BCP 47 users (such as HTML and HTTP handlers) and core strongly typed and clear by using this opaque interface object. This avoids confusion between strings representing "MediaWiki internal language codes" (case-sensitive, usually lower-case) and strings representing "BCP 47 codes" (case-insensitive, often mixed-case).