Php/docs/mongocursor.tailable

提供:Dev Guides
< Php
2020年12月14日 (月) 11:14時点におけるNotes (トーク | 投稿記録)による版 (autoload)
(差分) ← 古い版 | 最新版 (差分) | 新しい版 → (差分)
移動先:案内検索

MongoCursor::tailable

(PECL mongo >=0.9.4)

MongoCursor::tailableSets whether this cursor will be left open after fetching the last results


説明

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

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.