(PECL ibm_db2 >= 1.0.0)
db2_conn_error — 傳回一個字串，其中包含上次連線嘗試所傳回的 SQLSTATE
db2_conn_error() 會傳回一個 SQLSTATE 值，表示上次嘗試連線到資料庫失敗的原因。由於 db2_connect() 在連線嘗試失敗時會傳回 false，因此您不需要傳遞任何參數給 db2_conn_error() 即可取得 SQLSTATE 值。
然而，如果連線一開始成功，但隨著時間推移而失效，您可以傳遞 connection 參數來取得特定連線的 SQLSTATE 值。
若要了解 SQLSTATE 值的含義，您可以在 DB2 命令列處理器提示符號下發出以下指令：db2 '? 。您也可以呼叫 db2_conn_errormsg() 來取得明確的錯誤訊息和相關的 SQLCODE 值。sqlstate-value'
connection與一開始成功但隨著時間推移而失效的連線相關聯的連線資源。
傳回連線嘗試失敗所產生的 SQLSTATE 值。如果上次連線嘗試沒有相關錯誤，則傳回空字串。
範例 #1 取得連線嘗試失敗的 SQLSTATE 值
以下範例示範如何在故意傳遞無效參數給 db2_connect() 後傳回 SQLSTATE 值。
<?php
$conn = db2_connect('badname', 'baduser', 'badpassword');
if (!$conn) {
print "SQLSTATE 值: " . db2_conn_error();
}
?>上述範例將輸出
SQLSTATE value: 08001