Renomeia um arquivo ou um diretório no servidor FTP

# ftp_rename

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

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

### Descrição

function 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ão | Descriçã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);

    ?>

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open