MongoCursor
PHP Manual

MongoCursor::immortal

(PECL mongo >=1.0.1)

MongoCursor::immortalDéfinit si le curseur doit s'interrompre après un certain délai

Description

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

Après un certain délai, le curseur, par défaut, "meurt". C'est en général le comportement que nous souhaitons. La base de données nettoie le curseur une fois que ses résultats ont été envoyés au client, mais si le client ne demande pas tous les résultats, le curseur sera toujours "vivant", prenant ainsi des ressources. Aussi, après quelques minutes, le curseur atteint son délai d'expiration et la base de données considère que le client a récupéré tout ce dont il avait besoin et supprime les ressources allouées à ce curseur.

Si, pour une raison particulière, vous avez besoin d'un délai plus important avant que le curseur ne meurt, vous pouvez empécher la base de données de le supprimer en utilisant cette méthode. Cependant, si vous rendez un curseur "immortel", vous devez parcourir tous ses résultats (ou, tout du moins, jusqu'à ce que la méthode MongoCursor::dead() retourne FALSE) ou bien le curseur sera pour toujours actif, prenant ainsi des ressources par toujours nécessaire.

Liste de paramètres

liveForever

Si le curseur doit être immortel, ou non.

Valeurs de retour

Returns this cursor.

Erreurs / Exceptions

Lance une exception MongoCursorException si le curseur a commencé à être parcouru.


MongoCursor
PHP Manual