/ /

/ /

MongoDB\Client::listDatabaseNames()

Novedades en la versión 1.7.

Definición

MongoDB\Client::listDatabaseNames()

Devuelve los nombres de todas las bases de datos en el servidor.

function listDatabaseNames(array $options = []): Iterator

$options : arreglo

Una matriz que especifica las opciones deseadas.

Nombre	Tipo	Descripción
dataBasesAutorized	booleano	Una bandera que determina qué bases de datos se devuelven en función de los privilegios del usuario cuando el control de acceso está habilitado. Para obtener más información, consulta el comando listDatabases referencia en el manual del servidor MongoDB. Novedades en la versión 1.7.
comment	mixto	Permite a los usuarios especificar un comentario arbitrario para ayudar a rastrear la operación a través del generador de perfiles de base de datos, la salidacurrentOp y los registros. Esta opción está disponible desde MongoDB 4.4 y, si se especifica para una versión de servidor anterior, dará lugar a una excepción en tiempo de ejecución. Novedades en la versión 1.13.
filtro	arreglo\|objeto	Una expresión de consulta para filtrar la lista de bases de datos. Es posible especificar una expresión de query para campos de base de datos (p. ej. `name`, `sizeOnDisk`, `empty`). Nueva en la versión 1.3.
maxTimeMS	entero	El límite de tiempo acumulado en milisegundos para las operaciones de procesamiento en el cursor. MongoDB aborta la operación en el siguiente punto de interrupción..
sesión	MongoDB\Driver\Session	Sesión de cliente para asociar a la operación. Nueva en la versión 1.3.

Un Iterador, que proporciona el nombre de cada base de datos en el servidor.

MongoDB\Exception\UnexpectedValueException si la respuesta del comando del servidor era incorrecta.

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

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

El siguiente ejemplo enumera todas las bases de datos en el servidor:

<?php
$client = new MongoDB\Client;
foreach ($client->listDatabaseNames() as $databaseName) {
    var_dump($databaseName);
}

La vista de salida se ilustraría como sigue:

string(5) "local"
string(4) "test"

Volver

getWriteConcern()

listDatabases()