rename

(PHP 4, PHP 5, PHP 7)

renameRenomeia um arquivo ou diretório

Descrição

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

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

Parâmetros

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.

Valor Retornado

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

Changelog

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.

Exemplos

Exemplo #1 Exemplo da rename()

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

Veja Também

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top