ftp_fget

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

ftp_fgetDescarga un fichero a través de FTP en un fichero local

Descripción

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

ftp_fget() descarga el fichero remote_filename desde el servidor FTP y lo escribe en el fichero identificado por stream.

Parámetros

ftp

An FTP\Connection instance.

stream

Un puntero de fichero abierto en el que se escriben los datos.

remote_filename

La ruta hacia el fichero remoto.

mode

El modo de transferencia. Debe ser FTP_ASCII o FTP_BINARY.

offset

La posición del fichero remoto desde la cual comienza la descarga.

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 ahora es opcional. Anteriormente era obligatorio.

Ejemplos

Ejemplo #1 Ejemplo con ftp_fget()

<?php

// Ruta hacia el fichero remoto
$remote_file = 'somefile.txt';
$local_file = 'localfile.txt';

// Apertura del fichero para escritura
$handle = fopen($local_file, 'w');

// 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 descargar el fichero $remote_file y guardarlo en $handle
if (ftp_fget($ftp, $handle, $remote_file, FTP_ASCII, 0)) {
echo
"Escritura en el fichero $local_file con éxito\n";
} else {
echo
"Hay un problema durante la descarga del fichero $remote_file en $local_file\n";
}

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

Ver también

  • ftp_get() - Descarga un fichero desde un servidor FTP
  • ftp_nb_get() - Lee un fichero en un servidor FTP y lo escribe en un fichero (no bloqueante)
  • ftp_nb_fget() - Lee un fichero en un servidor FTP y lo escribe en un fichero (no bloqueante)