PDF (美式信紙) - 1.4Mb
PDF (A4) - 1.4Mb
int
mysql_ping(MYSQL *mysql)
檢查與伺服器的連線是否正常運作。如果連線已斷線且啟用自動重新連線,則會嘗試重新連線。如果連線斷線且停用自動重新連線,則 mysql_ping()
會傳回錯誤。
預設停用自動重新連線。若要啟用它,請使用 MYSQL_OPT_RECONNECT
選項 (已棄用) 呼叫 mysql_options()
。如需詳細資訊,請參閱 第 5.4.54 節,「mysql_options()」。
mysql_ping()
可讓閒置很久的用戶端用來檢查伺服器是否已關閉連線,並在必要時重新連線。
如果 mysql_ping()
) 確實導致重新連線,則不會明確指示。若要判斷是否發生重新連線,請在呼叫 mysql_ping()
之前呼叫 mysql_thread_id()
以取得原始連線識別碼,然後再次呼叫 mysql_thread_id()
,查看識別碼是否已變更。
如果發生重新連線,則連線的某些特性將會重設。如需這些特性的詳細資訊,請參閱 第 3.6.8 節,「自動重新連線控制」。
-
命令執行順序不正確。
-
MySQL 伺服器已關閉。
-
發生不明錯誤。