Konfigurieren des Treibers
In diesem Thema sind die Konfigurationsoptionen für SQL Server-Treiber für PHP sowie Informationen zum Ändern der Konfigurationseinstellungen aufgeführt.
Zum Abrufen der aktuellen Konfigurationseinstellungen des Treibers verwenden Sie die sqlsrv_get_config-Funktion. Zum Ändern der Konfigurationseinstellungen verwenden Sie die sqlsrv_configure-Funktion, oder legen Sie Werte für die Konfigurationseinstellungen in der Datei php.ini fest. Detaillierte Informationen zum Ändern der Konfigurationseinstellungen finden Sie unter Vorgehensweise: Konfigurieren der Behandlung von Fehlern und Warnungen und Protokollieren von Aktivitäten.
Konfigurationsoptionen
SQL Server-Treiber für PHP verfügt über drei Konfigurationsoptionen: LogSubsystems, LogSeverity und WarningsReturnAsErrors. Die Standardwerte für diese Einstellungen lauten SQLSRV_LOG_SYSTEM_OFF, SQLSRV_LOG_SEVERITY_ERROR (nachdem die Protokollierung aktiviert wurde) bzw. true (1). In den folgenden Abschnitten werden diese Konfigurationsoptionen und ihre möglichen Einstellungen beschrieben.
LogSubsystems-Optionen
Mit der Einstellung LogSubsystems kann die Protokollierung für Subsysteme aktiviert werden. Die folgende Tabelle enthält die möglichen Werte für diese Einstellung.
| Wert (entsprechende ganze Zahl in Klammern) | Beschreibung |
|---|---|
SQLSRV_LOG_SYSTEM_ALL (-1) |
Aktiviert die Protokollierung aller Subsysteme. |
SQLSRV_LOG_SYSTEM_OFF (0) |
Deaktiviert die Protokollierung. Dies ist der Standardwert. |
SQLSRV_LOG_SYSTEM_INIT (1) |
Aktiviert die Protokollierung der Initialisierungsaktivitäten. |
SQLSRV_LOG_SYSTEM_CONN (2) |
Aktiviert die Protokollierung der Verbindungsaktivitäten. |
SQLSRV_LOG_SYSTEM_STMT (4) |
Aktiviert die Protokollierung der Anweisungsaktivitäten. |
SQLSRV_LOG_SYSTEM_UTIL (8) |
Aktiviert die Protokollierung der Fehlerfunktionsaktivitäten (z. B. handle_error und handle_warning). |
LogSeverity-Optionen
Mit der Einstellung LogSeverity wird angegeben, was protokolliert werden soll, nachdem die Protokollierung aktiviert wurde. Die folgende Tabelle enthält die möglichen Werte für diese Einstellung.
| Wert (entsprechende ganze Zahl in Klammern) | Beschreibung |
|---|---|
SQLSRV_LOG_SEVERITY_ALL (-1) |
Gibt an, dass Fehler, Warnungen und Hinweise protokolliert werden. |
SQLSRV_LOG_SEVERITY_ERROR (1) |
Gibt an, dass Fehler protokolliert werden. Dies ist der Standardwert, wenn die Protokollierung aktiviert wird. |
SQLSRV_LOG_SEVERITY_WARNING (2) |
Gibt an, dass Warnungen protokolliert werden. |
SQLSRV_LOG_SEVERITY_NOTICE (4) |
Gibt an, dass Hinweise protokolliert werden. |
WarningsReturnAsErrors-Option
Mit der Option WarningsReturnAsErrors kann angegeben werden, ob von Aufrufen der sqlsrv-Funktionen generierte Warnungen als Fehler behandelt werden sollen. Wenn diese Option auf 1 (den Standardwert) festgelegt wird, werden Warnungen als Fehler behandelt. Wenn diese Option auf 0 festgelegt wird, werden Warnungen nicht als Fehler behandelt. Weitere Informationen finden Sie unter Vorgehensweise: Behandeln von Fehlern und Warnungen.
Siehe auch
Konzepte
Weitere Ressourcen
Erste Schritte
Programmierhinweise
API-Referenz (SQL Server-Treiber für PHP)