MongoCursor::tailable

(PECL mongo >=0.9.4)

MongoCursor::tailable — Définit si le curseur doit être conservé ouvert après la récupération du dernier résultat

Description

public MongoCursor MongoCursor::tailable ([ bool $tail = true ] )

Mongo a une fonction permettant de voir le contenu du curseur en temps réel, similaire à la commande Unix "tail -f".

En utilisant cette fonctionnalité, le curseur n'est pas fermé lorsque le dernier résultat est récupéré. Au lieu de cela, le curseur marque la position du dernier objet. Vous pouvez ainsi utiliser plus tard ce curseur, depuis sa position courante, si d'autres données sont reçues.

Comme tous les curseurs latents, le curseur devient non valide à certain point, par exemple, lorsque la référence de l'objet final est effacée. Ainsi, vous devez être prêt à effectuer une nouvelle requête si le curseur est mort.

Liste de paramètres

tail: Si le curseur doit être consulté en temps réel.

Valeurs de retour

Returns this cursor.

Erreurs / Exceptions

Lance une exception MongoCursorException si le curseur a commencé à être parcouru.

Exemples

Exemple #1 Exemple avec MongoCursor::tailable()

<?php

$cursor = $collection->find()->tailable();

$results = array();

while (1) {
	if (!$cursor->hasNext()) {
		// Nous avons lu tous les résultats, on peut sortir
		if ($cursor->dead()) {
			break;
		}
		// On lit tous les résultats, et on attend les suivants
		sleep(10);
	}
	else {
		$results[] = $cursor->getNext();
	}
}

?>

Voir aussi

Documentation MongoDB sur les » curseurs.

MongoCursor::awaitData() - Définit si le curseur doit attendre un curseur tailable pour retourner plus de données