Renomeia um arquivo ou diretório

bool rename ( string $oldname , string $newname [, resource $context ] )

Tenta renomear oldname para newname, movendo entre diretórios se necessário. se newname existe ele será sobrescrito.

oldname: Nota:
O nome antigo. O wrapper usado em oldname precisa combinar com o wrapper usado em newname.
newname: O novo nome.
context: Nota: O suporte ao contexto foi adicionado no PHP 5.0.0. Para uma descrição de contextos, veja Streams.

Retorna TRUE em caso de sucesso ou FALSE em caso de falha.

Versão	Descrição
5.3.1	rename() agora consegue mover arquivos entre drivers do Windows.
5.0.0	rename() pode agora também ser usada com algum URL wrappers. Consulte Protocolos e Wrappers suportados para uma lista de wrappers que rename() suporta.
4.3.3	rename() agora pode renomear arquivos de diferente partições em sistemas baseados em nix, desde que as permissões possam ser preservadas. Warnings são emitidos se o filesytem destino não permite chamadas chown()* ou chmod() nos arquivos — por exemplo, se a destinação é um filesystem FAT.

Exemplo #1 Exemplo da rename()


<?php
rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
?>