Php/docs/function.ftp-fput

• PHP Manual
• FTP Functions
• Uploads from an open file to the FTP server

ftp_fput

(PHP 4, PHP 5, PHP 7)

ftp_fput — Uploads from an open file to the FTP server

Description

ftp_fput ( resource $ftp_stream , string $remote_file , resource $handle [, int $mode = FTP_BINARY [, int $startpos = 0 ]] ) : bool

ftp_fput() uploads the data from a file pointer to a remote file on the FTP server.

Parameters

ftp_stream

The link identifier of the FTP connection.

remote_file

The remote file path.

handle

An open file pointer on the local file. Reading stops at end of file.

mode

The transfer mode. Must be either FTP_ASCII or FTP_BINARY.

startpos

The position in the remote file to start uploading to.

Return Values

Returns TRUE on success or FALSE on failure.

Changelog

Version	Description
7.3.0	The mode parameter is now optional. Formerly it has been mandatory.

Examples

Example #1 ftp_fput() example

<?php// open some file for reading$file = 'somefile.txt';$fp = fopen($file, 'r');// 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 upload $fileif (ftp_fput($conn_id, $file, $fp, FTP_ASCII)) {    echo "Successfully uploaded $file\n";} else {    echo "There was a problem while uploading $file\n";}// close the connection and the file handlerftp_close($conn_id);fclose($fp);?>

See Also

• ftp_put() - Uploads a file to the FTP server
• ftp_nb_fput() - Stores a file from an open file to the FTP server (non-blocking)
• ftp_nb_put() - Stores a file on the FTP server (non-blocking)