db2_conn_errormsg

(PECL ibm_db2 >= 1.0.0)

db2_conn_errormsg 返回最后连接错误消息和 SQLCODE 值

描述

db2_conn_errormsg(?resource $connection = null): string

db2_conn_errormsg() 返回一个错误消息和 SQLCODE 值,表示上次数据库连接尝试失败的原因。由于 db2_connect() 在连接尝试失败的情况下返回 false,因此不要向 db2_conn_errormsg() 传递任何参数以检索相关的错误消息和 SQLCODE 值。

但是,如果连接成功但随着时间的推移变得无效,您可以传递 connection 参数以检索与特定连接相关的错误消息和 SQLCODE 值。

参数

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 语句错误消息

添加备注

用户贡献备注 1 条备注

nnd100216ibmdb2 at smallcue dot com
14 年前
一个警告

看来,如果您在 php.ini 文件中指定了一个无效的 ibm_db2.instance_name,则您的编目 db2_connect() 将失败,返回 false,当您使用 db2_conn_error() 或 db2_conn_errormsg() 检查原因时,这些函数将返回一个空字符串。
To Top