MongoDB\GridFS\Bucket::__construct()

Definición

MongoDB\GridFS\Bucket::__construct()

Construye un nuevo Bucket instancia.

function __construct(
    MongoDB\Driver\Manager $manager,
    string $databaseName,
    array $options = []
)

Parámetros

$manager : MongoDB\driver\administrador

La instancia del administrador de la extensión. El administrador mantiene las conexiones entre el controlador y MongoDB.

$databaseName : string

El nombre de la base de datos.

$options : arreglo

Una matriz que especifica las opciones deseadas.

Nombre	Tipo	Descripción
bucketName	string	El nombre del bucket, que se utilizará como prefijo para los archivos y colecciones de fragmentos. El valor por defecto es "fs".
tamaño del fragmento en bytes	entero	El tamaño del fragmento en bytes. El valor por defecto es 261120 (es decir, 255 KiB).
códec	MongoDB\Codec\DocumentCodec	Los datos codificados predeterminados con códecs de tipo que se utilizarán para los métodos de depósito que devuelven un documento de archivo (porMongoDB\GridFS\Bucket::find() ejemplo,). Novedad en la versión 1.17.
deshabilitarMD5	booleano	Indica si se debe deshabilitar la generación automática de MD5 al almacenar archivos. Por defecto es false. Solo true será soportado en 2.0. Nuevo en la versión 1.4.
readConcern	MongoDB\Driver\ReadConcern	El nivel de consistencia de lectura por defecto que se utilizará para las operaciones de bucket. Por defecto, se establece el nivel de consistencia de lectura del administrador.
readPreference	MongoDB\Driver\ReadPreference	La preferencia de lectura predeterminada para las operaciones de depósito. Se utiliza la preferencia de lectura del administrador de forma predeterminada.
typeMap	arreglo	Mapa de tipo por defecto para aplicar a los cursores, que determina cómo se convierten los documentos BSON a valores de PHP. La librería utiliza el siguiente mapa de tipos por defecto: [ 'array' => 'MongoDB\Model\BSONArray', 'document' => 'MongoDB\Model\BSONDocument', 'root' => 'MongoDB\Model\BSONDocument', ]
writeConcern	MongoDB\Driver\WriteConcern	El nivel de confirmación de escritura (write concern) por defecto a utilizar para las operaciones de bucket. Por defecto, se utiliza el nivel de confirmación de escritura (write concern) del administrador.

Errores/Excepciones

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

Comportamiento

Si se construye un Bucket de forma explícita, el Bucket hereda cualquier opción del objeto MongoDB\Driver\Manager. Si seleccionas el Bucket desde un objeto Database, el Bucket hereda sus opciones de ese objeto.

Ejemplos

<?php
$bucket = (new MongoDB\Client)->test->selectGridFSBucket();
var_dump($bucket);

La vista de salida se ilustraría como sigue:

object(MongoDB\GridFS\Bucket)#3053 (2) {
  ["bucketName"]=>
  string(4) "test"
  ["databaseName"]=>
  string(11) "phplib_test"
}

Ver también

• MongoDB\Database::selectGridFSBucket()