FTP_FGET(3)								 1							       FTP_FGET(3)

ftp_fget - Downloads a file from the FTP server and saves to an open file

SYNOPSIS

       bool ftp_fget (resource	$ftp_stream, resource  $handle, string	$remote_file, int  $mode, [int	$resumepos])

DESCRIPTION

       ftp_fget(3) retrieves $remote_file from the FTP server, and writes it to the given file pointer.

PARAMETERS

	      o $ftp_stream
		- The link identifier of the FTP connection.

	      o $handle
		- An open file pointer in which we store the data.

	      o $remote_file
		- The remote file path.

	      o $mode
		- The transfer mode. Must be either FTP_ASCII or FTP_BINARY.

	      o $resumepos
		- The position in the remote file to start downloading from.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      ftp_fget(3) example

	      <?php

	      // path to remote file
	      $remote_file = 'somefile.txt';
	      $local_file = 'localfile.txt';

	      // open some file to write to
	      $handle = fopen($local_file, 'w');

	      // set up basic connection
	      $conn_id = ftp_connect($ftp_server);

	      // login with username and password
	      $login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);

	      // try to download $remote_file and save it to $handle
	      if (ftp_fget($conn_id, $handle, $remote_file, FTP_ASCII, 0)) {
	       echo "successfully written to $local_file
";
	      } else {
	       echo "There was a problem while downloading $remote_file to $local_file
";
	      }

	      // close the connection and the file handler
	      ftp_close($conn_id);
	      fclose($handle);
	      ?>

SEE ALSO

       ftp_get(3), ftp_nb_get(3), ftp_nb_fget(3).

PHP Documentation Group 													       FTP_FGET(3)