sqlsrv_errors

(No version information available, might only be in Git)

sqlsrv_errorsDevuelve información de errores y alertas (warnings) de la última operación SQLSRV realizada

Descripción

sqlsrv_errors ([ int $errorsOrWarnings ] ) : mixed

Devuelve información de errores y alertas de la última operación SQLSRV realizada.

Parámetros

errorsOrWarnings

Determina si se ha de retornar información de error, alertas, o ambas. Si este parámetro no se informa, se devolverá tanto información de error como de alerta. Este parámetro puede tomar los siguientes valores: SQLSRV_ERR_ALL, SQLSRV_ERR_ERRORS, SQLSRV_ERR_WARNINGS.

Valores devueltos

Si se produjeron errores y/o warnings en la última operación sqlsrv, se devolverá un array de arrays conteniendo información de error. Si no se produjeron errores y/o alertas en la última operación sqlsrv, se devolverá NULL. La siguiente tabla describe la estructura de los arrays devueltos:

Array devuelto por sqlsrv_errors
Clave Descripción
SQLSTATE Para errores que se originan en el driver ODBC driver, el SQLSTATE devuelto por ODBC. Para errores que se originan en los drivers de Microsoft para PHP para SQL Server, un SQLSTATE de IMSSP. Para alertas que se originan en los drivers de Microsoft para PHP para SQL Server, un SQLSTATE de 01SSP.
code Para errores que se originan en SQL Server, el código de error SQL Server nativo. Para errores que se originan en el driver ODBC, el código de error devuelto por ODBC. Para errores que se originan en los Drivers de Microsoft para PHP para SQL Server, los códigos de error de SQL Server para los Drivers de Microsoft para PHP.
message Una descripción del error.

Ejemplos

Ejemplo #1 ejemplo de functionname()

<?php
$serverName 
"serverName/sqlexpress";
$connectionInfo = array( "Database"=>"dbName""UID"=>"username""PWD"=>"password");
$conn sqlsrv_connect$serverName$connectionInfo);
if( 
$conn === false ) {
     die( 
print_rsqlsrv_errors(), true));
}

/* Query que selecciona un nombre de columna inválida. */
$sql "SELECT BadColumnName FROM Table_1";

/* Ejecución de la query que fallará debido al nombre de columna incorrecto. */
$stmt sqlsrv_query$conn$sql );
if( 
$stmt === false ) {
    if( (
$errors sqlsrv_errors() ) != null) {
        foreach( 
$errors as $error ) {
            echo 
"SQLSTATE: ".$error'SQLSTATE']."<br />";
            echo 
"code: ".$error'code']."<br />";
            echo 
"message: ".$error'message']."<br />";
        }
    }
}
?>

Notas

Por defecto, las alertas generadas en una llamada a cualquier función SQLSRV se tratarán como errores. Esto significa que si una alerta ocurre en una llamada a una función SQLSRV, la función devolverá FALSE. Sin embargo, las alertas correspondientes a los valores de SQLSTATE 01000, 01001, 01003, y 01S02 nunca se tratarán como errores. Para obtener información sobre cómo cambiar este comportamiento, ver sqlsrv_configure() y la configuración de WarningsReturnAsErrors.

Ver también

  • sqlsrv_configure() - Cambia la configuración de los drivers del gestionador de errores y de log