Funkcja PHP setlocale() określa lokalizację dla wybranych kategorii funkcji PHP. Za jej pomocą można na przykład określić, że funkcje klasyfikacji i konwersji znaków mają działać według zasad obowiązujących w Australii itd.
Składnia funkcji PHP setlocale()
Funkcja PHP setlocale() ma następującą składnię:
setlocale( int $category, ?string $locales, string ...$rest): string|false
Dostępna jest też składnia alternatywna, która nie obsługuje argumentów nazwanych:
setlocale(int $category, array $locale_array): string|false
Parametry
| Parametr | Opis |
|---|---|
| category | Parametr obowiązkowy. Stała określająca kategorię funkcji, których dotyczy ustawienie lokalizacji. Dostępne opcje:
|
| locales | Ten parametr określa lokalizację. Sposób określania lokalizacji jest zależny od systemu. Na stronie https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c można znaleźć listę lokalizacji dla systemów Windows. Zobacz też kody nazw języków w normie ISO 639 oraz listę kodów państw wg normy ISO 3166.
|
| rest | Opcjonalne łańcuchy, które będą wypróbowywane jako nazwy lokalizacji. Zastosowany zostanie pierwszy, który będzie pasował. |
| locale_array | Elementy tej tablicy są wypróbowywane po kolei jako nazwy lokalizacji. Zostanie zastosowany pierwszy, który będzie pasował. |
Wartość zwrotna
Funkcja PHP setlocale() zwraca nowo ustawioną lokalizację lub false, jeśli na danej platformie nie jest zaimplementowana funkcjonalność lokalizacji, określona lokalizacja nie istnieje lub podano niepoprawną nazwę kategorii.
