Bases de datos y colecciones

Overview

En esta guía, puede aprender a usar Laravel MongoDB para acceder y administrar bases de datos y colecciones de MongoDB.

MongoDB organiza los datos en una estructura jerárquica. Una implementación de MongoDB contiene una o más bases de datos, y cada base de datos contiene una o más colecciones. En cada colección,MongoDB almacena los datos como documentos que contienen pares de campo y valor. En la integración de Laravel, se puede acceder a los documentos mediante modelos de Eloquent.

Para obtener más información sobre el formato de datos del documento, consulte Documentos en el manual del servidor.

Especificar la base de datos en una configuración de conexión

Puede especificar un nombre de base de datos que una conexión utiliza en su aplicación. config/database.php Archivo. La propiedad connections de este archivo almacena toda la información de conexión a la base de datos, como la cadena de conexión, el nombre de la base de datos y, opcionalmente, los detalles de autenticación. Tras especificar una conexión a la base de datos, puede realizar operaciones a nivel de base de datos y acceder a las colecciones que contiene.

Si asigna el nombre de la base de datos en la propiedad database al nombre de una base de datos inexistente, Laravel seguirá estableciendo una conexión válida. Al insertar datos en una colección de la base de datos, el servidor los crea automáticamente.

El siguiente ejemplo muestra cómo establecer una conexión de base de datos predeterminada y crear una conexión de base de datos a la base de datos animals en el archivo config/database.php configurando las propiedades dsn y database:

'default' => 'mongodb',
'connections' => [
    'mongodb' => [
        'driver' => 'mongodb',
        'dsn' => 'mongodb://localhost:27017/',
        'database' => 'animals',
    ], ...
]

Cuando configura una conexión de base de datos predeterminada, la integración de Laravel utiliza esa conexión para las operaciones, pero puede especificar múltiples conexiones de base de datos en su archivo config/database.php.

El siguiente ejemplo muestra cómo especificar múltiples conexiones de base de datos (mongodb y mongodb_alt) para acceder a las bases de datos animals y plants:

'connections' => [
    'mongodb' => [
        'driver' => 'mongodb',
        'dsn' => 'mongodb://localhost:27017/',
        'database' => 'animals',
    ],
    'mongodb_alt' => [
        'driver' => 'mongodb',
        'dsn' => 'mongodb://localhost:27017/',
        'database' => 'plants',
    ]
], ...

Si su aplicación contiene múltiples conexiones de bases de datos y desea almacenar su modelo en una base de datos distinta de la predeterminada, anule la propiedad $connection en su clase Model.

El siguiente ejemplo muestra cómo anular la propiedad $connection en la clase de modelo Flower para usar la conexión mongodb_alt. Esto indica a la integración de Laravel que almacene el modelo en la colección flowers de la base de datos plants, en lugar de en la base de datos predeterminada:

class Flower extends Model
{
    protected $connection = 'mongodb_alt';
}

Acceder a una colección

Cuando crea una clase de modelo que extiende MongoDB\Laravel\Eloquent\Model, la integración de Laravel almacena los datos del modelo en una colección con un nombre formateado como la forma plural (casi sin sentido) del nombre de su clase de modelo.

Por ejemplo, si crea una clase de modelo llamada Flower, Laravel aplica el modelo a la colección flowers en la base de datos.

Generalmente recomendamos usar el ORM Eloquent para acceder a una colección, lo que facilita la legibilidad y el mantenimiento del código. El siguiente ejemplo especifica una operación de búsqueda mediante la clase Flower, de modo que Laravel recupera los resultados de la colección flowers:

Flower::where('name', 'Water Lily')->get()

Si no puedes realizar tu operación utilizando un modelo Eloquent, puedes acceder al generador de query llamando al método table() en la fachada DB. El siguiente ejemplo muestra la misma consulta que el ejemplo anterior, pero la consulta se construye utilizando el método DB::table():

DB::connection('mongodb')
    ->table('flowers')
    ->where('name', 'Water Lily')
    ->get()

Listar colecciones

Puede realizar cualquiera de las siguientes acciones para ver información sobre las colecciones en una base de datos:

• Ejecutar un comando de Shell

• Llamar a métodos de base de datos o esquema

php artisan db:show

$collections = DB::connection('mongodb')->getDatabase()->listCollections();

Lista de campos de colección

Puede realizar cualquiera de las siguientes acciones para ver información sobre cada campo de una colección:

• Ejecutar un comando de Shell

• Llamar a métodos de esquema

php artisan db:table <collection name>

$fields = Schema::getColumns('flowers');

Crear y eliminar colecciones

Para aprender cómo crear y eliminar colecciones, consulte la sección Realizar migraciones de Laravel en la guía del generador de esquemas.

Descartar una base de datos

Para borrar una base de datos de tu implementación de MongoDB, llama al método getMongoClient() en la fachada DB para acceder a tu cliente. Luego, llama al método dropDatabase() de la librería PHP de MongoDB y pasa el nombre de la base de datos a borrar como argumento.

El siguiente ejemplo elimina una base de datos llamada test_database:

$client = DB::getMongoClient();
$client->dropDatabase('test_database');