Neste guia, discutiremos o uso e a sintaxe do função renomear() em PHP.
O que é uma função rename () em PHP?
O renomear() function é uma função interna do PHP usada para alterar o nome do arquivo ou diretório sem alterar o conteúdo do arquivo. Essa função usa o nome antigo e o novo nome do arquivo como argumentos necessários.
Sintaxe
O formato para usar o renomear() função em PHP é a seguinte:
renomear ( velho , novo , contexto )
O velho e novo são os parâmetros obrigatórios, o velho especifica o arquivo que você deseja alterar, novo especifica o novo nome para o arquivo. O contexto é um parâmetro opcional que determina o contexto para alterar o nome do arquivo.
O função renomear() retorna Verdadeiro na execução bem-sucedida, caso contrário, ele retorna Falso. O renomear() file retornará um erro se o novo arquivo já existir no mesmo diretório.
Como usar a função rename () em PHP?
Renomeando o arquivo através do função renomear() é fácil, e os exemplos a seguir o ajudarão nesse caso.
Como renomear um arquivo usando a função PHP rename ()
O código a seguir irá renomear um arquivo test.php para um arquivo.php:
renomear ( 'teste.php' , 'arquivo.php' ) ;
?>
Se você renomear um arquivo que já existe no mesmo diretório, ele será substituído.
Exemplo 1 – Como renomear um arquivo usando a função PHP rename()
O exemplo a seguir renomeará o test.php para teste2.php. Após a conclusão bem-sucedida, o se declaração será impresso no console, caso contrário, o outra declaração será exibido como uma saída:
se ( renomear ( 'C: \\ xampp \\ htdocs \\ teste.php' , 'C: \\ xampp \\ htdocs \\ teste2.php' ) )
{
eco ' Test.php renomeado com sucesso para test2.php' ;
}
outro {
eco 'Erro ao renomear arquivo' ;
}
?>
Observação: Em PHP, ao especificar caminhos de arquivo para o renomear() (e outras operações relacionadas a arquivos), é importante usar barra invertida dupla (\\) em vez de um barra simples (\) para garantir que o caminho do arquivo seja interpretado corretamente, isso ocorre porque uma única barra invertida é tratada como um caractere de escape no PHP.
Exemplo 2 – Como renomear um diretório usando a função PHP rename()
Para renomear um diretório usando o renomear() função, siga o código abaixo indicado:
$oldDirName = 'documentos' ;$newDirName = 'arquivos de amostra' ;
se ( renomear ( $oldDirName , $newDirName ) ) {
eco 'Diretório renomeado com sucesso!' ;
} outro {
eco 'Erro ao renomear o diretório.' ;
}
Conclusão
A função rename() do PHP é uma ferramenta confiável para renomear facilmente um arquivo ou diretório enquanto preserva seu conteúdo. Sua sintaxe simples e recursos de tratamento de erros o tornam uma escolha conveniente para tarefas de gerenciamento de arquivos. Aproveitando o poder de renomear(), Os desenvolvedores PHP podem organizar e modificar com eficiência nomes de arquivos ou diretórios em seus projetos.