注意事項
如果您在 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
,因此在擷取相關聯的錯誤訊息和 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
注意事項
如果您在 php.ini 檔案中指定了無效的 ibm_db2.instance_name,則您的已編目 db2_connect() 將會失敗,並傳回 false 值,當您使用 db2_conn_error() 或 db2_conn_errormsg() 檢查原因時,這些函式將會傳回空字串。