ftp_get

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

ftp_getDescarga un fichero desde un servidor FTP

Descripción

ftp_get(
    FTP\Connection $ftp,
    string $local_filename,
    string $remote_filename,
    int $mode = FTP_BINARY,
    int $offset = 0
): bool

ftp_get() descarga el fichero remote_filename desde el servidor FTP, y lo guarda en el fichero local local_filename.

Parámetros

ftp

An FTP\Connection instance.

local_filename

La ruta hacia el fichero local (será sobrescrito si el fichero ya existe).

remote_filename

La ruta hacia el fichero remoto.

mode

El modo de transferencia. Debe ser FTP_ASCII o FTP_BINARY.

offset

La posición en el 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_get()

<?php

// Definición de algunas variables
$local_file = 'local.zip';
$server_file = 'server.zip';

// 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 $server_file y guardarlo en el fichero $local_file
if (ftp_get($ftp, $local_file, $server_file, FTP_BINARY)) {
echo
"El fichero $local_file ha sido escrito con éxito\n";
} else {
echo
"Hay un problema\n";
}

// Cierre de la conexión
ftp_close($ftp);

?>

Ver también

  • ftp_pasv() - Activa o desactiva el modo pasivo
  • ftp_fget() - Descarga un fichero a través de FTP en un fichero local
  • 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)