Ejecutar una consulta de búsqueda de MongoDB

Overview

En esta guía, aprenderá a realizar búsquedas en sus documentos mediante la función de búsqueda de MongoDB. La biblioteca PHP le permite realizar consultas de búsqueda de MongoDB mediante... Constructor de agregaciones.

Para obtener más información sobre MongoDB Search, consulte Descripción general de la búsqueda de MongoDB. La implementación de la búsqueda de MongoDB para la biblioteca PHP utiliza internamente $search Operador de agregación para realizar consultas. Para obtener más información sobre este operador, consulte la referencia $search en la documentación de Atlas.

Etapa de agregación de búsqueda

Importe las siguientes clases a su aplicación para realizar consultas de búsqueda de MongoDB mediante el Generador de agregación:

use MongoDB\Builder\Pipeline;
use MongoDB\Builder\Search;
use MongoDB\Builder\Stage;

Para crear una etapa $search en su canal de agregación, realice las siguientes acciones:

1. Cree una instancia Pipeline para almacenar las etapas de la canalización.

2. Llame al método Stage::search() para crear la etapa de búsqueda de MongoDB.

3. Dentro del cuerpo del método search(), utilice métodos de la clase generadora Search para construir sus criterios de consulta de búsqueda.

El siguiente código demuestra la plantilla para construir consultas de búsqueda básicas de MongoDB:

$pipeline = new Pipeline(
    Stage::search(
        /* MongoDB Search query specifications
        Search::compound(...) */
    ),
);

Ejemplos de consultas de búsqueda de MongoDB

En esta sección, aprenderá a realizar diferentes tipos de consultas de búsqueda de MongoDB mediante el Generador de Agregaciones. Los ejemplos de esta sección utilizan datos de muestra de la colección sample_restaurants.restaurants.

$pipeline = new Pipeline(
    Stage::search(
        Search::compound(
            must: [
                Search::text(
                    query: 'kitchen',
                    path: 'name',
                ),
            ],
            should: [
                Search::text(
                    query: 'american',
                    path: 'cuisine',
                ),
            ],
            filter: [
                Search::text(
                    query: 'Queens',
                    path: 'borough',
                ),
            ],
        ),
    ),
    Stage::project(
        borough: 1,
        cuisine: 1,
        name: 1,
    ),
    Stage::limit(3),
);
$cursor = $collection->aggregate($pipeline);
foreach ($cursor as $doc) {
    echo json_encode($doc), PHP_EOL;
}

{"_id":...,"borough":"Queens","cuisine":"American","name":"Kitchen Door"}
{"_id":...,"borough":"Queens","cuisine":"American","name":"Cc Kitchen"}
{"_id":...,"borough":"Queens","cuisine":"American","name":"Suite Kitchen"}
// Results truncated

$pipeline = new Pipeline(
    Stage::search(
        Search::autocomplete(
            query: 'Lucy',
            path: 'name',
        ),
    ),
    Stage::limit(3),
    Stage::project(_id: 0, name: 1),
);
$cursor = $collection->aggregate($pipeline);
foreach ($cursor as $doc) {
    echo json_encode($doc), PHP_EOL;
}

{"name":"Juicy Lucy"}
{"name":"Lucy'S Vietnamese Kitchen"}
{"name":"Lucy'S Cantina Royale"}
// Results Truncated

opciones de búsqueda

Puede usar el método search() para realizar diversos tipos de consultas de búsqueda de MongoDB. Según la consulta deseada, puede pasar los siguientes parámetros opcionales a search():

Para obtener más información sobre estos parámetros, consulte la sección Campos de la $search referencia del operador en la documentación de Atlas.