查詢

imap_ping()函式—用法及示例

「 檢查與指定的郵件伺服器的連線是否仍然保持活動狀態 」


函式名稱:imap_ping()

適用版本:PHP 4, PHP 5, PHP 7

函式描述:imap_ping()函式用於檢查與指定的郵件伺服器的連線是否仍然保持活動狀態。它傳送一個NOOP命令(no-operation)到伺服器,以確保連線沒有斷開。

語法:bool imap_ping ( resource $imap_stream )

引數:

  • $imap_stream:必需,表示與郵件伺服器的連線的 IMAP 流。

返回值:

  • 如果連線仍然活動,則返回 true。
  • 如果連線已斷開,則返回 false。

示例:

// 連線到郵件伺服器
$imap_server = '{imap.example.com:993/imap/ssl}INBOX';
$username = 'your_username';
$password = 'your_password';
$imap_stream = imap_open($imap_server, $username, $password);

// 檢查連線是否仍然活動
if (imap_ping($imap_stream)) {
    echo "連線仍然活動";
} else {
    echo "連線已斷開";
}

// 關閉與郵件伺服器的連線
imap_close($imap_stream);

注意事項:

  • 在使用 imap_ping() 函式之前,必須先透過 imap_open() 函式建立與郵件伺服器的連線。
  • 如果連線已斷開,可以使用 imap_reopen() 函式重新開啟連線。
  • 該函式適用於使用 IMAP 協議的郵件伺服器。
補充糾錯
上一個函式: imap_qprint()函式
下一個函式: imap_open()函式
熱門PHP函式
分享連結