PHP Doku:: Returns a string containing the SQLSTATE returned by the last connection attempt - function.db2-conn-error.html

Verlauf / Chronik / History: (1) anzeigen

Sie sind hier:
Doku-StartseitePHP-HandbuchFunktionsreferenzDatenbankerweiterungenAnbieterspezifische DatenbankerweiterungenIBM DB2, Cloudscape and Apache DerbyIBM DB2 Funktionendb2_conn_error

Ein Service von Reinhard Neidl - Webprogrammierung.

IBM DB2 Funktionen




(PECL ibm_db2 >= 1.0.0)

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


string db2_conn_error ([ resource $connection ] )

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.



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.


Beispiel #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().

if (!
$conn) {
"SQLSTATE value: " db2_conn_error();

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

SQLSTATE value: 08001

Siehe auch

Keine BenutzerBeiträge.
- Beiträge aktualisieren...

PHP Powered Diese Seite bei
The PHP manual text and comments are covered by the Creative Commons Attribution 3.0 License © the PHP Documentation Group - Impressum - mail("TO:Reinhard Neidl",...)