MongoCollection::findAndModify »

« MongoCollection::ensureIndex

Edit Report a Bug

MongoCollection::find

(PECL mongo >=0.9.0)

MongoCollection::find — Consulta esta colección, devolviendo un objeto MongoCursor para el conjunto de resultados

Descripción

public MongoCollection::find ([ array $query = array() [, array $fields = array() ]] ) : MongoCursor

Parámetros

query: Los campos en los que buscar. El lenguaje de consultas de MongoDB es bastante extenso. El controlador de PHP, en la mayoría de los casos, pasará la consulta directamente al servidor, por lo que es una buena idea leer el manual de MongoDB sobre » find.

Advertencia
Asegúrese de que en todos los operadores de consulta especiales (los que empiezan con $) se usen comillas simples, ya que así PHP no intentará reemplazar "$exists" con el valor de la variable $exists.
fields: Campos del resultado que se devolverán. El array está en el formato array('nombrecampo' => true, 'nombrecampo2' => true). El campo _id se devuelve siempre.

Valores devueltos

Devuelve un cursor para los resultados de la búsqueda.

Ejemplos

Ejemplo #1 Ejemplo de MongoCollection::find()

Este ejemplo demuestra las opciones de búsqueda básica.


<?php

$m = new MongoClient();
$db = $m->selectDB('test');
$collection = new MongoCollection($db, 'produce');

// buscar frutas
$fruitQuery = array('Type' => 'Fruit');

$cursor = $collection->find($fruitQuery);
foreach ($cursor as $doc) {
    var_dump($doc);
}

// buscar los que son dulces. Taste es un hijo de Details. 
$sweetQuery = array('Details.Taste' => 'Sweet');
echo "Sweet\n";
$cursor = $collection->find($sweetQuery);
foreach ($cursor as $doc) {
    var_dump($doc);
}

?>

El resultado del ejemplo sería:

array(4) {
  ["_id"]=>
  object(MongoId)#7 (1) {
    ["$id"]=>
    string(24) "50a87dd084f045a19b220dd6"
  }
  ["Name"]=>
  string(5) "Apple"
  ["Type"]=>
  string(5) "Fruit"
  ["Details"]=>
  array(2) {
    ["Taste"]=>
    string(5) "Sweet"
    ["Colour"]=>
    string(3) "Red"
  }
}
array(4) {
  ["_id"]=>
  object(MongoId)#8 (1) {
    ["$id"]=>
    string(24) "50a87de084f045a19b220dd7"
  }
  ["Name"]=>
  string(5) "Lemon"
  ["Type"]=>
  string(5) "Fruit"
  ["Details"]=>
  array(2) {
    ["Taste"]=>
    string(4) "Sour"
    ["Colour"]=>
    string(5) "Green"
  }
}

Sweet:
array(4) {
  ["_id"]=>
  object(MongoId)#7 (1) {
    ["$id"]=>
    string(24) "50a87dd084f045a19b220dd6"
  }
  ["Name"]=>
  string(5) "Apple"
  ["Type"]=>
  string(5) "Fruit"
  ["Details"]=>
  array(2) {
    ["Taste"]=>
    string(5) "Sweet"
    ["Colour"]=>
    string(3) "Red"
  }
}

Véase MongoCursor para más información sobre cómo trabajar con cursores.

Ejemplo #2 Ejemplo de MongoCollection::find()

Este ejemplo muestra como buscar en un rango.


<?php

$m = new MongoClient();
$db = $m->selectDB('test');
$colección = new MongoCollection($db, 'phpmanual');

// buscar documentos donde 5 < x < 20
$rangeQuery = array('x' => array( '$gt' => 5, '$lt' => 20 ));

$cursor = $colección->find($rangeQuery);
foreach ($cursor as $doc) {
    var_dump($doc);
}

?>

El resultado del ejemplo sería:

