MongoDB\GridFS\Bucket::rename()

Definição

MongoDB\GridFS\Bucket::rename()

Seleciona um arquivo GridFS pelo seu _id e altera seu filename.

function rename($id, string $newFilename): void

Parâmetros

$id : misto

O _id do arquivo a ser renomeado.

$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);
$id = $bucket->uploadFromStream('a', $stream);
$bucket->rename($id, 'b');
var_dump(stream_get_contents($bucket->openDownloadStreamByName('b')));

A saída seria então semelhante a:

string(6) "foobar"