(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)
Locale::composeLocale -- locale_compose — Возвращает правильно упорядоченный и разделенный идентификатор локали
Объектно-ориентированный стиль
Процедурный стиль
Функция возвращает правильно упорядоченный и разделенный идентификатор локали. Ключи идентифицируют конкретные подтеги идентификатора локали, а значения — связанные значения подтегов.
subtags
Массив (array), который содержит список пар ключ-значение, где ключи — имена подтегов идентификатора локали, а значения, соответственно, значения этих подтегов.
Замечание:
Разрешается не более 15 подтегов
'variant'
и'private'
, подтегов'extlang'
не более 3 и т. д. Варианты допустимы с суффиксами от 0 до 14. Ключи для этого подтега должны называться так:variant0
,variant1
, …,variant14
. В возвращаемом идентификаторе локали вложенный тег упорядочен по суффиксу, в результате чего следуетvariant0
, за которым следуетvariant1
, за которым следуетvariant2
и так далее.В качестве альтернативы, множественные подтеги
'variant'
,'private'
и'extlang'
можно задать в виде массива под соответствующим ключом (например'variant'
). Тогда ограничения на количество распознанных вложенных тегов не применяются.
Функция возвращает соответствующий идентификатор локали или false
,
если параметр subtags
не задали.
Пример #1 Пример использования функции locale_compose()
<?php
$arr = array(
'language'=>'en',
'script' =>'Hans',
'region' =>'CN',
'variant2'=>'rozaj',
'variant1'=>'nedis',
'private1'=>'prv1',
'private2'=>'prv2',
);
echo locale_compose($arr);
?>
Пример #2 Пример использования в объектно-ориентированном стиле
<?php
$arr = array(
'language'=>'en' ,
'script' =>'Hans',
'region' =>'CN',
'variant2'=>'rozaj',
'variant1'=>'nedis',
'private1'=>'prv1',
'private2'=>'prv2',
);
echo Locale::composeLocale($arr);
?>
Результат выполнения приведённого примера:
Locale: en_Hans_CN_nedis_rozaj_x_prv1_prv2
Пример #3 Пределы подтегов
Если параметр subtags
задали как отдельные ключи с числовым суффиксом,
неподдерживаемые ключи игнорируются (в этом случае 'extlang3'
)
и упорядочиваются в результате по числовому суффиксу.
Ограничений нет, если подтеги задали в виде массива (array); порядок такой, как задали.
<?php
$arr = array(
'language' => 'en',
'script' => 'Hans',
'region' => 'CN',
'extlang3' => 'd',
'extlang2' => 'c',
'extlang1' => 'b',
'extlang0' => 'a',
);
echo locale_compose($arr), PHP_EOL;
$arr = array(
'language' => 'en',
'script' => 'Hans',
'region' => 'CN',
'extlang' => ['a', 'b', 'c', 'd'],
);
echo locale_compose($arr), PHP_EOL;
?>
Результат выполнения приведённого примера:
en_a_b_c_Hans_CN en_a_b_c_d_Hans_CN