wikimedia / bcp-47-code
Simple interface representing languages which have a BCP 47 code
Requires
- php: >=7.4.3
Requires (Dev)
- mediawiki/mediawiki-codesniffer: 41.0.0
- mediawiki/mediawiki-phan-config: 0.12.1
- mediawiki/minus-x: 1.1.1
- ockcyp/covers-validator: 1.6.0
- php-parallel-lint/php-console-highlighter: 1.0.0
- php-parallel-lint/php-parallel-lint: 1.3.2
- phpunit/phpunit: 9.5.28
- wikimedia/update-history: 1.0.1
README
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).