MongoDB\ GridFS\Bucket::renameByName()

Definição

MongoDB\GridFS\Bucket::renameByName()

Define um novo valor filename para um arquivo GridFS e qualquer uma de suas revisões.

function renameByName(string $filename, string $newFilename): void

Parâmetros

$filename : string

O filename dos arquivos a serem renomeados.

$newFilename : string

O novo valor de filename .

Erros/exceções

MongoDB\GridFS\Exception\FileNotFoundException se nenhum arquivo tiver sido encontrado para os critérios de seleção.

MongoDB\Driver\Exception\RuntimeException para outros erros no nível da extensão (por exemplo erros de conexão).

Exemplos

<?php
$bucket = (new MongoDB\Client)->test->selectGridFSBucket();
$stream = fopen('php://temp', 'w+b');fwrite($stream, "foobar");rewind($stream);
$bucket->uploadFromStream('a', $stream);
$bucket->renameByName('a', 'b');
var_dump(stream_get_contents($bucket->openDownloadStreamByName('b')));

A saída seria então semelhante a:

string(6) "foobar"