PHP: imap_ping - Manual

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

search for in the

imap_qprint imap_open

Last updated: Sat, 27 Jan 2007

view this page in

# imap_ping

(PHP 3, PHP 4, PHP 5)

imap_ping -- Check if the IMAP stream is still active

## Описание

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.

## Список параметров

`imap_stream`

  An IMAP stream returned by imap_open().

## Возвращаемые значения

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

## Примеры

Пример 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 User Contributed Notes
imap_ping
27-Dec-2002 04:28
`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.");
?>`
add a note
imap_qprint imap_open

Last updated: Sat, 27 Jan 2007
show source | credits | stats | sitemap | contact | advertising | mirror sites
Copyright © 2001-2007 The PHP Group
All rights reserved.
This mirror generously provided by: Yahoo! Inc.
Last updated: Sat Mar 10 09:32:46 2007 PST