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 都包含三個索引鍵值組。 下表列出每個索引鍵及其描述：

Key 描述
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。
訊息 錯誤的描述。

使用數值索引鍵 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 參考

關於文件中的程式碼範例