Naplózási tevékenység

PHP-illesztőprogram letöltése

Alapértelmezés szerint a Microsoft Drivers for PHP for SQL Server által generált hibák és figyelmeztetések nem lesznek naplózva a PHP rendszernaplójában. Ez a témakör az illesztőprogram-naplózási tevékenység konfigurálását ismerteti. Az illesztőprogramokra nem jellemző PHP-hibakezelési beállítások konfigurálásáról további információt a PHP dokumentációjában talál.

Naplózási tevékenység az PDO_SQLSRV illesztőprogram használatával

Az PDO_SQLSRV illesztőprogramra vonatkozó egyetlen elérhető naplózási konfiguráció a php.ini fájl pdo_sqlsrv.log_súlyossági bejegyzése.

Adja hozzá a következőt a php.ini fájl végén:

[pdo_sqlsrv]  
pdo_sqlsrv.log_severity = <number>  

log_severity az alábbi értékek egyike lehet:

Érték	Description
0	A naplózás le van tiltva (ez az alapértelmezett, ha nincs definiálva semmi).
-1	Megadja, hogy a rendszer naplózza a hibákat, figyelmeztetéseket és értesítéseket.
1	Megadja, hogy a rendszer naplózza a hibákat.
2	Megadja, hogy a rendszer naplózza a figyelmeztetéseket.
4	Megadja, hogy a rendszer naplózza az értesítéseket.

A naplózási adatok hozzá lesznek adva a phperrors.log fájlhoz.

A PHP beolvassa a konfigurációs fájlt az inicializáláskor, és gyorsítótárban tárolja az adatokat; Emellett egy API-t is biztosít ezeknek a beállításoknak a frissítéséhez és azonnali használatához, és a konfigurációs fájlba van írva. Ez az API lehetővé teszi, hogy az alkalmazásszkriptek a PHP-inicializálás után is módosítják a beállításokat.

Naplózási tevékenység az SQLSRV-illesztőprogram használatával

A naplózás bekapcsolásához használhatja a sqlsrv_configure függvényt, vagy módosíthatja a php.ini fájlt. Az inicializációkon, kapcsolatokon, utasításokon vagy hibafüggvényeken naplózhatja a tevékenységeket. Azt is megadhatja, hogy naplózza-e a hibákat, figyelmeztetéseket, értesítéseket vagy mind a hármat.

Megjegyzés:

A naplófájl helyét a php.ini fájlban konfigurálhatja. További részletekért tekintse meg a PHP dokumentációját .

Naplózás aktiválása

A naplózást a sqlsrv_configure függvénnyel kapcsolhatja be a LogSubsystems beállítás értékének megadásához. A következő kódsor például úgy konfigurálja az illesztőprogramot, hogy naplózza a kapcsolatokat:

sqlsrv_configure("LogSubsystems", SQLSRV_LOG_SYSTEM_CONN);

Az alábbi táblázat a LogSubsystems beállítás értékeként használható állandókat ismerteti:

Érték (egész szám egyenérték zárójelben)	Description
SQLSRV_LOG_SYSTEM_ALL (-1)	Bekapcsolja az összes alrendszer naplózását.
SQLSRV_LOG_SYSTEM_OFF (0)	Kikapcsolja a naplózást. Ez az alapértelmezett érték.
SQLSRV_LOG_SYSTEM_INIT (1)	Bekapcsolja az inicializálási tevékenység naplózását.
SQLSRV_LOG_SYSTEM_CONN (2)	Bekapcsolja a kapcsolati tevékenység naplózását.
SQLSRV_LOG_SYSTEM_STMT (4)	Bekapcsolja az utasítástevékenység naplózását.
SQLSRV_LOG_SYSTEM_UTIL (8)	Bekapcsolja az olyan hibafüggvények aktivitásának naplózását, mint a handle_error és a handle_warning.

