MongoCursor::immortal

(PECL mongo >=1.0.1)

MongoCursor::immortalУстанавливает, будет ли курсор отключен

Описание

public MongoCursor::immortal ([ bool $liveForever = TRUE ] ) : MongoCursor

После некоторого времени простоя на сервере курсоры по умолчанию "умирают". Как правило, это то, что вам нужно. База данных очищает курсор после того, как все его результаты отправлены клиенту, но если клиент не запрашивает все результаты, курсор будет там затихать, занимая ресурсы. Таким образом, через несколько минут курсор "отключается", и база данных предполагает, что клиент получил все, что ему нужно, и очищает ресурсы курсора.

Если по какой-то причине вам нужен курсор, чтобы долго зависать, вы можете предотвратить очистку базы данных с помощью этого метода. Однако, если вы сделаете курсор вечным, вам нужно будет перебирать все его результаты (или, по крайней мере, до тех пор, пока MongoCursor::dead() не вернет TRUE), или курсор будет зависать в базе данных вечно, занимая ресурсы.

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

liveForever

Если курсор должен быть вечным.

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

Возвращает курсор.

Ошибки

Выдает исключение MongoCursorException, если этот курсор начал итерацию.