Ejecuta una MongoDB Search query

Overview

En esta guía, puedes aprender a realizar búsquedas en los documentos utilizando la funcionalidad de MongoDB Search. La librería PHP permite realizar consultas de MongoDB Search utilizando el Constructor de agregación.

Para obtener más información sobre MongoDB Search, consulta el Resumen de MongoDB Search. La implementación de MongoDB Search para la librería PHP utiliza internamente el $search operador de agregación para realizar query. 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

Importa las siguientes clases en tu aplicación para realizar consultas de MongoDB Search mediante el Agregación Builder:

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

Para crear una etapa $search en tu pipeline de agregación, realiza las siguientes acciones:

1. Cree un arreglo para almacenar las etapas de la pipeline.

2. Llama al método Stage::search() para crear la etapa MongoDB Search.

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

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

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

Ejemplos de queries de MongoDB Search

En esta sección puedes aprender cómo realizar diferentes tipos de query MongoDB Search usando el Agregación Builder. Los ejemplos de esta sección utilizan datos de muestra de la colección sample_restaurants.restaurants.

$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 = [
    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

Se puede usar el método search() para ejecutar muchos tipos de consultas de query de MongoDB Search. Dependiendo de la query que desees realizar, puedes 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 referencia del operador $search en la documentación de Atlas.