2024 年 PHP Conference Japan

db2_conn_errormsg

(PECL ibm_db2 >= 1.0.0)

db2_conn_errormsg 傳回最後一個連線錯誤訊息和 SQLCODE 值

說明

db2_conn_errormsg(?資源 $connection = null): 字串

db2_conn_errormsg() 會傳回一個錯誤訊息和 SQLCODE 值,表示上次資料庫連線嘗試失敗的原因。由於 db2_connect() 在連線嘗試失敗時會傳回 false,因此在擷取相關聯的錯誤訊息和 SQLCODE 值時,不要傳遞任何參數給 db2_conn_errormsg()

然而,如果連線一開始成功,但隨著時間推移而失效,您可以傳遞 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

另請參閱

新增註解

使用者貢獻的註解 1 則註解

0
nnd100216ibmdb2 at smallcue dot com
14 年前
注意事項

如果您在 php.ini 檔案中指定了無效的 ibm_db2.instance_name,則您的已編目 db2_connect() 將會失敗,並傳回 false 值,當您使用 db2_conn_error() 或 db2_conn_errormsg() 檢查原因時,這些函式將會傳回空字串。
To Top