MongoDB\GridFS\Bucket::renameByName()

Definición

MongoDB\GridFS\Bucket::renameByName()

Establece un nuevo valor filename para un archivo GridFS y cualquiera de sus revisiones.

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

Parámetros

$filename : cadena

El filename de los archivos a renombrar.

$newFilename : cadena

El nuevo valor filename.

Errores/Excepciones

MongoDB\GridFS\Exception\FileNotFoundException si no se encontró ningún archivo para los criterios de selección.

MongoDB\Controlador\Excepción\Excepción de tiempo de ejecución para otros errores a nivel de extensión (por ejemplo errores de conexión).

Ejemplos

<?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')));

El resultado sería entonces similar a lo siguiente:

string(6) "foobar"