MongoDB\GridFS\Bucket::__construct()
Definição
MongoDB\GridFS\Bucket::__construct()
Constrói uma nova instância do
Bucket
.function __construct( MongoDB\Driver\Manager $manager, string $databaseName, array $options = [] )
Parâmetros
$manager
: MongoDB\Driver\Manager- O gerente instância da extensão. O gerenciador mantém conexões entre o driver e o MongoDB.
$databaseName
: string- O nome do banco de dados.
$options
: arrayUma array especificando as opções desejadas.
NomeTipoDescriçãobucketNamestringO nome do bucket, que será usado como prefixo para os arquivos e as collections de chunks. Padrão é"fs"
.chunkSizeBytesinteiroO tamanho da parte em bytes. O padrão é261120
(ou seja, 255 KB).CodecMongoDB\Codec\DocumentCodecO codec padrão a ser usado para métodos bucket que retornam um documento de arquivo (por exemplo
MongoDB\GridFS\Bucket::find()
).Novidade na versão 1.17.
disableMD5booleanoSe a geração automática de md5 deve ser desabilitada ao armazenar arquivos.
Padrão é
false
. Somentetrue
será suportado em 2.0.Novidade na versão 1.4.
readConcernA referência de leitura padrão a ser usada para operações de bucket. O padrão é a preocupação de leitura do gerente.readPreferenceA preferência de leitura padrão a ser usada para operações de contêiner. O padrão é a preferência de leitura do gerente.typeMaparrayMapa de tipo padrão aplicar aos cursores, o que determina como os documentos BSON são convertidos em valores PHP. A biblioteca usa o seguinte mapa de tipos por padrão:
[ 'array' => 'MongoDB\Model\BSONArray', 'document' => 'MongoDB\Model\BSONDocument', 'root' => 'MongoDB\Model\BSONDocument', ] writeConcernA referência de escrita padrão a ser usada para operações de bucket. O padrão é a referência de escrita do gerente.
Erros/exceções
MongoDB\Exception\InvalidArgumentException
para erros relacionados à análise de parâmetros ou opções.
Comportamento
Se você construir um bucket explicitamente, o bucket herda todas as opções do MongoDB\Driver\Manager objeto. Se você selecionar o bucket de um objeto Database
, o bucket herdará suas opções desse objeto.
Exemplos
$bucket = (new MongoDB\Client)->test->selectGridFSBucket(); var_dump($bucket);
A saída seria então semelhante a:
object(MongoDB\GridFS\Bucket)#3053 (2) { ["bucketName"]=> string(4) "test" ["databaseName"]=> string(11) "phplib_test" }