(PHP 4, PHP 5, PHP 7)
rename — Renomeia um arquivo ou diretório
$oldname
, string $newname
[, resource $context
] ) : bool
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
oldnameprecisa combinar com o wrapper usado emnewname.
newnameO novo nome.
contextNota: 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");
?>