Protokollieren von Aktivitäten
Standardmäßig werden von SQL Server-Treiber für PHP generierte Fehler und Warnungen nicht protokolliert. Um die Protokollierung zu aktivieren, können Sie diesqlsrv_configure-Funktion verwenden oder die Datei php.ini ändern. Sie können Aktivitäten für Initialisierungen, Verbindungen, Anweisungen oder Fehlerfunktionen protokollieren. Sie können auch angeben, ob Fehler, Warnungen, Hinweise oder alle drei protokolliert werden sollen.
Aktivieren der Protokollierung
Sie können die Protokollierung aktivieren, indem Sie mit der sqlsrv_configure-Funktion einen Wert für die LogSubsystems-Einstellung festlegen. Beispielsweise konfiguriert die folgende Codezeile den Treiber so, dass Aktivitäten für Verbindungen protokolliert werden:
sqlsrv_configure("LogSubsystems", SQLSRV_LOG_SYSTEM_CONN);
Die folgende Tabelle beschreibt die Konstanten, die als Wert für die LogSubsystems-Einstellung verwendet werden können:
| 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. |
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). |
Sie können mehr als einen Wert gleichzeitig für die LogSubsystems-Einstellung festlegen, indem Sie den logischen Operator OR (|) verwenden. Die folgende Codezeile aktiviert z. B. die Protokollierung von Aktivitäten für Verbindungen und Anweisungen:
sqlsrv_configure("LogSubsystems", SQLSRV_LOG_SYSTEM_CONN | SQLSRV_LOG_SYSTEM_STMT);
Sie können die Protokollierung auch durch Angeben eines ganzzahligen Werts für die LogSubsystems-Einstellung in der Datei php.ini aktivieren. Beispielsweise aktiviert das Hinzufügen der folgenden Codezeile zum Abschnitt [sqlsrv] der Datei php.ini die Protokollierung von Verbindungsaktivitäten:
sqlsrv.LogSubsystems = 2
Durch Addieren ganzzahliger Werte können Sie mehrere Optionen gleichzeitig angeben. Beispielsweise aktiviert das Hinzufügen der folgenden Codezeile zum Abschnitt [sqlsrv] der Datei php.ini die Protokollierung von Verbindungs- und Anweisungsaktivitäten:
sqlsrv.LogSubsystems = 6
Protokollieren von Fehlern, Warnungen und Hinweisen
Nachdem die Protokollierung aktiviert wurde, müssen Sie angeben, was protokolliert werden soll. Sie können eine oder mehrere der folgenden Kategorien protokollieren: Fehler, Warnungen und Hinweise. Die folgende Codezeile gibt beispielsweise an, dass nur Warnungen protokolliert werden sollen:
sqlsrv_configure("LogSeverity", SQLSRV_LOG_SEVERITY_WARNING);
Hinweis
Die Standardeinstellung für LogSeverity ist SQLSRV_LOG_SEVERITY_ERROR. Wenn die Protokollierung aktiviert ist und keine Einstellung für LogSeverity angegeben wird, werden nur Fehler protokolliert.
Die folgende Tabelle beschreibt die Konstanten, die als Wert für die LogSeverity-Einstellung verwendet werden können:
| 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. |
SQLSRV_LOG_SEVERITY_WARNING (2) |
Gibt an, dass Warnungen protokolliert werden. |
SQLSRV_LOG_SEVERITY_NOTICE (4) |
Gibt an, dass Hinweise protokolliert werden. |
Sie können mehr als einen Wert gleichzeitig für die LogSeverity-Einstellung festlegen, indem Sie den logischen Operator OR (|) verwenden. Die folgende Codezeile gibt beispielsweise an, dass Fehler und Warnungen protokolliert werden sollen:
sqlsrv_configure("LogSeverity", SQLSRV_LOG_SEVERITY_ERROR | SQLSRV_LOG_SEVERITY_WARNING);
Hinweis
Durch Angeben eines Werts für die LogSeverity-Einstellung wird die Protokollierung nicht aktiviert. Sie müssen die Protokollierung aktivieren, indem Sie einen Wert für die LogSubsystems-Einstellung festlegen, und dann angeben, welche Schweregrade protokolliert werden sollen, indem Sie einen Wert für LogSeverity festlegen.
Sie können auch eine Einstellung für die LogSeverity-Einstellung festlegen, indem Sie ganzzahlige Werte in der Datei php.ini verwenden. Beispielsweise wird durch das Hinzufügen der folgenden Zeile zum Abschnitt [sqlsrv] der Datei php.ini die ausschließliche Protokollierung von Warnungen aktiviert:
sqlsrv.LogSeverity = 2
Durch Addieren ganzzahliger Werte können Sie mehrere Optionen gleichzeitig angeben. Beispielsweise aktiviert das Hinzufügen der folgenden Codezeile zum Abschnitt [sqlsrv] der Datei php.ini die Protokollierung von Fehlern und Warnungen:
sqlsrv.LogSeverity = 3
Siehe auch
Verweis
sqlsrv_configure
sqlsrv_get_config
Konzepte
Weitere Ressourcen
Programmierhinweise
API-Referenz (SQL Server-Treiber für PHP)