array(2) {
  ["_id"]=>
  object(MongoId)#10 (1) {
    ["$id"]=>
    string(24) "4ebc3e3710b89f2349000000"
  }
  ["x"]=>
  int(12)
}
array(2) {
  ["_id"]=>
  object(MongoId)#11 (1) {
    ["$id"]=>
    string(24) "4ebc3e3710b89f2349000001"
  }
  ["x"]=>
  int(12)
}

Véase MongoCursor para más información sobre cómo trabajar con cursores.

Ejemplo #3 Ejemplo de MongoCollection::find() usando $where

Este ejemplo demuestra cómo buscar en una colección usando código javascript para reducir el conjunto de resultados.


<?php

$m = new MongoClient();
$db = $m->selectDB('test');
$colección = new MongoCollection($db, 'phpmanual');

$js = "function() {
    return this.name == 'Joe' || this.age == 50;
}";
$cursor = $colección->find(array('$where' => $js));
foreach ($cursor as $doc) {
    var_dump($doc);
}

?>

El resultado del ejemplo sería:

array(3) {
  ["_id"]=>
  object(MongoId)#7 (1) {
    ["$id"]=>
    string(24) "4ebc3e3710b89f2349000002"
  }
  ["name"]=>
  string(3) "Joe"
  ["age"]=>
  int(20)
}

Ejemplo #4 Ejemplo de MongoCollection::find() usando $in

Este ejemplo demuestra cómo buscar una colección usando el operador $in.


<?php

$m = new MongoClient();
$db = $m->selectDB('test');
$colección = new MongoCollection($db, 'phpmanual');

$cursor = $colección->find(array(
    'name' => array('$in' => array('Joe', 'Wendy'))
));

?>

El resultado del ejemplo sería:

array(3) {
  ["_id"]=>
  object(MongoId)#7 (1) {
    ["$id"]=>
    string(24) "4ebc3e3710b89f2349000002"
  }
  ["name"]=>
  string(3) "Joe"
  ["age"]=>
  int(20)
}

Ejemplo #5 Obtener resultados en forma de array

Devuelve un MongoCursor. A menudo, los principiantes se sienten más cómodos usando arrays. Para convertir un cursor en un array, utilice la función iterator_to_array().


<?php

$m = new MongoClient();
$db = $m->selectDB('test');
$colección = new MongoCollection($db, 'phpmanual');

$cursor = $colección->find();
$array = iterator_to_array($cursor);

?>

El resultado del ejemplo sería:

array(3) {
  ["4ebc40af10b89f5149000000"]=>
  array(2) {
    ["_id"]=>
    object(MongoId)#6 (1) {
      ["$id"]=>
      string(24) "4ebc40af10b89f5149000000"
    }
    ["x"]=>
    int(12)
  }
  ["4ebc40af10b89f5149000001"]=>
  array(2) {
    ["_id"]=>
    object(MongoId)#11 (1) {
      ["$id"]=>
      string(24) "4ebc40af10b89f5149000001"
    }
    ["x"]=>
    int(12)
  }
  ["4ebc40af10b89f5149000002"]=>
  array(3) {
    ["_id"]=>
    object(MongoId)#12 (1) {
      ["$id"]=>
      string(24) "4ebc40af10b89f5149000002"
    }
    ["name"]=>
    string(3) "Joe"
    ["age"]=>
    int(20)
  }
}

Al usar iterator_to_array() se fuerza a que el controlador cargue todos los resultados en memoria. ¡No lo use cuando el resultado supere el tamaño máximo de memoria!

Además, algunas colecciones del sistema no tienen un campo _id. Si se trabaja con colecciones que pudieran tener documentos sin _ids, establezca FALSE el segundo argumento de iterator_to_array() (así, no tratará de usar como clave el valor del campo _id inexistente).

Ver también

MongoCollection::findOne() - Realiza una consulta a esta colección, devolviendo sólo un elemento
MongoCollection::insert() - Inserta un documento en la colección
Documentación de MongoDB sobre » find.

User Contributed Notes 5 notes

up

down

7

nospam at alexyves dot fr ¶

14 years ago


This will work with versions >=1.5.3, please note that this is just a example of the way to use the or statement.

