(PHP 4, PHP 5, PHP 7, PHP 8)
rename — Renomeia um arquivo ou diretório
Tenta renomear from para
to, movendo entre diretórios se necessário.
Se o arquivo to já existir,
ele será sobrescrito. Se renomeando um diretório e
to já existir,
esta função emite um warning.
fromO nome anterior.
Nota:
O empacotador utilizado em
fromprecisa ser o mesmo empacotador utilizado emto.
toO novo nome.
Nota: No Windows, se
tojá existir, ele precisa ter permissão de escrita. Se não a função rename() falhará e emitirá umE_WARNING.
contextUm resource de contexto de fluxo.
Exemplo #1 Exemplo da rename()
<?php
rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
?>