sqlsrv_configure

Article
06/02/2023

Modifie les paramètres de gestion des erreurs et les options de journalisation.

Syntaxe

  
sqlsrv_configure( string $setting, mixed $value )

Paramètres

$setting: nom du paramètre à configurer. Pour obtenir une liste des paramètres, consultez le tableau ci-dessous.

$value: valeur à appliquer au paramètre spécifié dans le paramètre $setting . Les valeurs possibles pour ce paramètre dépendent du paramètre spécifié. Le tableau suivant répertorie les combinaisons possibles :

Paramètre	Valeurs possibles pour le paramètre $value (entier équivalent entre parenthèses)	Valeur par défaut
ClientBufferMaxKBSize¹	Nombre non négatif jusqu’à la limite de mémoire PHP. Zéro et les nombres négatifs ne sont pas autorisés.	10 240 Ko
LogSeverity²	SQLSRV_LOG_SEVERITY_ALL (-1) SQLSRV_LOG_SEVERITY_ERROR (1) SQLSRV_LOG_SEVERITY_NOTICE (4) SQLSRV_LOG_SEVERITY_WARNING (2)	SQLSRV_LOG_SEVERITY_ERROR (1)
LogSubsystems²	SQLSRV_LOG_SYSTEM_ALL (-1) SQLSRV_LOG_SYSTEM_CONN (2) SQLSRV_LOG_SYSTEM_INIT (1) SQLSRV_LOG_SYSTEM_OFF (0) SQLSRV_LOG_SYSTEM_STMT (4) SQLSRV_LOG_SYSTEM_UTIL (8)	SQLSRV_LOG_SYSTEM_OFF (0)
WarningsReturnAsErrors³	true (1) ou false (0)	true (1)

Valeur de retour

Si sqlsrv_configure est appelé avec un paramètre ou une valeur non pris en charge, la fonction retourne false. Sinon, elle retourne true.

Notes

(1) Pour plus d’informations sur les requêtes côté client, consultez Types de curseurs (Pilote SQLSRV).

(2) Pour plus d’informations sur la journalisation de l’activité, voir Journalisation de l’activité.

(3) Pour plus d’informations sur la configuration de la gestion des erreurs et des avertissements, consultez Procédure : configurer la gestion des erreurs et des avertissements à l’aide du pilote SQLSRV.

Voir aussi

Informations de référence sur l’API du pilote SQLSRV

Guide de programmation pour les pilotes Microsoft pour PHP pour SQL Server