db2_conn_error

(PECL ibm_db2 >= 1.0.0)

db2_conn_error返回一个包含最后一次连接尝试返回的 SQLSTATE 的字符串

描述

db2_conn_error(?resource $connection = null): string

db2_conn_error() 返回一个 SQLSTATE 值,表示最后一次尝试连接到数据库失败的原因。由于 db2_connect() 在连接尝试失败的情况下返回 false,因此您无需向 db2_conn_error() 传递任何参数来检索 SQLSTATE 值。

但是,如果连接成功但随着时间的推移变得无效,您可以传递 connection 参数来检索特定连接的 SQLSTATE 值。

要了解 SQLSTATE 值的含义,您可以在 DB2 命令行处理器提示符下发出以下命令:db2 '? sqlstate-value'。您也可以调用 db2_conn_errormsg() 来检索明确的错误消息和关联的 SQLCODE 值。

参数

connection

与最初成功但随着时间的推移变得无效的连接关联的连接资源。

返回值

返回连接尝试失败所导致的 SQLSTATE 值。如果与最后一次连接尝试没有关联的错误,则返回空字符串。

示例

示例 #1 检索失败连接尝试的 SQLSTATE 值

以下示例演示了如何在故意向 db2_connect() 传递无效参数后返回 SQLSTATE 值。

<?php
$conn
= db2_connect('badname', 'baduser', 'badpassword');
if (!
$conn) {
print
"SQLSTATE value: " . db2_conn_error();
}
?>

上面的示例将输出

SQLSTATE value: 08001

参见

添加备注

用户贡献的备注

此页面没有用户贡献的备注。
To Top