ftp_fget

Synopsis

Returns

TRUE on success or FALSE on error

Description

Gets a remote file from the FTP server and copies it to a local filePointer . This function sends a "RETR" command to the server, the user must have read permissions on the FTP server for this function to work. Possible transferMode s are FTP_BINARY and FTP_ASCII. The source parameter may be an absolute filesystem path or it may be relative to the remote current directory. This function is similair to ftp_get, except that ftp_get writes the file to the destination and closes the file stream, while ftp_fget leaves the file stream open. To learn more about file pointers look at fopen and related functions.

Version

PHP 3>= 3.0.13, PHP 4 >= 4.0b4

Example

$ftpStream = ftp_connect('my.ftp.server');
$loginResult = ftp_login($ftpStream, 'username', 'password');
if ($loginResult) {
            //local file location is in the same directory as the PHP file
            $destination = 'local.txt.';

            //open a file pointer for writing in the same directory as the PHP file
   $fp = fopen($destination, 'w');

            //retrieve the file from the FTP server and write it to the file pointer 
   ftp_fget($ftpStream, $fp, 'remote.txt', FTP_ASCII);
            
            //close the file stream
            fclose($fp);

            //print out the contents of the file to the screen and close the file
            $fp = fopen($destination, 'r');
   fpassthru($fp);
}
ftp_quit($ftpStream);