ftp_nb_get
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
ftp_nb_get — Завантажує файл із FTP-сервера в асинхронному режимі та зберігає його у локальний файл
Опис
ftp_nb_get( FTP\Connection $ftp, string $local_filename, string $remote_filename, int $mode = FTP_BINARY, int $offset = 0): int|false
ftp_nb_get() завантажує віддалений файл з FTP-сервера та зберігає його у локальний файл.
Різниця між цією функцією та ftp_get() полягає в тому, що ця функція отримує файл асинхронно, так що ваша програма може здійснювати інші операції, поки файл завантажується.
Список параметрів
ftp
AnFTP\Connectioninstance.
local_filename
Шлях до локального файлу (файл буде перезаписано, якщо існує).
remote_filename
Шлях до віддаленого файлу.
mode
Режим передачі. Має бути або FTP_ASCII
, либо**FTP_BINARY
**
offset
Позиція початку завантаження у віддаленому файлі.
Значення, що повертаються
Повертає FTP_FAILED
FTP_FINISHED
або FTP_MOREDATA
або false
якщо неможливо відкрити локальний файл.
список змін
Версия | Опис |
---|---|
8.1.0 | Параметрftp тепер чекає екземпляр FTP\Connection; раніше очікувався ресурс (resource |
7.3.0 | Тепер параметр mode опціональний. Раніше він був обов'язковим. |
Приклади
Приклад #1 Приклад використання ftp_nb_get()****
Loading...
Приклад #2 Возобновление скачивания файла с помощьюftp_nb_get()****
Loading...
Приклад #3 Завантаження файлу починаючи з позиції 100 в новий файл за допомогою ftp_nb_get()
Loading...
В останньому прикладі, newfile буде на 100 байт менше, ніж README на FTP-сервері, тому що завантаження починається зі зміщення 100. Якщо не заборонити FTP_AUTOSEEK
, перші 100 байт файлу newfile будуть містити '\0'
Дивіться також
- ftp_nb_fget() - Завантажує файл з FTP-сервера в асинхронному режимі та зберігає його у попередньо відкритому файлі
- ftp_nb_continue() - Продовжує асинхронну операцію
- ftp_fget() - Завантажує файл з FTP-сервера та зберігає його у попередньо відкритому файлі
- ftp_get() - Завантажує файл із FTP-сервера