MongoCursor::immortal

(PECL mongo >=1.0.1)

MongoCursor::immortalEstablece si este cursor expirará

Descripción

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

Después de permanecer inactivo en el servidor por algún tiempo, los cursores, por omisión, "mueren". Este es el compotamiento general que se desea. La base de datos limpia un cursor una vez que todos sus resultados han sido enviados al cliente, pero si el cliente no solicita todos los resultados, el cursor decaerá en ese momento, tomando recursos. Por lo tanto, después de unos minutos, el cursor "expira" y la base de datos asume que el cliente ha obtenido todo lo que necesita, y limpia los recursos del cursor.

Si, por cualquier motivo, fuera necesario que un cursor espere durante más tiempo, se puede evitar que la base de datos lo limpie usando este método. Sin embargo, si se hace inmortal a un cursor, es necesario iterar a través de todos sus resultados (o al menos hasta que MongoCursor::dead() devuelva TRUE) o el cursor esperará a la base de datos para siempre, tomando recursos.

Parámetros

liveForever

Si el cursor debería ser inmortal.

Valores devueltos

Devuelve este cursor.

Errores/Excepciones

Lanza una MongoCursorException si este cursor ha empezado a iterar.