Paramètres régionaux non-système

Télécharger le pilote PHP

Cette section s’applique uniquement aux utilisateurs Linux et macOS, en particulier ceux qui traitent plusieurs paramètres régionaux dans leurs applications PHP.

Par défaut, Pilotes Microsoft SQL Server pour PHP prend la variable d’environnement LC_ALL définie dans le système et remplace toutes les autres catégories LC_xxx (sauf peut-être $LANG ou $LANGUAGE dans certaines circonstances), en affectant le séparateur de milliers, le caractère virgule décimale, le jeu de caractères, le mois, les noms de jours, les messages d’application tels que les messages d’erreur, le symbole monétaire, etc.

À partir de la version 5.8.0, les utilisateurs peuvent configurer les paramètres de localisation à l’aide du fichier php.ini, comme indiqué dans les exemples ci-dessous.

Définir des paramètres régionaux à l’aide du pilote SQLSRV

Ajoutez ce qui suit à la fin de votre fichier php.ini :

[sqlsrv]  
sqlsrv.SetLocaleInfo = <option>

Définir des paramètres régionaux à l’aide du pilote PDO_SQLSRV

Ajoutez ce qui suit à la fin de votre fichier php.ini :

[pdo_sqlsrv]  
pdo_sqlsrv.set_locale_info = <option>

Les valeurs suivantes peuvent déterminer l'option :

Option	Description du comportement
0	Le pilot ignore les paramètres régionaux du système.
1	Le pilote lit la variable LC_CTYPE.
2	Le pilote lit la variable LC_ALL (valeur par défaut).

La catégorie LC_CTYPE détermine les règles de gestion des caractères, qui régissent l’interprétation des séquences d’octets des caractères de données de texte, la classification des caractères et le comportement des classes de caractères. Il contrôle la reconnaissance des caractères en majuscule et en minuscule, des caractères alphabétiques et non alphabétiques et ainsi de suite.

Explication

1. Option 0 -- utilisez cette option lorsque vous ne souhaitez pas modifier les paramètres régionaux de l’application.

2. Option 1 -- permet de définir uniquement la valeur système de LC_CTYPE sans affecter les autres catégories LC_xxx.

3. Option 2 -- Utilisez LC_ALL pour remplacer toutes les catégories LC_xxx, affectant l’application php et ses extensions.

Si les paramètres régionaux d’un script PHP ne sont pas les mêmes que ceux du système, vous devrez peut-être spécifier les paramètres régionaux dans le ou les scripts PHP en appelant la fonction intégrée php setlocale.

Par exemple, si la valeur par défaut du système est en_US.UTF-8 mais que le script php utilise de_DE.UTF-8, appelez la fonction php setlocale() de manière appropriée.

Pour l’option 2, indiquez les paramètres régionaux souhaités dans vos scripts PHP uniquement s’ils sont différents de la variable LC_ALL.

Notes

Si rien n’est défini dans php.ini, la valeur par défaut actuelle consiste à remplacer tous les autres paramètres régionaux en fonction de LC_ALL, qui sera déconseillé. Dans un avenir proche, la valeur par défaut sera d’ignorer les paramètres régionaux du système. Ainsi, les utilisateurs devront modifier le fichier php.ini en conséquence s’ils souhaitent conserver le comportement actuel.

Si les pilotes sqlsrv et pdo_sqlsrv sont tous deux activés, il n’est pas recommandé de définir des options différentes pour les deux pilotes.