array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.ftp-rename.php', 1 => 'ftp_rename', ), 'up' => array ( 0 => 'ref.ftp.php', 1 => 'Funções da extensão FTP', ), 'prev' => array ( 0 => 'function.ftp-rawlist.php', 1 => 'ftp_rawlist', ), 'next' => array ( 0 => 'function.ftp-rmdir.php', 1 => 'ftp_rmdir', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/ftp/functions/ftp-rename.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
ftp_rename — Renomeia um arquivo ou um diretório no servidor FTP
ftp_rename() renomeia um arquivo ou diretório no servidor FTP.
ftp
Uma instância de FTP\Connection.
from
O nome atual do arquivo/diretório.
to
O novo nome para o qual se deseja renomear.
Retorna true
em caso de sucesso ou false
em caso de falha. Em caso de falha (como em tentativa de renomear um arquivo que
não existe), um erro de nível E_WARNING
será emitido.
Versão | Descrição |
---|---|
8.1.0 |
O parâmetro ftp agora espera uma instância de FTP\Connection;
anteriormente, um resource era esperado.
|
Exemplo #1 Exemplo de ftp_rename()
<?php
$old_file = 'algumArquivo.txt.bak';
$new_file = 'algumArquivo.txt';
// define uma conexão básica
$ftp = ftp_connect($ftp_server);
// login com usuário e senha
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);
// tenta renomear $old_file para $new_file
if (ftp_rename($ftp, $old_file, $new_file)) {
echo "Sucesso ao renomear $old_file para $new_file\n";
} else {
echo "Houve um problema ao renomear $old_file para $new_file\n";
}
// fecha a conexão
ftp_close($ftp);
?>