downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | conferences | my php.net

search for in the

imap_qprint> <imap_open
[edit] Last updated: Fri, 26 Apr 2013

view this page in

imap_ping

(PHP 4, PHP 5)

imap_pingCheck if the IMAP stream is still active

Description

bool imap_ping ( resource $imap_stream )

imap_ping() pings the stream to see if it's still active. It may discover new mail; this is the preferred method for a periodic "new mail check" as well as a "keep alive" for servers which have inactivity timeout.

Parameters

imap_stream

An IMAP stream returned by imap_open().

Return Values

Returns TRUE if the stream is still alive, FALSE otherwise.

Examples

Example #1 imap_ping() Example

<?php

$imap 
imap_open("{imap.example.org}""mailadmin""password");

// after some sleeping
if (!imap_ping($imap)) {
    
// do some stuff to reconnect
}

?>



add a note add a note User Contributed Notes imap_ping - [1 notes]
up
0
Anonymous
10 years ago
This is a great solution for a webmail class if you want to make sure that a user is still logged in. Example:

<?php
if(!(imap_ping($stream)) {
die(
"The user is no longer logged in.");
?>

 
show source | credits | stats | sitemap | contact | advertising | mirror sites