<?php
  $connection = new Mongo();

  $db = $connection->test;
  $collection = $db->test;
  // Clean the DB before the test.
  $collection->drop();
  $collection = $db->test;

  $apple = array(
    'fruit' => 'Apple',
    'type' => 'Juice',
  );

  $orange = array(
    'fruit' => 'Orange',
    'type' => 'Marmalade',
  );

  $collection->insert($apple);
  $collection->insert($orange);

  // Basic find
  $results = $collection->find(array('fruit' => 'Apple'));

  foreach($results as $result)
  {
    echo sprintf("Fruit: %s, Type: %s%s", $result['fruit'], $result['type'], PHP_EOL);
  }
?>

Output:

Fruit: Apple, Type: Juice

Now an advanced search with "or" statement.

<?php
  // Advanced find with "OR" note the double array.
  // if you use double quotes escape the or "\$or"
  $results = $collection->find( array( '$or' => array( array('fruit' => 'Apple'), array('fruit' => 'Orange') ) ) );

  foreach($results as $result)
  {
    echo sprintf("Fruit: %s, Type: %s%s", $result['fruit'], $result['type'], PHP_EOL);
  }
?>

Output:

Fruit: Apple, Type: Juice
Fruit: Orange, Type: Marmalade

up

down

7

Nanhe Kumar ¶

11 years ago


<?php
$m = new MongoClient();
$db = $m->selectDB('school');
$collection = new MongoCollection($db, 'student');
//Find where class=5
$where=array('class'=>5);
$cursor = $collection->find($where);

//Find where class !=5
$where=array('class' => array('$ne'=>5));
$cursor = $collection->find($where);

//Find where age >20
$where=array('age' => array('$gt'=>20));
$cursor = $collection->find($where);

//Find where age >=20
$where=array('age' => array('$gte'=>20));
$cursor = $collection->find($where);

//Find where age <20
$where=array('age' => array('$le'=>20));
$cursor = $collection->find($where);

//Find where age <=20
$where=array('age' => array('$lte'=>20));
$cursor = $collection->find($where);

//Finc where class=10 or marks=80
$where=array( '$or' => array( array(' class' =>10), array('marks'=>80) ) );
$cursor = $collection->find($where);
//Finc where class=12 AND marks=70
$where=array( '$and' => array( array(' class' =>12), array('marks'=>70) ) );
$cursor = $collection->find($where);

?>

up

down

3

artusdebenque at yahoo dot fr ¶

11 years ago


For the fields parameter, the documentaion says: "The _id field is always returned".
Knowing that mongodb allows you to uncheck the _id field ("the _id field is the only field that you can explicitly exclude"; source: http://docs.mongodb.org/manual/reference/method/db.collection.find/#db.collection.find), I tried it with php and it works : you can exclude the _id field.

Example : the following fields parameter will exclude the field "_id"

$fields = array('timestamp' => true, 'rank' => true, '_id' => false);

up

down

2

bronius dot motekaitis at gmail dot com ¶

9 years ago


As the docs specify, '$or' conditions (and similar) get passed right on to MongoDB directly. It appears that to make a simple "field, $or, field" compound query work, all parts must be wrapped as a gigantic $and.
Here's how I got a find(), findOne(), and findAndModify() to obey such a compound $or for matching on fields, one of which is represented in data as either a string or integer:
<?php
  $query = 
    array('$and' =>
      array(
        array('assessment_id' => $doc->assessment_id),
        array('$or' =>
          array(
            array('participant_id' => $doc->participant_id),
            array('participant_id' => (string)$doc->participant_id),
          ),
        ),
        array('measure_id' => $doc->measure_id)
      ),
    );
  $thedoc = $collection->findOne($query);
  return $thedoc;
?>

up

down

-6

vsaurabh dot aec at gmail dot com ¶

8 years ago


example of sort and find

$client = new MongoDB\Client("mongodb://localhost:27017");
$product = $client->db->product;
$filter = [];
$options = ['sort' => ['catid' => 1], 'limit' => 10];
$list = $product->find($filter, $options);