MongoCursor::tailable - Sets whether this cursor will be left open after fetching the last results
Вернуться к: MongoCursor
MongoCursor::tailable
(PECL mongo >=0.9.4)
MongoCursor::tailable — Sets whether this cursor will be left open after fetching the last results
Описание
Mongo has a feature known as tailable cursors which are similar to the Unix "tail -f" command.
Tailable means cursor is not closed when the last data is retrieved. Rather, the cursor marks the final object's position. you can resume using the cursor later, from where it was located, if more data were received.
Like any "latent cursor", the cursor may become invalid at some point -- for example if that final object it references were deleted. Thus, you should be prepared to requery if the cursor is MongoCursor::dead().
Список параметров
-
tail
-
If the cursor should be tailable.
Возвращаемые значения
Returns this cursor.
Ошибки
Throws MongoCursorException if this cursor has started iterating.
Примеры
Пример #1 MongoCursor::tailable() example
<?php
$cursor = $collection->find()->tailable();
$results = array();
while (1) {
if (!$cursor->hasNext()) {
// we've read all the results, exit
if ($cursor->dead()) {
break;
}
// read all results so far, wait for more
sleep(10);
}
else {
$results[] = $cursor->getNext();
}
}
?>
Смотрите также
MongoDB core docs on » tailable cursors.
- MongoCursor::awaitData() - Sets whether this cursor will wait for a while for a tailable cursor to return more data
Вернуться к: MongoCursor