Signatur
Beschreibung
sqlsrv_get_config() ermöglicht es, den aktuellen Wert einer bestimmten Treiberkonfiguration des Microsoft SQL Server-Treibers für PHP (SQLSRV) abzurufen. Die Einstellungen, die abgefragt werden können, entsprechen den Werten, die über sqlsrv_configure() gesetzt werden – etwa die Log-Einstellungen oder die Fehlerbehandlung.
Typische Konfigurationsschlüssel sind beispielsweise WarningsReturnAsErrors, LogSeverity, LogSubsystems und ClientBufferMaxKBSize. Diese Einstellungen steuern das globale Verhalten des Treibers gegenüber Warnungen, Logging und Speicherpuffergrößen.
Die Funktion ist besonders nützlich für Debugging-Zwecke oder um vor einer Änderung einer Einstellung deren aktuellen Wert zu sichern, damit er später wiederhergestellt werden kann.
Wird ein unbekannter oder ungültiger Einstellungsname übergeben, gibt die Funktion false zurück. Es wird empfohlen, die Rückgabe explizit auf false zu prüfen, da gültige Einstellungen auch den Wert 0 oder false haben können – daher sollte der strikte Vergleich === verwendet werden.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $setting Pflicht | string | Der Name der abzurufenden Konfigurationseinstellung, z. B. WarningsReturnAsErrors, LogSeverity, LogSubsystems oder ClientBufferMaxKBSize. |
Rückgabewert
int, bool). Gibt false zurück, wenn die Einstellung nicht existiert oder ein Fehler aufgetreten ist.Beispiele
Aktuelle Konfiguration für Warnungsbehandlung auslesen
<?php
// Aktuellen Wert von WarningsReturnAsErrors auslesen
$value = sqlsrv_get_config('WarningsReturnAsErrors');
if ($value === false) {
echo "Einstellung nicht gefunden oder Fehler aufgetreten.";
} else {
echo "WarningsReturnAsErrors ist: " . ($value ? 'true' : 'false') . PHP_EOL;
}Einstellung sichern, ändern und wiederherstellen
<?php
// Aktuellen Wert sichern
$originalSeverity = sqlsrv_get_config('LogSeverity');
echo "Ursprünglicher LogSeverity-Wert: " . $originalSeverity . PHP_EOL;
// Einstellung temporär ändern
sqlsrv_configure('LogSeverity', SQLSRV_LOG_SEVERITY_ALL);
echo "LogSeverity während Debugging: " . sqlsrv_get_config('LogSeverity') . PHP_EOL;
// Ursprünglichen Wert wiederherstellen
sqlsrv_configure('LogSeverity', $originalSeverity);
echo "LogSeverity wiederhergestellt: " . sqlsrv_get_config('LogSeverity') . PHP_EOL;// Wichtig · Fallstricke
Hinweis zur Rückgabewertprüfung: Da manche Einstellungen den Wert 0 oder false haben können, sollte der Rückgabewert stets mit dem strikten Vergleich === false geprüft werden, um echte Fehler von gültigen Konfigurationswerten zu unterscheiden.
Verfügbarkeit: Die Funktion ist nur verfügbar, wenn die SQLSRV-Erweiterung (ext/sqlsrv) installiert und aktiviert ist. Diese Erweiterung wird von Microsoft bereitgestellt und funktioniert ausschließlich unter Windows bzw. mit dem Microsoft ODBC Driver for SQL Server.
Mögliche Einstellungsnamen: WarningsReturnAsErrors, LogSeverity, LogSubsystems, ClientBufferMaxKBSize. Andere Schlüssel führen zur Rückgabe von false.