ftp_fput

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

ftp_fputCarga un fichero en un servidor FTP

Descripción

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

An FTP\Connection instance.

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

Devuelve true en caso de éxito o false en caso de error.

Historial de cambios

Versión Descripción
8.1.0 The ftp parameter expects an FTP\Connection instance now; previously, a recurso was expected.
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)