sqlsrv_errors()函数—用法及示例

函数名称：sqlsrv_errors()

适用版本：PHP 5.3.0 及以上版本

函数描述：sqlsrv_errors() 函数用于返回上一个 SQL 操作的错误和警告信息。

语法：array sqlsrv_errors( [ bool $errorsAndWarnings = SQLSRV_ERR_ALL ] )

参数：

• $errorsAndWarnings（可选）：指定是否返回错误和警告信息。默认为 SQLSRV_ERR_ALL，返回所有错误和警告信息。

返回值：返回一个包含错误和警告信息的数组，每个元素包含以下键：

• 'SQLSTATE'：表示错误的 SQL 状态码。
• 'code'：表示错误的错误代码。
• 'message'：表示错误的错误消息。

示例：

<?php
$serverName = "localhost";
$connectionOptions = array(
    "Database" => "mydatabase",
    "Uid" => "myusername",
    "PWD" => "mypassword"
);

$conn = sqlsrv_connect($serverName, $connectionOptions);

if ($conn === false) {
    // 获取连接错误信息
    $errors = sqlsrv_errors(SQLSRV_ERR_ALL);
    
    if ($errors !== null) {
        foreach ($errors as $error) {
            echo "SQLSTATE: " . $error['SQLSTATE'] . "<br>";
            echo "Code: " . $error['code'] . "<br>";
            echo "Message: " . $error['message'] . "<br><br>";
        }
    }
}
?>

以上示例演示了如何使用 sqlsrv_errors() 函数获取连接错误信息。如果连接失败，我们使用该函数获取错误数组，并遍历数组输出每个错误的 SQL 状态码、错误代码和错误消息。

请注意，该函数仅适用于使用 SQL Server 驱动程序（sqlsrv）连接 SQL Server 数据库的情况。如果使用其他数据库驱动程序（如 PDO_SQLSRV）连接数据库，则需要使用相应的错误处理函数。