MongoClient::killCursor
(PECL mongo >=1.5.0)
MongoClient::killCursor — Разрушает определенный курсор на сервере
Расширение, задающее этот метод, объявлено устаревшим. Вместо него используйте расширение MongoDB. Никакой замены данному методу не предусмотрено.
Описание
В определенных ситуациях может потребоваться разрушить курсор на сервере. Обычно время ожидания курсора истекает после 10 минут бездействия, но возможно создать вечный курсор с MongoCursor::immortal(), который никогда не истекает. Чтобы иметь возможность разрушить такой вечный курсор, вы можете вызвать этот метод с информацией, предоставленной MongoCursor::info().
Список параметров
-
server_hash -
Хеш сервера с курсором. Может быть получено через MongoCursor::info().
-
id -
Идентификатор курсора для разрушения. Вы можете предоставить либо int, содержащий 64-битный идентификатор курсора, либо объект класса MongoInt64.
Возвращаемые значения
Возвращает true, если метод пытался разрушить курсор, и false,
если с аргументами было что-то не так (например, неправильный server_hash).
Статус возврата не отражает, где курсор был фактически разрушен, поскольку сервер не предоставляет эту информацию.
Ошибки
Метод отображает предупреждение, если предоставленный server_hash
не совпадает с существующим соединением. В этом случае также не предпринимаются попытки разрушить курсор.
Примеры
Пример #1 Пример использования MongoClient::killCursor()
В этом примере показано, как подключиться, выполнить запрос, получить информацию о курсоре и затем разрушить его.
<?php
$m = new MongoClient();
$c = $m->testdb->collection;
$cursor = $c->find();
$result = $cursor->next();
// Теперь курсор корректен, поэтому мы можем получить хеш и идентификатор:
$info = $cursor->info();
// Разрушаем курсор
MongoClient::killCursor( $info['server'], $info['id'] );
?>