Configuration du pilote
Cette rubrique répertorie les options de configuration pour le Pilote SQL Server pour PHP ainsi que les informations pour modifier les paramètres de configuration.
Pour extraire les paramètres de configuration actuels du pilote, utilisez la fonction sqlsrv_get_config. Pour modifier les paramètres de configuration, utilisez la fonction sqlsrv_configure ou définissez les valeurs des paramètres de configuration dans le fichier php.ini. Pour obtenir des informations sur la modification des paramètres de configuration, consultez Procédure : configurer la gestion des erreurs et des avertissements et Journalisation de l'activité.
Options de configuration
Le Pilote SQL Server pour PHP comprend trois options de configuration : LogSubsystems, LogSeverity et WarningsReturnAsErrors. Les valeurs par défaut de ces paramètres sont SQLSRV_LOG_SYSTEM_OFF, SQLSRV_LOG_SEVERITY_ERROR (après activation de la journalisation) et true (1), respectivement. Les sections suivantes décrivent ces options de configuration et leurs paramètres possibles.
Options LogSubsystems
Le paramètre LogSubsystems sert à l'activation de la journalisation pour les sous-systèmes. Le tableau suivant répertorie les valeurs possibles pour ce paramètre.
| Valeur (entier équivalent entre parenthèses) | Description |
|---|---|
SQLSRV_LOG_SYSTEM_ALL (-1) |
Active la journalisation de tous les sous-systèmes. |
SQLSRV_LOG_SYSTEM_OFF (0) |
Désactive la journalisation. Il s'agit de la valeur par défaut. |
SQLSRV_LOG_SYSTEM_INIT (1) |
Active la journalisation de l'activité des initialisations. |
SQLSRV_LOG_SYSTEM_CONN (2) |
Active la journalisation de l'activité des connexions. |
SQLSRV_LOG_SYSTEM_STMT (4) |
Active la journalisation de l'activité des instructions. |
SQLSRV_LOG_SYSTEM_UTIL (8) |
Active la journalisation de l'activité des fonctions d'erreur (par exemple handle_error et handle_warning). |
Options LogSeverity
Le paramètre LogSeverity sert à déterminer le contenu de la journalisation après que celle-ci a été activée. Le tableau suivant répertorie les valeurs possibles pour ce paramètre.
| Valeur (entier équivalent entre parenthèses) | Description |
|---|---|
SQLSRV_LOG_SEVERITY_ALL (-1) |
Spécifie que les erreurs, les avertissements et les avis doivent être journalisés. |
SQLSRV_LOG_SEVERITY_ERROR (1) |
Spécifie que les erreurs doivent être journalisées. Valeur par défaut lors de l'activation de la journalisation. |
SQLSRV_LOG_SEVERITY_WARNING (2) |
Spécifie que les avertissements doivent être journalisés. |
SQLSRV_LOG_SEVERITY_NOTICE (4) |
Spécifie que les avis doivent être journalisés. |
Option WarningsReturnAsErrors
L'option WarningsReturnAsErrors est utilisée pour spécifier si les avertissements générés par des appels aux fonctions sqlsrv sont traités comme des erreurs. L'affectation de la valeur 1 (par défaut) à cette option indique que les avertissements seront traités comme des erreurs. L'affectation de la valeur 0 indique que les avertissements ne seront pas traités comme des erreurs. Pour plus d'informations, consultez Procédure : gérer les erreurs et les avertissements.
Voir aussi
Concepts
Autres ressources
Mise en route
Guide de programmation
Référence de l'API (Pilote SQL Server pour PHP)