• Home
• lithium
• g11n
• Locale

PHP Class lithium\g11n\Locale

In order to avoid unnecessary overhead all methods throughout the framework accepting a locale require it to be well-formed according to the structure laid out below. For assuring the correct format use Locale::canonicalize() once on the locale. However the methods within this class will also work with not-so-well-formed locales. They accept both underscores and hyphens as separators between and don't care about the case of the individual tags. The identifier used by Lithium is based in its structure upon Unicode's language identifier and is compliant to BCP 47. language[_Script][_TERRITORY][_VARIANT] - language The spoken language, here represented by an ISO 639-1 code, where not available ISO 639-3 and ISO 639-5 codes are allowed too) tag. The tag should be lower-cased and is required. - Script The tag should have its first character capitalized, all others lower-cased. The tag is optional. - TERRITORY A geographical area, here represented by an ISO 3166-1 code. Should be all upper-cased and is optional. - VARIANT Should be all upper-cased and is optional. Datei anzeigen Open project: unionofrad/lithium Class Usage Examples

Protected Properties

Property	Type	Description
$_tags	array	Properties for locale tags.

Public Methods

Method	Description
__callStatic ( string $method, array $params = [] ) : mixed	Magic method enabling language, script, territory and variant methods to parse and retrieve individual tags from a locale.
canonicalize ( string $locale ) : string	Returns a locale in its canonical form with tags formatted properly.
cascade ( string $locale ) : array	Cascades a locale.
compose ( array $tags ) : string	Composes a locale from locale tags. This is the pendant to Locale::decompose().
decompose ( string $locale ) : array	Parses a locale into locale tags. This is the pendant to Locale::compose().
lookup ( array $locales, string $locale ) : string	Searches an array of locales for the best match to a locale. The locale is iteratively simplified until either it matches one of the locales in the list or the locale can't be further simplified.
preferred ( object | array $request, array $available = null ) : string	Determines the preferred locale from a request or array. Optionally negotiates the preferred locale with available locales.
respondsTo ( string $method, boolean $internal = false ) : boolean	Determines if a given method can be called.

Protected Methods

Method	Description
_preferredAction ( Request $request ) : array	Detects preferred locales from an action request by looking at the 'Accept-Language' header as described by RFC 2616, section 14.4.
_preferredConsole ( Request $request ) : array	Detects preferred locales from a console request by looking at certain environment variables. The environment variables may be present or not depending on your system. If multiple variables are present the following hierarchy is used: 'LANGUAGE', 'LC_ALL', 'LANG'.

Method Details

Property Details