Aller au contenu

setlocale()

La fonction PHP setlocale() définit les informations de localisation actuelles pour un script. Elle est utile pour adapter la sortie à différentes langues et conventions culturelles.

Syntaxe PHP de setlocale()

php
string setlocale ( int $category , string $locale [, string ...$locales ] )

La fonction accepte les paramètres suivants :

  • $category : Spécifie la catégorie de localisation à définir. Les constantes courantes incluent LC_ALL (toutes les catégories), LC_COLLATE (comparaison de chaînes), LC_CTYPE (classification des caractères) et LC_TIME (formatage des dates/heures).
  • $locale : Spécifie la chaîne de localisation à appliquer.
  • ...$locales : Facultatif. Permet de spécifier plusieurs chaînes de localisation. PHP les essayera dans l'ordre jusqu'à ce que l'une d'elles réussisse.

Exemple de PHP setlocale()

php
<?php
$result = setlocale(LC_ALL, 'en_US.utf8');
if ($result !== false) {
    echo "Locale set successfully to: $result";
} else {
    echo "Failed to set locale.";
}
?>

Dans cet exemple, setlocale() tente de définir la localisation sur l'anglais (États-Unis) avec l'encodage UTF-8. La fonction renvoie la nouvelle chaîne de localisation en cas de succès, ou false en cas d'échec. La vérification de la valeur de retour garantit que la localisation a été appliquée correctement.

La fonction setlocale() est un outil utile pour adapter les scripts PHP à différentes langues et conventions culturelles. Elle affecte diverses opérations, notamment les comparaisons de chaînes, le formatage des nombres et l'affichage des dates/heures.

Pratique

Quelle est l'utilité de la fonction setlocale() en PHP ?

Trouvez-vous cela utile?

Aperçu dual-run — comparez avec les routes Symfony en production.