Menu Docs
Página inicial do Docs
/ / /
Manual da Biblioteca PHP
/ /

MongoDB\GridFS\Bucket::rename()

Nesta página

  • Definição
  • Parâmetros
  • Erros/exceções
  • Exemplos
MongoDB\GridFS\Bucket::rename()

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

function rename($id, string $newFilename): void
$id : misto
O _id do arquivo a ser renomeado.
$newFilename : string
O novo valor de filename .

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).

<?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"

Voltar

registrarGlobalStreamWrapperAlias()