PHP8 db2_conn_error
(PECL ibm_db2 >= 1.0.0)
db2_conn_error — 返回一个字符串,其中包含上次连接尝试返回的 SQLSTATE
说明
db2_conn_error(?resource $connection = null): string
db2_conn_error() 返回一个 SQLSTATE 值,表示 上次尝试连接到数据库失败的原因。As db2_connect() 在失败时返回 false 连接尝试时,您不会将任何参数传递给 db2_conn_error() 来检索 SQLSTATE 值。
但是,如果连接成功,但随着时间的推移变得无效, 您可以传递参数进行检索 特定连接的 SQLSTATE 值。connection
若要了解 SQLSTATE 值的含义,可以发出以下命令 在 DB2 命令行处理器提示符下:db2 '?sqlstate-value“。你 也可以调用 db2_conn_errormsg() 来检索 显式错误消息和关联的 SQLCODE 值。
参数
connection
与最初连接关联的连接资源 成功了,但随着时间的推移变得无效。
返回值
返回连接尝试失败导致的 SQLSTATE 值。 如果没有与最后一个关联的错误,则返回一个空字符串 连接尝试。
示例
示例 #1 检索连接失败尝试的 SQLSTATE 值
下面的示例演示如何返回 SQLSTATE 值 故意将无效参数传递给 db2_connect() 后。
<?php
$conn = db2_connect('badname', 'baduser', 'badpassword');
if (!$conn) {
print "SQLSTATE value: " . db2_conn_error();
}
?>
以上示例会输出:
SQLSTATE value: 08001
参见
- db2_conn_errormsg() - 返回最后一个连接错误消息和 SQLCODE 值
- db2_connect() - 返回与数据库的连接
- db2_stmt_error() - 返回一个字符串,其中包含 SQL 语句返回的 SQLSTATE
- db2_stmt_errormsg() - 返回包含最后一个 SQL 语句错误消息的字符串