PHP Manual
后退 |  | 前进

# db2_conn_error

(no version information, might be only in CVS)

db2_conn_error -- Returns a string containing the SQLSTATE returned by the last connection attempt

## 说明

string db2_conn_error ( [resource connection] )

警告
本函数是实验性的。本函数的行为，包括函数名称以及其它任何关于本函数的文档可能会在没有通知的情况下随 PHP 以后的发布而改变。使用本函数风险自担。

db2_conn_error() returns an SQLSTATE value representing the reason the last attempt to connect to a database failed. As db2_connect() returns `FALSE` in the event of a failed connection attempt, you do not pass any parameters to db2_conn_error() to retrieve the SQLSTATE value.

If, however, the connection was successful but becomes invalid over time, you can pass the connection parameter to retrieve the SQLSTATE value for a specific connection.

To learn what the SQLSTATE value means, you can issue the following command at a DB2 Command Line Processor prompt: `db2 '? sqlstate-value'`. You can also call db2_conn_errormsg() to retrieve an explicit error message and the associated SQLCODE value.

## 参数

connection

  A connection resource associated with a connection that initially succeeded, but which over time became invalid.

## 返回值

Returns the SQLSTATE value resulting from a failed connection attempt. Returns an empty string if there is no error associated with the last connection attempt.

## 例

例子 1. Retrieving an SQLSTATE value for a failed connection attempt

The following example demonstrates how to return an SQLSTATE value after deliberately passing invalid parameters to db2_connect().

`<?php $conn = db2_connect('badname', 'baduser', 'badpassword'); if (!$conn) { print "SQLSTATE value: " . db2_conn_error(); } ?>`

上例将输出：

    SQLSTATE value: 08001

## 参见

db2_conn_errormsg()
db2_connect()
db2_stmt_error()
db2_stmt_errormsg()

后退 | 起点 | 前进
db2_commit | 上一级 | db2_conn_errormsg