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

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

Exemplo

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

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

Resultado da execução do código:

phptrue

Exemplo

Vamos mover o arquivo para outro diretório:

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

Resultado da execução do código:

phptrue

Exemplo

Vamos tentar renomear um arquivo que não existe:

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

Resultado da execução do código:

phpfalse

Exemplo

Vamos renomear um diretório:

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

Resultado da execução do código:

phptrue

Veja também