Actividad de registro
De manera predeterminada, los errores y las advertencias que se generan mediante el Controlador de SQL Server para PHP no se registran. Para activar el registro, puede usar la función sqlsrv_configure o puede modificar el archivo php.ini. Puede registrar la actividad de inicializaciones, conexiones, instrucciones y funciones de error. También, puede especificar si desea registrar errores, advertencias, avisos o los tres.
Activar el registro
Se puede activar el registro mediante la función sqlsrv_configure para especificar un valor para la configuración LogSubsystems. Por ejemplo, la línea de código siguiente configura el controlador para que registre la actividad en las conexiones:
sqlsrv_configure("LogSubsystems", SQLSRV_LOG_SYSTEM_CONN);
En la tabla siguiente se describen las constantes que se pueden usar como valor para la configuración LogSubsystems:
| Valor (entero equivalente entre paréntesis) | Descripción |
|---|---|
SQLSRV_LOG_SYSTEM_ALL (-1) |
Activa el registro de todos los subsistemas. |
SQLSRV_LOG_SYSTEM_OFF (0) |
Desactiva el registro. |
SQLSRV_LOG_SYSTEM_INIT (1) |
Activa el registro de actividad de inicialización. |
SQLSRV_LOG_SYSTEM_CONN (2) |
Activa el registro de actividad de conexión. |
SQLSRV_LOG_SYSTEM_STMT (4) |
Activa el registro de actividad de instrucción. |
SQLSRV_LOG_SYSTEM_UTIL (8) |
Activa el registro de la actividad de funciones de error (por ejemplo, handle_error y handle_warning). |
Puede establecer más de un valor a la vez para la configuración de LogSubsystems mediante el operador lógico OR (|). Por ejemplo, la línea de código siguiente activa el registro de actividad en las conexiones y las instrucciones:
sqlsrv_configure("LogSubsystems", SQLSRV_LOG_SYSTEM_CONN | SQLSRV_LOG_SYSTEM_STMT);
Puede también activar el registro especificando un valor entero para la configuración LogSubsystems en el archivo php.ini. Por ejemplo, si agrega la siguiente línea a la sección [sqlsrv] del archivo php.ini, se activará el registro de actividad de la conexión:
sqlsrv.LogSubsystems = 2
Al sumar valores enteros, puede especificar más de una opción a la vez. Por ejemplo, si agrega la siguiente línea a la sección [sqlsrv] del archivo php.ini, se activará el registro de actividad de la conexión y de la instrucción:
sqlsrv.LogSubsystems = 6
Registro de errores, advertencias y avisos
Después de activar el registro, debe especificar qué desea registrar. Puede registrar uno o más de los siguientes: errores, advertencias y avisos. Por ejemplo, la línea de código siguiente especifica que únicamente se deben registrar las advertencias:
sqlsrv_configure("LogSeverity", SQLSRV_LOG_SEVERITY_WARNING);
Nota
La configuración predeterminada para LogSeverity es SQLSRV_LOG_SEVERITY_ERROR. Si se activa el registro pero no se especifica la configuración para LogSeverity, únicamente se registran los errores.
En la tabla siguiente se describen las constantes que se pueden usar como valor para la configuración LogSeverity:
| Valor (entero equivalente entre paréntesis) | Descripción |
|---|---|
SQLSRV_LOG_SEVERITY_ALL (-1) |
Especifica los errores, advertencias y avisos que se van a registrar. |
SQLSRV_LOG_SEVERITY_ERROR (1) |
Especifica los errores que se van a registrar. |
SQLSRV_LOG_SEVERITY_WARNING (2) |
Especifica las advertencias que se van a registrar. |
SQLSRV_LOG_SEVERITY_NOTICE (4) |
Especifica los avisos que se van a registrar. |
Puede establecer más de un valor a la vez para la configuración de LogSeverity mediante el operador lógico OR (|). Por ejemplo, la línea de código siguiente especifica que se deberían registrar errores y advertencias:
sqlsrv_configure("LogSeverity", SQLSRV_LOG_SEVERITY_ERROR | SQLSRV_LOG_SEVERITY_WARNING);
Nota
Al especificar un valor para la configuración LogSeverity no se activa el registro. Debe activar el registro especificando un valor para la configuración LogSubsystems y, a continuación, especificar la gravedad de lo que se registra al configurar un valor para LogSeverity.
Puede también especificar un valor para la configuración LogSeverity mediante valores enteros en el archivo php.ini. Por ejemplo, si agrega la siguiente línea a la sección [sqlsrv] del archivo php.ini, se habilitará únicamente el registro de advertencias:
sqlsrv.LogSeverity = 2
Al sumar valores enteros, puede especificar más de una opción a la vez. Por ejemplo, si agrega la siguiente línea a la sección [sqlsrv] del archivo php.ini, se habilitará el registro de errores y advertencias:
sqlsrv.LogSeverity = 3
Vea también
Referencia
sqlsrv_configure
sqlsrv_get_config
Conceptos
Otros recursos
Guía de programación
Referencia de la API (Controlador SQL Server para PHP)