Sistemas de archivos GridFS

Overview

Puedes utilizar el Adaptador GridFS para Flysystem para almacenar archivos grandes en MongoDB. GridFS permite almacenar archivos de tamaño ilimitado en la misma base de datos que tus datos.

Configuración

Antes de utilizar el controlador GridFS, instale el paquete GridFS de Flysystem a través del administrador de paquetes Composer ejecutando el siguiente comando:

composer require league/flysystem-gridfs

Configurar el almacenamiento de archivos de Laravel para utilizar el gridfs conductor en config/filesystems.php:

'disks' => [
    'gridfs' => [
        'driver' => 'gridfs',
        'connection' => 'mongodb',
        // 'database' => null,
        // 'bucket' => 'fs',
        // 'prefix' => '',
        // 'read-only' => false,
        // 'throw' => false,
    ],
],

Puede configurar los siguientes ajustes en config/filesystems.php:

También puede usar una fábrica o un nombre de servicio para crear una instancia de MongoDB\GridFS\Bucket. En este caso, se ignoran las opciones connection y database:

use Illuminate\Foundation\Application;
use MongoDB\GridFS\Bucket;
'disks' => [
    'gridfs' => [
        'driver' => 'gridfs',
        'bucket' => static function (Application $app): Bucket {
            return $app['db']->connection('mongodb')
                ->getDatabase()
                ->selectGridFSBucket([
                    'bucketName' => 'avatars',
                    'chunkSizeBytes' => 261120,
                ]);
        },
    ],
],

Uso

El sistema de archivos de Laravel proporciona una interfaz común para todos los sistemas de archivos compatibles. Puedes usar el disco gridfs de la misma manera que el disco local.

El siguiente ejemplo escribe un archivo en el disco gridfs y luego lee el archivo:

$disk = Storage::disk('gridfs');
// Write the file "hello.txt" into GridFS
$disk->put('hello.txt', 'Hello World!');
// Read the file
echo $disk->get('hello.txt'); // Hello World!

Para obtener más información sobre el almacenamiento de archivos de Laravel, consulte Almacenamiento de archivos de Laravel en la documentación de Laravel.

Control de versiones

GridFS crea documentos de archivos para cada archivo subido. Estos documentos contienen metadatos, incluido el nombre del archivo y un ObjectId único. Si varios documentos comparten el mismo nombre de archivo, se consideran "revisiones" y se distinguen aún más por marcas de tiempo de creación.

Laravel MongoDB utiliza el adaptador Flysystem de GridFS. Este interactúa con las revisiones de archivos de las siguientes maneras:

• Al leer un archivo se lee la última revisión de este nombre de archivo.

• Escribir un archivo crea una nueva revisión para este nombre de archivo

• Al cambiar el nombre de un archivo se cambian todas las revisiones de este nombre de archivo.

• Al eliminar un archivo se eliminan todas las revisiones de este nombre de archivo.

El adaptador GridFS para Flysystem no permite el acceso a una revisión específica de un nombre de archivo. Debe usar la API GridFS si necesita trabajar con revisiones, como se muestra en el siguiente código:

// Create a bucket service from the MongoDB connection
/** @var \MongoDB\GridFS\Bucket $bucket */
$bucket = $app['db']->connection('mongodb')->getDatabase()->selectGridFSBucket();
// Download the last but one version of a file
$bucket->openDownloadStreamByName('hello.txt', ['revision' => -2])