Функция setlocale() в PHP позволяет настроить локаль, используемую для форматирования даты и времени. Это важно, когда нужно отобразить дату или время на разных языках в одном приложении.
По умолчанию PHP использует локаль, установленную на сервере. Часто это английский язык. Чтобы показать дату на русском, нужно вызвать setlocale():
Установка локали на русский язык
Для вывода даты на русском языке используем:
setlocale(LC_TIME, 'ru_RU.UTF-8');
Это установит локаль на русский язык с кодировкой UTF-8. После этого функции date() и strftime() будут возвращать дату по-русски.
Пример вывода даты на разных языках
Рассмотрим пример вывода одной и той же даты на английском и русском:
// Выводим дату по-английски echo date('j F Y'); // 7 October 2022 // Выводим дату по-русски setlocale(LC_TIME, 'ru_RU.UTF-8'); echo date('j F Y'); // 7 октября 2022
Как видно, с помощью setlocale() можно легко переключаться между локалями.
Поддержка Unicode и UTF-8
Многие локали требуют кодировку UTF-8 для корректного отображения. Поэтому после названия языка нужно указывать ".UTF-8".
Например, для украинского языка будет "uk_UA.UTF-8". Без UTF-8 символы могут отображаться некорректно.
Вывод даты в разных форматах
Функция strftime() позволяет гибко форматировать дату и время. Например, вывести время в формате "15:20":
setlocale(LC_TIME, 'ru_RU.UTF-8'); echo strftime('%H:%M');
Поддерживается множество форматов - можно выводить день недели, месяц, год, часы, минуты и секунды в любом порядке.
Вывод денежных сумм с separators
Чтобы вывести денежную сумму в правильном формате (например, 1 234,56 руб.), используйте функцию money_format():
setlocale(LC_MONETARY, 'ru_RU.UTF-8'); echo money_format('%n', 1234.56);
Форматирование валюты тоже зависит от локали. Поэтому нужно setlocale(LC_MONETARY, 'ru_RU.UTF-8').
Локализация веб-приложений
В веб-приложениях часто нужна поддержка нескольких языков. Это называется локализацией.
Можно хранить переводы в файле translations.php, а выбор языка реализовать через $_SESSION.
При этом в каждом файле в начале прописываем setlocale(LC_ALL, $_SESSION['locale']). Это позволит выводить даты и числа в правильном формате для выбранного языка.
Использование intl
Для более продвинутой локализации в PHP есть расширение intl. Оно позволяет:
- Форматировать числа, даты и валюты для нужной локали
- Сравнивать и сортировать строки по правилам языка
- Работать со строками на разных языках
intl содержит класс Locale, который упрощает работу с локалями. Но setlocale() тоже полезна для простых задач.
Региональные настройки операционной системы
Локаль, установленная в PHP с помощью setlocale(), обычно соответствует региональным настройкам операционной системы. Например, если в Windows установлен русский язык, то setlocale(LC_ALL, '') выберет русскую локаль.
Поэтому при разработке локализованных приложений нужно учитывать настройки OC пользователей. Либо задавать локаль явно в коде вне зависимости от региональных параметров.
Работа с файловой системой
При работе с файловой системой тоже важно учитывать кодировку. Если имена файлов на кириллице, то и скрипт должен использовать UTF-8.
Для этого в начале скрипта после setlocale() нужно добавить:
mb_internal_encoding('UTF-8');
Это установит кодировку по умолчанию для мультибайтовых строк в PHP.
Поддержка нескольких языков
Для приложений, которые поддерживают несколько языков, удобно хранить переводы в отдельных файлах вида:
- messages.en.php - английский
- messages.ru.php - русский
- messages.de.php - немецкий
А в коде подключать нужный файл в зависимости от выбранной локали.
include "messages.{$_SESSION['locale']}.php";
Это избавит от условий и switch в коде для выбора языка.
Локализация фронтенда
Для локализации фронтенда можно использовать JavaScript.
Библиотеки вроде i18next позволяют загружать словари с переводом через AJAX и подставлять текст на нужном языке.
Такой подход дает возможность переключать язык прямо на клиенте, без обращения к серверу.
Тестирование локализованных приложений
При тестировании локализованных приложений важно проверять:
- Корректность перевода текста
- Форматы даты и времени
- Разделители в числах и валютах
- Сортировку строк
- Кодировки при работе с файлами
Нужно тщательно тестировать приложение для каждой поддерживаемой локали и OC (Windows, Linux, MacOS).
Готовые решения
Для сложных многоязычных проектов имеет смысл использовать готовые решения, такие как:
- Плагин WPML для WordPress
- Модуль i18n для Yii2
- Библиотека laravel-localization для Laravel
Это сэкономит время и избавит от рутины при локализации крупных систем.
