PHP8 db2_conn_errormsg
(PECL ibm_db2 >= 1.0.0)
db2_conn_errormsg — 返回上次连接错误消息和 SQLCODE 值
说明
db2_conn_errormsg(?resource $connection = null): string
db2_conn_errormsg() 返回错误消息和 SQLCODE 值表示上次数据库连接尝试失败的原因。 As db2_connect() 在失败时返回 false 连接尝试,不要将任何参数传递给 db2_conn_errormsg() 以检索关联的错误 message 和 SQLCODE 值。
但是,如果连接成功,但随着时间的推移变得无效, 您可以传递参数进行检索 特定连接的关联错误消息和 SQLCODE 值。connection
参数
connection
与最初连接关联的连接资源 成功了,但随着时间的推移变得无效。
返回值
返回一个字符串,其中包含错误消息和生成的 SQLCODE 值 来自失败的连接尝试。如果没有与最后一个关联的错误 连接尝试,db2_conn_errormsg() 返回一个空 字符串。
示例
示例 #1 检索连接尝试失败返回的错误消息
下面的示例演示如何返回错误消息和 故意将无效参数传递给 db2_connect() 后的 SQLCODE 值。
<?php
$conn = db2_connect('badname', 'baduser', 'badpassword');
if (!$conn) {
print db2_conn_errormsg();
}
?>
以上示例会输出:
[IBM][CLI Driver] SQL1013N The database alias name or database name "BADNAME" could not be found. SQLSTATE=42705 SQLCODE=-1013
参见
- db2_conn_error() - 返回一个字符串,其中包含上次连接尝试返回的 SQLSTATE
- db2_connect() - 返回与数据库的连接
- db2_stmt_error() - 返回一个字符串,其中包含 SQL 语句返回的 SQLSTATE
- db2_stmt_errormsg() - 返回包含最后一个 SQL 语句错误消息的字符串