PDF (US Ltr) - 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 伺服器已關閉。
-
發生未知錯誤。