php man page for imap_alerts

IMAP_ALERTS(3)								 1							    IMAP_ALERTS(3)

imap_alerts - Returns all IMAP alert messages that have occurred

SYNOPSIS
       array imap_alerts (void	)

DESCRIPTION
	Returns all of the IMAP alert messages generated since the last imap_alerts(3) call, or the beginning of the page.

	When  imap_alerts(3)  is called, the alert stack is subsequently cleared. The IMAP specification requires that these messages be passed to
       the user.

RETURN VALUES
	Returns an array of all of the IMAP alert messages generated or FALSE if no alert messages are available.

SEE ALSO
       imap_errors(3).

PHP Documentation Group 													    IMAP_ALERTS(3)