A LogSubsystems beállításához egyszerre több értéket is beállíthat a logikai VAGY operátor (|) használatával. A következő kódsor például bekapcsolja a tevékenységek naplózását a kapcsolatokon és utasításokon:

sqlsrv_configure("LogSubsystems", SQLSRV_LOG_SYSTEM_CONN | SQLSRV_LOG_SYSTEM_STMT);

A naplózás bekapcsolásához adjon meg egy egész számot a LogSubsystems beállításhoz a php.ini fájlban. Ha például hozzáadja a következő sort a [sqlsrv] php.ini fájl szakaszához, bekapcsolja a kapcsolati tevékenység naplózását:

sqlsrv.LogSubsystems = 2

Egész számértékek összeadásával egyszerre több lehetőséget is megadhat. Ha például hozzáadja a következő sort a [sqlsrv] php.ini fájl szakaszához, bekapcsolja a kapcsolat- és utasítástevékenység naplózását:

sqlsrv.LogSubsystems = 6

Naplózási hibák, figyelmeztetések és értesítések

A naplózás bekapcsolása után meg kell adnia, hogy mit kell naplóznia. Az alábbiak közül egy vagy több naplózható: hibák, figyelmeztetések és értesítések. A következő kódsor például azt határozza meg, hogy csak a figyelmeztetések legyenek naplózva:

sqlsrv_configure("LogSeverity", SQLSRV_LOG_SEVERITY_WARNING);

Megjegyzés:

A LogSeverity alapértelmezett beállítása SQLSRV_LOG_SEVERITY_ERROR. Ha a naplózás be van kapcsolva, és nincs megadva a LogSeverity beállítása, csak a hibák lesznek naplózva.

Az alábbi táblázat a LogSeverity beállítás értékeként használható állandókat ismerteti:

Érték (egész szám egyenérték zárójelben)	Description
SQLSRV_LOG_SEVERITY_ALL (-1)	Megadja, hogy a rendszer naplózza a hibákat, figyelmeztetéseket és értesítéseket.
SQLSRV_LOG_SEVERITY_ERROR (1)	Megadja, hogy a rendszer naplózza a hibákat. Ez az alapértelmezett érték.
SQLSRV_LOG_SEVERITY_WARNING (2)	Megadja, hogy a rendszer naplózza a figyelmeztetéseket.
SQLSRV_LOG_SEVERITY_NOTICE (4)	Megadja, hogy a rendszer naplózza az értesítéseket.

A LogSeverity beállításhoz egyszerre több értéket is beállíthat a logikai VAGY operátor (|) használatával. A következő kódsor például azt határozza meg, hogy a hibákat és figyelmeztetéseket naplózni kell:

sqlsrv_configure("LogSeverity", SQLSRV_LOG_SEVERITY_ERROR | SQLSRV_LOG_SEVERITY_WARNING);

Megjegyzés:

A LogSeverity beállítás értékének megadása nem kapcsolja be a naplózást. Kapcsolja be a naplózást a LogSubsystems beállítás értékének megadásával, majd adja meg a naplózott adatok súlyosságát a LogSeverity értékének beállításával.

A LogSeverity beállítás beállítását a php.ini fájl egész számértékeivel is megadhatja. Ha például hozzáadja a következő sort a [sqlsrv] php.ini fájl szakaszához, csak a figyelmeztetések naplózását teszi lehetővé:

sqlsrv.LogSeverity = 2

Egész számértékek összeadásával egyszerre több lehetőséget is megadhat. Ha például hozzáadja a következő sort a [sqlsrv] php.ini fájl szakaszához, lehetővé teszi a hibák és figyelmeztetések naplózását:

sqlsrv.LogSeverity = 3

Lásd még:

Programozási útmutató a Microsoft által az SQL Serverhez készült PHP-illesztőprogramokhoz

Állandók (Microsoft Drivers for PHP for SQL Server)

sqlsrv_configure

sqlsrv_get_config

SQLSRV Driver API-referencia