Função rename

A função rename renomeia um arquivo ou diretório. O primeiro parâmetro da função recebe o nome atual do arquivo ou o caminho para ele, o segundo parâmetro - o novo nome ou caminho. A função retorna true em caso de sucesso e false em caso de erro.

Sintaxe

rename(string $oldname, string $newname, resource $context = null): bool

Exemplo

Vamos renomear o arquivo de 'old.txt' para 'new.txt':

<?php
	$res = rename('old.txt', 'new.txt');
	var_dump($res);
?>

Resultado da execução do código:

true

Exemplo

Vamos mover o arquivo para outro diretório:

<?php
	$res = rename('file.txt', 'newdir/file.txt');
	var_dump($res);
?>

Resultado da execução do código:

true

Exemplo

Vamos tentar renomear um arquivo que não existe:

<?php
	$res = rename('nonexistent.txt', 'new.txt');
	var_dump($res);
?>

Resultado da execução do código:

false

Exemplo

Vamos renomear um diretório:

<?php
	$res = rename('olddir', 'newdir');
	var_dump($res);
?>

Resultado da execução do código:

true

Veja também

a função copy,
que copia um arquivo
a função unlink,
que exclui um arquivo
a função move_uploaded_file,
que move um arquivo enviado