MongoCursor::maxTimeMS

(PECL mongo >=1.5.0)

MongoCursor::maxTimeMS — Sets a server-side timeout for this query

Описание

public MongoCursor MongoCursor::maxTimeMS ( int $ms )

Specifies a cumulative time limit in milliseconds to be allowed by the server for processing operations on the cursor.

Список параметров

ms

- Specifies a cumulative time limit in milliseconds to be allowed by the server for processing operations on the cursor.

Возвращаемые значения

This cursor.

Ошибки

Throws MongoCursorException if this cursor has started iterating.

Causes methods that fetch results to throw a MongoExecutionTimeoutException if the query takes longer than the specified number of milliseconds in processing time.

Примеры

Пример #1 MongoCursor::maxTimeMS() example

In the following example, the server will abort the query if the cursor requires more than two seconds in processing time to return its results.

$cursor = $collection->find();
$cursor->maxTimeMS(2000);
try {
    $results = iterator_to_array($cursor);
} catch (MongoExecutionTimeoutException $e) {
    echo "query took too long!";
}

Примечания

Внимание

Unlike MongoCursor::timeout(), which specifies a client-side timeout, MongoCursor::maxTimeMS() can be used to cause the MongoDB server to abort long-running queries. This timeout is cumulative for the lifetime of the cursor (i.e. each batch will contribute to this time limit). The timeout only considers processing time; idle time is not considered.

User Contributed Notes

There are no user contributed notes for this page.

Описание класса mongocursor, примеры использования класса mongocursor.

Смотрите также:
Описание на ru2.php.net
Описание на php.ru