sqlsrv_errors

  • 项目

下载 PHP 驱动程序

返回有关执行的最后 sqlsrv 操作的扩展错误和/或警告信息。

sqlsrv_errors 函数可返回错误和/或警告信息，方法是使用在下面的“参数”部分中指定的参数值之一调用它。

默认情况下，对任何 sqlsrv 函数的调用所生成的警告将会视为错误；如果警告发生在调用 sqlsrv 函数时，则该函数会返回 false。 但是，对应于 SQLSTATE 值 01000、01001、01003 和 01S02 的警告决不视为错误。

以下代码行会关闭上述行为；对 sqlsrv 函数的调用所生成的警告不会导致函数返回 false：

sqlsrv_configure("WarningsReturnAsErrors", 0);

以下代码行恢复默认行为；警告（有例外，如上所述）将会视为错误。

sqlsrv_configure("WarningsReturnAsErrors", 1);

无论设置如何，警告只能通过使用 SQLSRV_ERR_ALL 或 SQLSRV_ERR_WARNINGS 参数值调用 sqlsrv_errors 来进行检索（有关详细信息，请参阅下面的“参数”部分）。

语法

  
sqlsrv_errors( [int $errorsAndOrWarnings] )

参数

$errorsAndOrWarnings[可选]：预定义常量。 此参数可以采用下表中所列的值之一：

值 说明
SQLSRV_ERR_ALL 将返回在上次调用 sqlsrv 函数时生成的错误和警告。
SQLSRV_ERR_ERRORS 将返回上次调用 sqlsrv 函数时生成的错误。
SQLSRV_ERR_WARNINGS 将返回上次调用 sqlsrv 函数时生成的警告。

如果未提供任何参数值，则将返回上次调用 sqlsrv 函数时生成的错误和警告。

返回值

数组的 array 或 null。 返回的 array 中的每个 array 都包含三个键值对。 下表列出了每个键及其描述：

键 说明
SQLSTATE 对于来源于 ODBC 驱动程序的错误，为 ODBC 返回的 SQLSTATE。 有关 ODBC 的 SQLSTATE 值的信息，请参阅 ODBC 错误代码。

对于来源于 Microsoft Drivers for PHP for SQL Server的错误，为 IMSSP 的 SQLSTATE。

对于来源于 Microsoft Drivers for PHP for SQL Server的警告，为 01SSP 的 SQLSTATE。
code 对于来源于 SQL Server 的错误，为本机 SQL Server 错误代码。

对于来源于 ODBC 驱动程序的错误，为 ODBC 返回的错误代码。

对于来源于 Microsoft Drivers for PHP for SQL Server的错误，为 Microsoft Drivers for PHP for SQL Server 错误代码。 有关详细信息，请参阅 Handling Errors and Warnings。
message 对错误的说明。

数组值还可以使用数值键 0、1 和 2 访问。 如果未发生任何错误或警告，将返回 null 。

示例

以下示例显示在失败的语句执行期间发生的错误。 （语句失败，因为 InvalidColumName 不是指定表中的有效列名。）该示例假定已在本地计算机上安装了 SQL Server 和 AdventureWorks 数据库。 从命令行运行该示例时，所有输出都将写入控制台。

<?php  
/* Connect to the local server using Windows Authentication and   
specify the AdventureWorks database as the database in use. */  
$serverName = "(local)";  
$connectionInfo = array( "Database"=>"AdventureWorks");  
$conn = sqlsrv_connect( $serverName, $connectionInfo);  
if( $conn === false )  
{  
     echo "Could not connect.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
  
/* Set up a query to select an invalid column name. */  
$tsql = "SELECT InvalidColumnName FROM Sales.SalesOrderDetail";  
  
/* Attempt execution. */  
/* Execution will fail because of the invalid column name. */  
$stmt = sqlsrv_query( $conn, $tsql);  
if( $stmt === false )  
{  
      if( ($errors = sqlsrv_errors() ) != null)  
      {  
         foreach( $errors as $error)  
         {  
            echo "SQLSTATE: ".$error[ 'SQLSTATE']."\n";  
            echo "code: ".$error[ 'code']."\n";  
            echo "message: ".$error[ 'message']."\n";  
         }  
      }  
}  
  
/* Free connection resources */  
sqlsrv_close( $conn);  
?>

另请参阅

SQLSRV 驱动程序 API 参考

文档中相关的代码示例