略微加速

PHP官方手册 - 互联网笔记

PHP - Manual: MongoCursor::tailable

2024-12-25

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.

范例

Example #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.

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.

官方地址:https://www.php.net/manual/en/mongocursor.tailable.php

北京半月雨文化科技有限公司.版权所有 京ICP备12026184号-3