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. Un 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 datos como documentos que contienen pares de campo y valor. En la Integración de Laravel, puedes acceder a documentos a través de modelos 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 en 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. Después de que especifiques una conexión a la base de datos, puedes realizar operaciones a nivel de base de datos y acceder a las colecciones que contiene la base de datos.

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 sobrescribir 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 creas 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 formado como la forma plural en snake case del nombre de tu 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 debido a la legibilidad y mantenibilidad del código. El siguiente ejemplo especifica una operación de búsqueda utilizando la clase Flower, de modo que Laravel recupera 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

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