(PECL ibm_db2 >= 1.0.0)
db2_conn_error — 返回包含上次连接尝试返回的 SQLSTATE 的字符串
db2_conn_error() 返回一个表示上次尝试连接到数据库失败原因的 SQLSTATE 值。由于 db2_connect() 在连接尝试失败时返回 false
,因此无需向 db2_conn_error() 传递任何参数即可检索 SQLSTATE 值。
但是,如果连接成功但随着时间的推移变得无效,则可以传递 connection
参数来检索特定连接的 SQLSTATE 值。
要了解 SQLSTATE 值的含义,可以在 DB2 命令行处理器提示符下发出以下命令:db2 '?
。还可以调用 db2_conn_errormsg() 来检索显式错误消息和关联的 SQLCODE 值。sqlstate-value
'
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