Locale::canonicalize

locale_canonicalize

Canonicalize the locale string

public static stringnull Locale::canonicalize(string $locale)

Canonicalizes the passed locale string to ICU format.

This does not necessarily indicate or return a valid locale. It is only a version of the input that has been canonicalized according to ICU rules.

The behavior of this function depends on the version of ICU PHP is using (INTL_ICU_VERSION).

Canonicalized locale string.

Returns null when the length of locale exceeds INTL_MAX_LOCALE_LEN.

Example #1 locale_canonicalize example

echo Locale::canonicalize('en-US.utf8') . "\n";
echo Locale::canonicalize('totally-not-valid') . "\n";

The above example will output something similar to:

en_US
totally_NOT_VALID