Carga un fichero en un servidor FTP

# ftp_fput

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

ftp_fput — Carga un fichero en un servidor FTP

### Descripción

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

ftp_fput() carga los datos del fichero identificado por `stream` hasta el final del fichero.

### Parámetros

`ftp`
  Una instancia de FTP\Connection.
`remote_filename`

  La ruta hacia el fichero remoto.

`stream`

  Un puntero de fichero abierto sobre el fichero local. La lectura se detiene al final del fichero.

`mode`

  El modo de transferencia. Debe ser `FTP_ASCII` o `FTP_BINARY`.

`offset`

  La posición en el fichero remoto a partir de la cual comenzará la carga.

### Valores devueltos

Esta función retorna `true` en caso de éxito o `false` si ocurre un error.

### Historial de cambios

Versión | Descripción
--- | ---
8.1.0 | El parámetro `ftp` ahora espera una instancia de FTP\Connection ; anteriormente, se esperaba un resource.
7.3.0 | El argumento `mode` es ahora opcional. Anteriormente era obligatorio.

### Ejemplos

Ejemplo #1 Ejemplo con ftp_fput()

    <?php

    // Apertura de algunos ficheros para lectura
    $file = 'somefile.txt';
    $fp = fopen($file, 'r');

    // Establecimiento de una conexión básica
    $ftp = ftp_connect($ftp_server);

    // Identificación con un nombre de usuario y una contraseña
    $login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

    // Intento de cargar el fichero $file
    if (ftp_fput($ftp, $file, $fp, FTP_ASCII)) {
        echo "Carga exitosa del fichero $file\n";
    } else {
        echo "Hubo un problema durante la carga del fichero $file\n";
    }

    // Cierre de la conexión y del puntero de fichero
    ftp_close($ftp);
    fclose($fp);

    ?>

### Ver también

- ftp_put() - Carga un fichero en un servidor FTP
- ftp_nb_fput() - Escribe un fichero en un servidor FTP, y lo lee desde un fichero (no bloqueante)
- ftp_nb_put() - Envía un fichero a un servidor FTP (no bloqueante)

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