Funkcja setlocale() w PHP

Przykład

Ustawienie regionu na US English, a następnie powrót do ustawień domyślnych systemowych:

<?php
echo setlocale(LC_ALL, "US");
echo "<br>";
echo setlocale(LC_ALL, NULL);
?>

Przykład uruchomienia

Definicja i użycie

Funkcja setlocale() ustawia informacje o regionie (informacje o terytorium).

Informacje o regionie dotyczą języka, waluty, czasu oraz innych informacji dla danej strefy geograficznej.

Komentarz:Funkcja setlocale() zmienia informacje o regionie tylko dla bieżącego skryptu.

Wskazówka:Można ustawić informacje o regionie na domyślne systemowe za pomocą setlocale(LC_ALL, NULL).

Wskazówka:Aby uzyskać informacje o formatach liczb, zobacz: localeconv() Funkcja.

Gramatyka

setlocale(konstanta,lokalizacja)
Parametry Opis
konstanta

Wymagane. Określa, jakie informacje o regionie należy ustawić.

Dostępne stałe:

  • LC_ALL - Obejmuje wszystkie poniższe opcje
  • LC_COLLATE - Sortowanie kolejności
  • LC_CTYPE - Kategoria znaków i konwersje (np. wszystkie znaki na duże lub małe litery)
  • LC_MESSAGES - Format komunikatów systemowych
  • LC_MONETARY - Format waluty
  • LC_NUMERIC - Format liczb
  • LC_TIME - Format daty i czasu
lokalizacja

Wymagane. Określa, który kraj/region ma być ustawiony jako informacje regionalne. Może to być ciąg lub tablica. Można przekazać wiele lokalizacji.

Jeśli lokalizacja Jeśli parametr jest NULL lub pustym ciągiem "", nazwa lokalizacji zostanie ustawiona na wartość zmiennej środowiskowej o tej samej nazwie w powyższych stałych lub na podstawie "LANG".

Jeśli lokalizacja parametr jest "0", ustawienia lokalizacji nie są wpływane, zwracana jest tylko bieżąca konfiguracja.

Jeśli lokalizacja Parametr jest tablicą, setlocale() spróbuje każdego elementu tablicy, aż znajdzie legalny kod językowy lub kod regionu. Jest to bardzo przydatne, jeśli różne regiony mają różne nazwy w różnych systemach.

Komentarz:Aby zobaczyć wszystkie dostępne kody językowe, odwiedź nasząPrzeglądarka kodów językowych.

Szczegóły techniczne

Wartość zwracana: Zwraca bieżące ustawienia regionu, jeśli zawiedzie, zwraca FALSE. Wartość zwracana zależy od systemu, w którym działa PHP.
Wersja PHP: 4+
Dziennik aktualizacji:

W PHP 4.2.0 użycie konstant jako ciągów jest przestarzałe. Proszę używać dostępnych konstant zamiast tego. Przekazywanie konstant jako ciągów wywoła ostrzeżenie.

W PHP 4.3.0 można przekazać wiele lokalizacji.

Od PHP 5.3.0, jeśli przekazywane do konstanta Parametr jest ciągłem, a nie jedną z konstant LC_, funkcja wywoła powiadomienie E_DREPRECATED.