ftp_nb_fget
PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8
ftp_nb_fget - Retrieves a file from the FTP server and writes it to an open file (non-blocking)
Manual
ftp_nb_fget(
FTP\Connection$ftp,
resource$stream,
string$remote_filename,
[int$mode = FTP_BINARY],
[int$offset = 0]
): int
FTP\Connection$ftp,
resource$stream,
string$remote_filename,
[int$mode = FTP_BINARY],
[int$offset = 0]
): int
ftp_nb_fget retrieves a remote file from the FTP server.
The difference between this function and ftp_fget is that this function retrieves the file asynchronously, so your program can perform other operations while the file is being downloaded.
Parameters
- ftp
-
An FTP\Connection instance.
- stream
-
An open file pointer in which we store the data.
- remote_filename
-
The remote file path.
- mode
-
The transfer mode. Must be either FTP_ASCII or FTP_BINARY.
- offset
-
The position in the remote file to start downloading from.
Return Values
Returns FTP_FAILED or FTP_FINISHED or FTP_MOREDATA.
Changelog
Version | Description |
8.1.0 | The ftp parameter expects an FTP\Connection instance now; previously, a resource was expected. |
7.3.0 | The mode parameter is now optional. Formerly it has been mandatory. |