PHP ftp_nb_fput() Function
Example
Open local file, and upload it (non-blocking) to a file on the FTP server:
<?php
// connect and login to FTP server
$ftp_server = "ftp.example.com";
$ftp_conn = ftp_connect($ftp_server) or die("Could not connect to $ftp_server");
$login = ftp_login($ftp_conn, $ftp_username, $ftp_userpass);
$server_file = "serverfile.txt";
// open local file
$local_file = "localfile.txt";
$fp = fopen($local_file,"r");
// initiate upload
$d = ftp_nb_fput($ftp_conn, $server_file, $fp, FTP_BINARY)
while ($d == FTP_MOREDATA)
{
// do whatever you want
// continue uploading
$d = ftp_nb_continue($ftp_conn);
}
if ($d != FTP_FINISHED)
{
echo "Error uploading $local_file";
exit(1);
}
// close connection
ftp_close($ftp_conn);
?>
Definition and Usage
The ftp_nb_fput() function uploads an open local file to the FTP server (non-blocking).
Tip: This function (as opposite to ftp_fput()) retrieves the file asynchronously, so you can perform other operations while the file is being downloaded.
Syntax
ftp_nb_fput(ftp_conn, remote_file, open_file, mode, startpos);
Parameter Values
| Parameter | Description |
|---|---|
| ftp_conn | Required. Specifies the FTP connection to use |
| remote_file | Required. Specifies the file path to upload to |
| open_file | Required. Specifies a pointer to the open local file |
| mode | Optional. Specifies the transfer mode. Possible values: FTP_ASCII or FTP_BINARY |
| startpos | Optional. Specifies the position in the remote file to start uploading to |
Technical Details
| Return Value: | One of the following values:
|
|---|---|
| PHP Version: | 4.3+ |
| PHP Changelog: | PHP 7.3 - The mode parameter was made optional. |
❮ PHP FTP Reference
