MongoCursor::info

(PECL mongo >=1.0.5)

MongoCursor::info — Obtiene la información sobre la creación e iteración del cursor

Descripción

public MongoCursor::info ( void ) : array

Se puede invocar antes o después de haber empezao a iterar el cursor.

Parámetros

Esta función no tiene parámetros.

Valores devueltos

Devuelve el espacio de nombres, tamaño del lote, límite, salto, banderas, consulta, y campos protegidos de este cursor. Si el cursor ha empezado a iterar, se incluirá información adicional sobre la iteración y la conexión.

Historial de cambios

Versión Descripción
1.1.0 Se añadieron varios campos, incluyendo id (el id del cursor), at (la cuenta del contador de cual es el documento actual), numReturned (el número devuelto por el servidor del lote actual), y server (el servidor al que se le envió la consulta; útil junto con Preferencias de lectura.
1.0.10 Se añadió el campo started_iterating, un booleano que indica si el cursor es preconsulta o postconsulta.

Ejemplos

Ejemplo #1 Ejemplo de MongoCursor::info()

<?php
$m = new MongoClient();

$cursor = $m->test->foo->find(array("x" => 4), array("y" => 0));

echo "Antes de iniciar la iteración:\n";
var_dump($cursor->info());

echo "\nDespués de iniciar la iteración:\n";
$cursor->rewind();
var_dump($cursor->info());

?>

El resultado del ejemplo sería algo similar a:

Antes de iniciar la iteración:
array(8) {
  ["ns"]=>
  string(8) "test.foo"
  ["limit"]=>
  int(0)
  ["batchSize"]=>
  int(0)
  ["skip"]=>
  int(0)
  ["flags"]=>
  int(0)
  ["query"]=>
  array(1) {
    ["x"]=>
    int(4)
  }
  ["fields"]=>
  array(1) {
    ["y"]=>
    int(0)
  }
  ["started_iterating"]=>
  bool(false)
}

Después de iniciar la iteración:
array(15) {
  ["ns"]=>
  string(8) "test.foo"
  ["limit"]=>
  int(0)
  ["batchSize"]=>
  int(0)
  ["skip"]=>
  int(0)
  ["flags"]=>
  int(0)
  ["query"]=>
  array(1) {
    ["x"]=>
    int(4)
  }
  ["fields"]=>
  array(1) {
    ["y"]=>
    int(0)
  }
  ["started_iterating"]=>
  bool(true)
  ["id"]=>
  int(0)
  ["at"]=>
  int(0)
  ["numReturned"]=>
  int(1)
  ["server"]=>
  string(25) "localhost:27017;-;.;26450"
  ["host"]=>
  string(9) "localhost"
  ["port"]=>
  int(27017)
  ["connection_type_desc"]=>
  string(10) "STANDALONE"
}

Ver también