警告
如果在 php.ini 文件中指定了无效的 ibm_db2.instance_name,则编录的 db2_connect() 将失败并返回 false 值,当使用 db2_conn_error() 或 db2_conn_errormsg() 检查原因时,这些函数将返回空字符串。
(PECL ibm_db2 >= 1.0.0)
db2_conn_errormsg — 返回最后的连接错误消息和 SQLCODE 值
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
警告
如果在 php.ini 文件中指定了无效的 ibm_db2.instance_name,则编录的 db2_connect() 将失败并返回 false 值,当使用 db2_conn_error() 或 db2_conn_errormsg() 检查原因时,这些函数将返回空字符串。