Crea un cliente de MongoDB

Overview

Para conectarse a una implementación de MongoDB, debe crear los siguientes elementos:

• URI de conexión, también conocido como cadena de conexión, que le indica a la librería de PHP a qué implementación de MongoDB conectarse.

• MongoDB\Client objeto, que crea la conexión a la implementación de MongoDB y te permite realizar operaciones en ella.

También puedes establecer opciones dentro de uno o ambos de estos componentes para personalizar la forma en que la librería PHP se comporta mientras está conectada a MongoDB.

Esta guía describe los componentes de una cadena de conexión y muestra cómo utilizar una MongoDB\Client objeto para conectarse a una implementación de MongoDB.

URI de conexión

Una cadena de conexión estándar incluye los siguientes componentes:

Para obtener más información sobre las cadenas de conexión, consulta Cadenas de conexión en el Manual del servidor.

Crear un MongoDB\Client

Para crear una conexión a MongoDB, construye un objeto MongoDB\Client. Pasa los siguientes parámetros al constructor MongoDB\Client:

• $uri": establece el URI de conexión."

• $uriOptions: (Opcional) Establece las opciones de URI para configurar cómo se conecta el cliente a MongoDB, incluyendo las credenciales de autenticación y la configuración de selección de servidor. Si establece las mismas opciones en este parámetro y en la cadena de conexión, los $uriOptions valores prevalecen. Para ver una lista completa de las opciones compatibles, consulte la guía "Especificar opciones de conexión".

• $driverOptions: (Opcional) Establece opciones para configurar el comportamiento de la extensión PHP subyacente, incluyendo la configuración de cifrado de datos y las opciones de validación de certificados para las conexiones TLS. Para ver una lista completa de opciones admitidas, consulte MongoDB\Client::__construct() en la documentación de la API.

<?php
$uri = 'mongodb://localhost:27017';
$uriOptions = ['serverSelectionTimeoutMS' => 10000];
$client = new MongoDB\Client($uri, $uriOptions);

Persistencia del cliente

La libmongoc biblioteca y la extensión PHP gestionan las conexiones a una implementación de MongoDB. Al construir una instancia, la biblioteca PHP crea un MongoDB\Client archivo MongoDB\Driver\Manager. instancia usando la misma cadena de conexión y opciones. La extensión también utiliza esos argumentos del constructor para derivar una clave hash para los clientes persistentes de libmongoc. Si antes persistió un cliente libmongoc utilizando una clave, se reutiliza. De lo contrario, se crea un nuevo cliente libmongoc y se mantiene para la duración del proceso worker PHP. Para obtener más información sobre este proceso, consulta la documentación de la extensión PHP.

Cada cliente libmongoc mantiene sus propias conexiones con la implementación de MongoDB y una vista de su topología. Al reutilizar un cliente libmongoc persistente, la biblioteca PHP puede evitar la sobrecarga de establecer nuevas conexiones y redescubrir la topología. Este enfoque generalmente mejora el rendimiento y es el comportamiento por defecto del driver.

Los clientes persistentes de libmongoc no se liberan hasta que termina el proceso del trabajador de PHP. Como resultado, las conexiones a una implementación de MongoDB podrían permanecer abiertas después de que un objeto MongoDB\Driver\Manager salga del alcance. Mientras que esto normalmente no representa un problema para las aplicaciones que se conectan a una sola implementación de MongoDB, podría ocasionar errores en las siguientes situaciones:

• PHP-FPM está configurado con pm.max_requests=0 para que los trabajadores nunca se reinicien, y una aplicación PHP se implemente muchas veces con pequeños cambios en su cadena de conexión MongoDB u opciones. Esto podría llevar a una acumulación de libmongoc objetos de cliente en cada proceso de trabajador.

• Una aplicación ocasionalmente se conecta a una implementación separada de MongoDB en un componente backend donde la latencia de la solicitud no es el aspecto más importante.

En el primer caso, reiniciar PHP-FPM como parte de la implementación de la aplicación permite liberar cualquier cliente libmongoc no utilizado y seguir usando un cliente persistente para la última cadena de conexión.

El segundo caso requiere una solución diferente. Especificar true para la opción de driver disableClientPersistence indica a la librería PHP crear un nuevo libmongoc cliente y garantizar que se libere cuando el respectivo MongoDB\Driver\Manager quede fuera de alcance.

El siguiente código demuestra cómo configurar la opción disableClientPersistence a true al crear un cliente:

<?php
$client = new MongoDB\Client(
    uri: getenv('MONGODB_URI') ?: 'mongodb://127.0.0.1/',
    driverOptions: ['disableClientPersistence' => true],
);

Documentación de la API

Para obtener más información sobre cómo crear un objeto MongoDB\Client en la biblioteca PHP, consulte la siguiente documentación de API:

• MongoDB\Client