ftp_rename

    (PHP 4, PHP 5, PHP 7, PHP 8)

    ftp_rename — Renomeia um arquivo ou um diretório no servidor FTP

    Descrição

    ftp_rename(FTP\Connection$ftp, string$from, string$to): bool

    ftp_rename() renomeia um arquivo ou diretório no servidor FTP.

    Parâmetros

    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.

    Valor Retornado

    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.

    Registro de Alterações

    VersãoDescrição
    8.1.0 O parâmetro ftp agora espera uma instância de FTP\Connection; anteriormente, um resource era esperado.

    Exemplos

    Exemplo #1 Exemplo de ftp_rename()

    <?php
    $old_file     = 'algumArquivo.txt.bak';
    $new_file = 'algumArquivo.txt';

    // Configura 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);

    ?>
    To Top