setlocale
(PHP 4, PHP 5, PHP 7, PHP 8)
setlocale - Встановлює налаштування локалі
Опис
setlocale(int $category, string $locales, string ...$rest): string|false
Альтернативна сигнатура (не підтримується з іменованими аргументами):
setlocale(int $category, array $locale_array): string|false
Встановлює налаштування локалі.
Увага
Інформація про локаль модифікується у всьому процесі, а не по кожному потоку окремо. Якщо ви використовуєте PHP на багатопотоковому сервері, ви можете виявити несподівані зміни в налаштуваннях локалі під час виконання скриптів, які ніколи не викликали. setlocale(). Це відбувається через те, що інші скрипти, запущені в паралельних потоках даного процесу, в той же час змінили налаштування локалі для всього процесу за допомогою setlocale(). У Windows інформація про локаль підтримується для кожного потоку, починаючи з PHP 7.0.5.
Список параметрів
category
Параметрcategory - це іменована константа, що визначає категорію функцій, на які впливатиме встановлення локалі:
- **
LC_ALL**- все нижчеперелічене - **
LC_COLLATE**- функції порівняння рядків, дивітьсяstrcoll() - **
LC_CTYPE**- функції перетворення та класифікації рядків, наприкладctype_alpha() - **
LC_MONETARY**- для функціїlocaleconv() - **
LC_NUMERIC**- задає символ десяткового поділу (дивіться такожlocaleconv()) . - **
LC_TIME**- форматування дати/часу функцієюstrftime() - **
LC_MESSAGES**- для системних повідомлень (доступна, якщо PHP був скомпільований з підтримкоюlibintl) .
locales
Якщо як localesпередана пустая строка""или**null**, імена локалей будуть взяті з однойменних змінних оточення або змінної з іменем "LANG".
Якщо як localesпередан"0", локаль змінено не буде, а буде повернено поточне значення.
Якщо як locales передано масив, або після цього аргументу випливають додаткові аргументи, функція буде використовувати елементи масиву або аргументи по порядку як імена локалі до тих пір, поки установка локалі не буде успішною. Це зручно, якщо одна й та сама локаль має різне ім'я в різних системах, або для створення запасного варіанту за відсутності будь-якої локалі в системі.
rest
Необов'язкові аргументи у вигляді рядків або масивів для встановлення налаштувань локалі до першої успішної спроби.
locale_array
Кожен елемент масиву намагається встановити новий локаль до першої успішної спроби. Це корисно, якщо локаль відома під різними іменами в різних системах або для забезпечення запасного варіанту можливо недоступного мовного стандарту.
Зауваження :
На Windows setlocale(LC_ALL, '') встановлює імена локалів із системних регіональних/мовних налаштувань (доступних через Панель Управління).
Значення, що повертаються
Повертає ім'я нововстановленої локалі або false, якщо система не підтримує встановлення локалі, зазначена локаль не існує або передано неприпустиме ім'я категорії.
Неприпустиме ім'я категорії також викликає попередження. Імена локалей та категорій описані в » RFC 1766 і » ISO 639. Різні системи мають різноманітні схеми іменування локалей.
Зауваження :
Повертається функцією setlocale() значення залежить від системи, де запущено PHP. Вона повертає те саме значення, що й системна функція
setlocale
Приклади
Приклад #1 Приклади використання setlocale()
**Приклад #2 Приклади використання **setlocale()в Windows
Примітки
Підказка
Користувачі Windows знайдуть корисну інформацію про значення locales на веб-сайті Microsoft MSDN. Підтримувані мови перераховані в » документації за мовними рядками, а значения стран/регионов в» документації по рядках країн/регіонів