php man page for imap_ping

IMAP_PING(3)								 1							      IMAP_PING(3)

imap_ping - Check if the IMAP stream is still active

SYNOPSIS
       bool imap_ping (resource  $imap_stream)

DESCRIPTION
       imap_ping(3)  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
	      o $
		imap_stream -An IMAP stream returned by imap_open(3).

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

EXAMPLES
       Example #1

	      imap_ping(3) Example

	      <?php

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

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

	      ?>

PHP Documentation Group 													      IMAP_PING(3)