# Locale::canonicalize

# locale_canonicalize

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

Locale::canonicalize -- locale_canonicalize — Canonicalize the locale string

### 说明

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

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`).

### 参数

`locale`
  Original locale string.

### 返回值

Canonicalized locale string.

当 `locale` 的长度超过 `INTL_MAX_LOCALE_LEN` 时返回 `null`。

### 示例

示例 #1 locale_canonicalize() example

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

以上示例的输出类似于：

    en_US
    totally_NOT_VALID

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