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)

add a note

User Contributed Notes 6 notes

up
7
broom at alturnanetworks dot com
16 years ago
Another ftp_get_contents approach, using a temperary stream handler. Returns file contents as string.

<?php
function ftp_get_contents ($conn_id, $filename,
//Create temp handler:
$tempHandle = fopen('php://temp', 'r+');

//Get file from FTP assuming that it exists:
ftp_fget($conn_id, $tempHandle, $filename, FTP_ASCII, 0));

//Getting detailed stats to check filesize:
$fstats = fstat($tempHandle);

return
fread($tempHandle, $fstats['size']);
}
?>
up
4
broom at alturnanetworks dot com
16 years ago
<?php
/**
* Function returns contents via FTP connection and returns it as string (right version...)
*/
function ftp_get_contents ($conn_id, $filename) {
//Create temp handler:
$tempHandle = fopen('php://temp', 'r+');

//Get file from FTP:
if (@ftp_fget($conn_id, $tempHandle, $filename, FTP_ASCII, 0)) {
rewind($tempHandle);
return
stream_get_contents($tempHandle);
} else {
return
false;
}
}
?>
up
0
mike at eastghost dot com
12 years ago
You might need to use ftp_pasv() if you're behind a firewall and receiving odd timeouts, file creation but now local data saving, etc.
up
-1
lionskape at gmail dot com
8 years ago
if you are using windows ftp-server with cp1251 encoding there are some troubles with russian "я" in filename\path.

php use telnet to connect ftp-server and there are special symbol with code 255 in telnet protocol. You can try use ftp_raw($connection, 'OPTS UTF8 ON'); and work in utf-8 (if server provides it).

P.S. sorry for my bad english
up
-2
justrafi at gmail dot com
17 years ago
I was in need to synchronize two folders on two separate servers, one is a Windows server, and the other is a Linux server. I created this short and sweet function to help me do this. PLEASE NOTICE: This will not copy folders, and probably will fail if remote folder contains anything else than files.

function sync_folders($host, $port, $username, $password, $remote_dir, $local_dir, $passive_mode = true) {
$conn_id = ftp_connect($host, $port);
if (!$conn_id) return false; # fail to connect
if (!ftp_login($conn_id, $username, $password)) { ftp_close($conn_id); return false; } # fail to login
ftp_pasv($conn_id, $passive_mode);
if (!ftp_chdir($conn_id, $remote_dir)) { ftp_close($conn_id); return false; } # fail to change dir
if (substr($local_dir, -1) != '/') $local_dir .= '/';

$list = ftp_nlist($conn_id, '.');
sort($list);
foreach ($list as $file) {
if (!file_exists($local_dir . $file)) {
$is_copied = ftp_get($conn_id, $local_dir . $file, $file, FTP_BINARY);
}
}
ftp_close($conn_id);
return true;
}
up
-2
rodrigo-rocha at oi dot net dot br
22 years ago
If you suply only a filename to the second parameter of function the ftp_get will open a pointer to the local file creating it and write to it.It's ok if your server dont execute for to mutch time and you dont get too many files but if you do it too many times the pointers created by ftp_get will not be closed and will end your opened files capacity at your server making it to do not open any more files until you restart it.
To Top