imap_ping

(PHP 4, PHP 5)

imap_ping — Vérifie que le flux IMAP est toujours actif

Description

bool imap_ping ( resource $imap_stream )

Vérifie que le flux est toujours actif, en lui envoyant un ping. Cette fonction permet de se rendre compte qu'un mail est arrivé : c'est même la méthode préconisée pour des tests périodiques de vérification du courrier. Cette fonction peut aussi servir à garder une connexion ouverte, avec les serveurs dotés d'un délai d'expiration.

Liste de paramètres

imap_stream: Un flux IMAP retourné par la fonction imap_open().

Valeurs de retour

Retourne TRUE si le flux est toujours actif, FALSE sinon.

Exemples

Exemple #1 Exemple avec imap_ping()

<?php

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

// après une pause
if (!imap_ping($imap)) {
	// effectuez un traitement pour se reconnecter
}

?>