Bases de datos y colecciones

Overview

En esta guía, puedes aprender cómo usar Laravel MongoDB para acceder y gestionar 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

Puedes especificar un nombre de base de datos que una conexión utiliza en tu 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 estableces el nombre de la base de datos en la propiedad database al nombre de una base de datos inexistente, Laravel sigue estableciendo una conexión válida. Cuando introduces 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 estableciendo las propiedades dsn y database:

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

Cuando estableces una conexión predeterminada a la base de datos, la Integración Laravel utiliza esa conexión para operaciones, pero puedes especificar múltiples conexiones a la base de datos en tu archivo config/database.php.

El siguiente ejemplo muestra cómo especificar múltiples conexiones de bases 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 a bases de datos y desea almacenar su modelo en una base de datos distinta de la predeterminada, sobrescriba 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 modelo llamada Flower, Laravel aplicará 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 de una base de datos:

• Ejecutar una instrucción Shell

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

php artisan db:show

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

Listar campos de colección

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

• Ejecutar una instrucción Shell

• Llamar a métodos de esquema

php artisan db:table <collection name>

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

Crear y eliminar colecciones

Para aprender a crear y eliminar colecciones, consulta la sección Realizar migraciones de Laravel en la guía de Schema Builder.

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');