db2_conn_errormsg
(PECL ibm_db2 >= 1.0.0)
db2_conn_errormsg — 直近の接続エラーメッセージおよび SQLCODE を返す
説明
db2_conn_errormsg() は、データベースへの直近の接続が
失敗した原因を表す SQLCODE およびエラーメッセージを返します。
接続が失敗した場合には、db2_connect() は false
を返します。
この場合、エラーメッセージおよび SQLSTATE の値を取得するために
db2_conn_errormsg() に何もパラメータを渡す必要はありません。
しかし、接続は成功したもののその後に無効になった場合は、
パラメータ connection
を指定することで
特定の接続についてのエラーメッセージおよび SQLSTATE を取得することができます。
パラメータ
connection
-
当初は成功したものの、その後に無効になった接続に 関連付けられた接続リソース。
戻り値
失敗した接続試行の結果を表すエラーメッセージおよび SQLSTATE を返します。 直近の接続試行に関連するエラーがない場合には、 db2_conn_errormsg() はn空の文字列を返します。
例
例1 失敗した接続試行からのエラーメッセージの取得
以下の例では、db2_connect() に わざと無効なパラメータを渡し、エラーメッセージおよび SQLSTATE を取得しています。
<?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 文のエラーメッセージを含む文字列を返す
+add a note
User Contributed Notes 1 note
nnd100216ibmdb2 at smallcue dot com ¶
14 years ago
A word of warning:
It appears that if you specify an invalid ibm_db2.instance_name in your php.ini file, your cataloged db2_connect() will fail with a returned value of false and when you use db2_conn_error() or db2_conn_errormsg() to check on the reason, those functions will return an empty string.
↑ and ↓ to navigate •
Enter to select •
Esc to close
Press Enter without
selection to search using Google