Canoniza la cadena que representa la configuración local

# Locale::canonicalize

# locale_canonicalize

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

Locale::canonicalize -- locale_canonicalize — Canoniza la cadena que representa la configuración local

### Descripción

public static function Locale::canonicalize(string `$locale`): ?string

Convierte el string de configuración regional pasada al formato ICU.

Esto no necesariamente indica ni devuelve una configuración regional válida. Es solo una versión de la entrada que se ha estandarizado según las reglas de ICU.

El comportamiento de esta función depende de la versión de ICU que PHP esté utilizando (`INTL_ICU_VERSION`).

### Parámetros

`locale`
  String de configuración regional original.

### Valores devueltos

Cadena canonicalizada en la configuración local.

Devuelve `null` cuando la longitud de `locale` excede `INTL_MAX_LOCALE_LEN`.

### Ejemplos

Ejemplo #1 Ejemplo de locale_canonicalize()

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

Resultado del ejemplo anterior es similar a:

    en_US
    totally_NOT_VALID

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open