函式名稱: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 協議的郵件伺服器。