Attività di registrazione
Per impostazione predefinita, gli errori e gli avvisi generati dai driver Microsoft per PHP per SQL Server non vengono registrati nel registro di sistema PHP. Questo argomento illustra come configurare l'attività di registrazione dei driver. Per altre informazioni su come configurare le impostazioni di gestione degli errori PHP non specifiche per i driver, vedere la documentazione di PHP.
Attività di registrazione con il driver PDO_SQLSRV
L'unica configurazione di registrazione disponibile per il driver PDO_SQLSRV è la voce pdo_sqlsrv.log_severity nel file php.ini.
Aggiungere quanto segue alla fine del file php.ini:
[pdo_sqlsrv]
pdo_sqlsrv.log_severity = <number>
log_severity può essere uno dei valori seguenti:
| valore | Descrizione |
|---|---|
| 0 | La registrazione è disabilitata (impostazione predefinita se non viene definita alcuna impostazione). |
| -1 | Specifica la registrazione di errori, avvisi e notifiche. |
| 1 | Specifica che gli errori vengono registrati. |
| 2 | Specifica che gli avvisi vengono registrati. |
| 4 | Specifica che le notifiche vengono registrate. |
Le informazioni di registrazione vengono aggiunte al file phperrors.log.
PHP legge il file di configurazione durante l'inizializzazione e archivia i dati in una cache. PHP offre inoltre un'API per l'aggiornamento e l'uso di queste impostazioni che vengono scritte nel file di configurazione. Questa API consente agli script dell'applicazione di modificare le impostazioni anche dopo l'inizializzazione di PHP.
Attività di registrazione con il driver SQLSRV
Per attivare la registrazione, è possibile usare la funzione sqlsrv_configure oppure modificare il file php.ini. È possibile registrare l'attività durante l'inizializzazione, la connessione, le istruzioni o le funzioni di errore. È inoltre possibile specificare se registrare errori, avvisi, notifiche o tutti e tre.
Nota
Il percorso del file di log può essere specificato nel file php.ini. Per altri dettagli, vedere la documentazione di PHP.
Attivazione della registrazione
È possibile attivare la registrazione usando la funzione sqlsrv_configure per specificare un valore per l'impostazione LogSubsystems. Ad esempio, la riga di codice seguente consente di configurare il driver per la registrazione dell'attività durante le connessioni:
sqlsrv_configure("LogSubsystems", SQLSRV_LOG_SYSTEM_CONN);
Nella tabella seguente sono descritte le costanti che possono essere usate come valore dell'impostazione LogSubsystems :
| Valore (intero equivalente tra parentesi) | Descrizione |
|---|---|
| SQLSRV_LOG_SYSTEM_ALL (-1) | Attiva la registrazione di tutti i sottosistemi. |
| SQLSRV_LOG_SYSTEM_OFF (0) | Disattiva la registrazione. Si tratta dell'impostazione predefinita. |
| SQLSRV_LOG_SYSTEM_INIT (1) | Attiva la registrazione dell'attività di inizializzazione. |
| SQLSRV_LOG_SYSTEM_CONN (2) | Attiva la registrazione dell'attività di connessione. |
| SQLSRV_LOG_SYSTEM_STMT (4) | Attiva la registrazione delle attività delle istruzioni. |
| SQLSRV_LOG_SYSTEM_UTIL (8) | Attiva la registrazione delle attività delle funzioni di errore, ad esempio handle_error e handle_warning. |
È possibile impostare più valori per l'impostazione LogSubsystems usando l'operatore logico OR (|). Ad esempio, la riga di codice seguente attiva la registrazione dell'attività delle connessioni e delle istruzioni:
sqlsrv_configure("LogSubsystems", SQLSRV_LOG_SYSTEM_CONN | SQLSRV_LOG_SYSTEM_STMT);
È anche possibile attivare la registrazione specificando un valore intero per l'impostazione LogSubsystems nel file php.ini. Ad esempio, aggiungendo la riga seguente alla sezione [sqlsrv] del file php.ini, viene attivata la registrazione dell'attività di connessione:
sqlsrv.LogSubsystems = 2
Sommando i valori interi è possibile specificare più opzioni alla volta. Ad esempio, aggiungendo la riga seguente alla sezione [sqlsrv] del file php.ini, viene attivata la registrazione dell'attività di connessione e delle istruzioni:
sqlsrv.LogSubsystems = 6
Registrazione di errori, avvisi e notifiche
Dopo aver attivato la registrazione, è necessario specificare gli elementi da registrare. È possibile registrare uno o più degli elementi seguenti: errori, avvisi e notifiche. Ad esempio, la riga di codice seguente specifica che deve essere eseguita solo la registrazione degli avvisi:
sqlsrv_configure("LogSeverity", SQLSRV_LOG_SEVERITY_WARNING);
Nota
L'impostazione predefinita di LogSeverity è SQLSRV_LOG_SEVERITY_ERROR. Se la registrazione è attivata e non viene specificata alcuna impostazione per LogSeverity , vengono registrati solo gli errori.
Nella tabella seguente sono descritte le costanti che possono essere usate come valore dell'impostazione LogSeverity :
| Valore (intero equivalente tra parentesi) | Descrizione |
|---|---|
| SQLSRV_LOG_SEVERITY_ALL (-1) | Specifica la registrazione di errori, avvisi e notifiche. |
| SQLSRV_LOG_SEVERITY_ERROR (1) | Specifica che gli errori vengono registrati. Si tratta dell'impostazione predefinita. |
| SQLSRV_LOG_SEVERITY_WARNING (2) | Specifica che gli avvisi vengono registrati. |
| SQLSRV_LOG_SEVERITY_NOTICE (4) | Specifica che le notifiche vengono registrate. |
È possibile impostare più valori per l'impostazione LogSeverity usando l'operatore logico OR (|). Ad esempio, la riga di codice seguente specifica la registrazione di errori e avvisi:
sqlsrv_configure("LogSeverity", SQLSRV_LOG_SEVERITY_ERROR | SQLSRV_LOG_SEVERITY_WARNING);
Nota
La specifica di un valore per l'impostazione LogSeverity non comporta l'attivazione della registrazione. Attivare la registrazione specificando un valore per l'impostazione LogSubsystems, quindi specificare la gravità degli elementi registrati impostando un valore per LogSeverity.
È inoltre possibile specificare un'impostazione per LogSeverity mediante valori interi nel file php.ini. Ad esempio, aggiungendo la seguente riga alla sezione [sqlsrv] del file php.ini verrà attivata solo la registrazione degli avvisi:
sqlsrv.LogSeverity = 2
Sommando i valori interi è possibile specificare più opzioni alla volta. Ad esempio, aggiungendo la riga seguente alla sezione [sqlsrv] del file php.ini, viene abilitata la registrazione di errori e avvisi:
sqlsrv.LogSeverity = 3
Vedi anche
Guida alla programmazione per i driver Microsoft per PHP per SQL Server