略微加速

PHP官方手册 - 互联网笔记

PHP - Manual: MongoCommandCursor::timeout

2024-12-24

MongoCommandCursor::timeout

(PECL mongo >=1.6.0)

MongoCommandCursor::timeoutSets a client-side timeout for this command

说明

public MongoCommandCursor::timeout ( int $ms ) : MongoCommandCursor

A timeout can be set at any time and will affect subsequent data retrieval associated with this cursor, including fetching more results from the database.

参数

ms

The number of milliseconds for the cursor to wait for a response. Use -1 to wait forever. By default, the cursor will wait 30000 milliseconds (30 seconds).

返回值

This cursor.

错误/异常

Causes methods that fetch results to throw a MongoCursorTimeoutException if the data fetch takes longer than the specified number of milliseconds.

范例

Example #1 MongoCommandCursor::timeout() example

In the following example, the driver will wait for 60 seconds for the first response from the aggregate command. It will also wait for 60 seconds each time the server needs to be polled for more information.

<?php

$m 
= new MongoClient;
$col $m->database->collection;

$pipeline = [ … ];

$cursor $col->aggregateCursor$pipeline );
$cursor->timeout60000 ); // for 60 seconds

foreach ( $cursor as $result ) {
   

}

?>

注释

Warning

This does not cause the MongoDB server to cancel long-running operations; it only instructs the driver to stop waiting for a response and throw a MongoCursorTimeoutException after a set time. If you need to specify a server-side timeout for a command, considering passing the maxTimeMS option to MongoCollection::aggregateCursor().

参见

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.

官方地址:https://www.php.net/manual/en/mongocommandcursor.timeout.php

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