MongoDB\Client::__construct()

Definición

MongoDB\Client::__construct()

Construye un nuevo Client instancia.

function __construct(
    ?string $uri = null,
    array $uriOptions = [],
    array $driverOptions = []
)

Parámetros

$uri : string

La cadena de conexión de MongoDB. Consulta Cadenas de conexión en el manual de MongoDB para obtener más información.

Por defecto es "mongodb://127.0.0.1:27017" si no se especifica.

Cualquier carácter especial en los componentes del URI debe codificarse según RFC 3986. Esto es particularmente relevante para el nombre de usuario y la contraseña, que a menudo pueden incluir caracteres especiales como @, : o %. Al conectarse mediante un socket de dominio Unix, la ruta del socket puede contener caracteres especiales como barras y debe estar codificada. La rawurlencode() función se puede utilizar para codificar partes constituyentes de la URI.

$uriOptions : arreglo

Especifica opciones URI adicionales, como credenciales de autenticación o parámetros del string del query. Las opciones especificadas en $uriOptions tienen prioridad sobre cualquier opción análoga presente en la string $uri y no es necesario codificarlas según RFC 3986.

Consulta la documentación de la extensión MongoDB\Driver\Manager::__construct() para obtener una lista de las opciones admitidas.

$driverOptions : arreglo

Especifica opciones específicas para el controlador PHP. Además de las opciones soportadas por la extensión, la librería también permite especificar un type map por defecto a aplicar a los cursores que crea.

Nombre	Tipo	Descripción
autoEncryption	arreglo	Opciones para configurar el cifrado a nivel de campo del lado del cliente en el controlador. Consulta la documentación de la extensión para obtener una lista de las opciones de cifrado compatibles. Si se proporciona un MongoDB\Client para la opción keyVaultClient, se desempaquetará como un MongoDB\driver\administrador para la extensión. Novedad en la versión 1.6.
controlador	arreglo	Metadatos adicionales del controlador que se transmitirán en el apretón de manos del servidor. Este es un arreglo que contiene los campos de string name, version y platform. Por ejemplo: [ 'name' => 'my-driver', 'version' => '1.2.3-dev', 'platform' => 'some-platform', ] Esta funcionalidad está diseñada principalmente para drivers personalizados y ODMs, que pueden querer identificarse ante el servidor con fines de diagnóstico. Las aplicaciones que deseen identificarse deberían usar la opción de URI appName en lugar de esta opción. Novedad en la versión 1.7.
serverApi	MongoDB\Driver\ServerApi	Se utiliza para declarar una versión de la API en el cliente. Consulta la página API estable en el manual del servidor para obtener información adicional. Nuevo en la versión 1.9.
typeMap	arreglo	Mapa de tipo por defecto para aplicar a los cursores, que determina cómo se convierten los documentos BSON a valores de PHP. La librería utiliza el siguiente mapa de tipos por defecto: [ 'array' => 'MongoDB\Model\BSONArray', 'document' => 'MongoDB\Model\BSONDocument', 'root' => 'MongoDB\Model\BSONDocument', ]
builderEncoder	MongoDB\Codec\Encoder	Codificadora que se va a usar para los desarrolladores de query y agregaciones. Si no se establece, esta opción será por defecto una nueva instancia de la clase MongoDB\Builder\BuilderEncoder. Nuevo en la versión 1.21.
allow_invalid_hostname	booleano	Desactiva la validación del nombre de host si true. Por defecto es false. Permitir nombres de host no válidos puede exponer al controlador a un ataque de intermediario. Obsoleto desde la versión 1.6: Esta opción ha quedado obsoleta. En su lugar, usa la opción URI tlsAllowInvalidHostnames.
ca_dir	string	Ruta a un directorio de certificados correctamente encriptada. Por defecto, se utilizará el almacén de certificados del sistema. Vuelve a la opción de contexto SSL obsoleta capath si no se especifica.
ca_file	string	Ruta a un archivo de autoridad certificadora. Por defecto, se utilizará el almacén de certificados del sistema. Vuelve a la opción de contexto SSL obsoleta cafile si no se especifica. Obsoleto desde la versión 1.6: Esta opción ha quedado obsoleta. En su lugar, usa la opción URI tlsCAFile.
crl_file	string	Ruta a un archivo de lista de revocación de certificados.
archivo_pem	string	Ruta a un certificado codificado en PEM para usar en la autenticación de clientes. Vuelve a la opción de contexto SSL obsoleta local_cert si no se especifica. Obsoleto desde la versión 1.6: Esta opción ha quedado obsoleta. En su lugar, usa la opción URI tlsCertificateKeyFile.
pem_pwd	string	Frase de contraseña para el certificado codificado PEM (si corresponde). Vuelve a la opción de contexto SSL obsoleta passphrase si no se especifica. Obsoleto desde la versión 1.6: Esta opción ha quedado obsoleta. En su lugar, usa la opción URI tlsCertificateKeyFilePassword.
validación_de_certificados_débil	booleano	Desactiva la validación del certificado true. Por defecto es false. Vuelve a la opción de contexto SSL obsoleta allow_self_signed si no se especifica. Obsoleto desde la versión 1.6: Esta opción ha quedado obsoleta. En su lugar, usa la opción URI tlsAllowInvalidCertificates.
context	resource	Opciones de contexto SSL para ser utilizadas como alternativas de seguridad para otras opciones de controlador (según se especifique). Observe que el driver no consulta el contexto de flujo por defecto. Esta opción se admite por compatibilidad con versiones anteriores, pero debe considerarse obsoleta.

Errores/Excepciones

MongoDB\Exception\InvalidArgumentException por errores relacionados con el análisis de parámetros u opciones.

MongoDB\Driver\Exception\InvalidArgumentException para errores relacionados con el análisis de parámetros u opciones a nivel de extensión.

MongoDB\Driver\Exception\RuntimeException para otros errores a nivel de extensión (por ejemplo, " errores de conexión).

Comportamiento

Se construye internamente un MongoDB\driver\administrador. Según la spec de descubrimiento y supervisión de servidor, MongoDB\driver\Manager::__construct() no realiza entrada/salida. Las conexiones se inicializarán on-demand, cuando se ejecute la primera operación.

Ejemplos

<?php
$client = new MongoDB\Client('mongodb://mongodb-deployment:27017');

<?php
$client = new MongoDB\Client(
    'mongodb://rs1.example.com,rs2.example.com/?replicaSet=myReplicaSet',
    [
        'readPreference' => 'secondaryPreferred',
    ]
);

<?php
$client = new MongoDB\Client(
    'mongodb://myUsername:myPassword@rs1.example.com,rs2.example.com/?ssl=true&replicaSet=myReplicaSet&authSource=admin'
);

<?php
$client = new MongoDB\Client(
    'mongodb://rs1.example.com,rs2.example.com/'
    [
        'username' => 'myUsername',
        'password' => 'myPassword',
        'ssl' => true,
        'replicaSet' => 'myReplicaSet',
        'authSource' => 'admin',
    ],
);

<?php
$client = new MongoDB\Client(
    null,
    [],
    [
        'typeMap' => [
            'root' => 'array',
            'document' => 'array',
            'array' => 'array',
        ],
    ]
);

Ver también

• MongoDB\Driver\Manager::__construct()

• Formato del URI de cadena de conexión manual de MongoDB

• Servidor Descubrimiento y supervisión especificación