Envia um arquivo aberto para o servidor FTP

# ftp_fput

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

ftp_fput — Envia um arquivo aberto para o servidor FTP

### Descrição

function ftp_fput(
FTP\Connection `$ftp`,
string `$remote_filename`,
resource `$stream`,
int `$mode` = `FTP_BINARY`,
int `$offset` = 0
): bool

ftp_fput() envia os dados a partir de um ponteiro de arquivo para um arquivo remoto no servidor FTP.

### Parâmetros

`ftp`
  Uma instância de FTP\Connection.
`remote_filename`

  O caminho do arquivo remoto.

`stream`

  Um ponteiro de arquivo local aberto. A leitura encerra no final do arquivo.

`mode`

  O modo de transferência. Deve ser `FTP_ASCII` ou `FTP_BINARY`.

`offset`

  A posição no arquivo remoto para iniciar o envio.

### Valor Retornado

Retorna `true` em caso de sucesso ou `false` em caso de falha.

### 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.
7.3.0 | O parâmetro `mode` agora é opcional. Antigamente era obrigatório.

### Exemplos

Exemplo #1 Exemplo de ftp_fput()

    <?php

    // abre um arquivo para leitura
    $file = 'somefile.txt';
    $fp = fopen($file, 'r');

    // configura conexão básica
    $ftp = ftp_connect($ftp_server);

    // registra com usuário e senha
    $login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

    // tenta enviar o arquivo
    if (ftp_fput($ftp, $file, $fp, FTP_ASCII)) {
        echo "$file enviado com sucesso\n";
    } else {
        echo "Houve um problema ao enviar $file\n";
    }

    // fecha a conexão e o identificador do arquivo
    ftp_close($ftp);
    fclose($fp);

    ?>

### Veja Também

- ftp_put() - Envia um arquivo para o servidor FTP
- ftp_nb_fput() - Armazena um arquivo de um arquivo aberto no servidor FTP (sem bloqueio)
- ftp_nb_put() - Armazena um arquivo no servidor FTP (sem bloqueio)

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