ftp_nb_get
(PHP 4 >= 4.3.0, PHP 5, PHP 7)
ftp_nb_get — Скачивает файл с FTP-сервера в асинхронном режиме и сохраняет его в локальный файл
Описание
$ftp_stream
, string $local_file
, string $remote_file
, int $mode
[, int $resumepos
= 0
] )ftp_nb_get() скачивает удалённый файл с FTP-сервера и сохраняет его в локальный файл.
Разница между этой функцией и ftp_get() заключается в том, что эта функция получает файл асинхронно, так что ваша программа может совершать другие операции, пока файл скачивается.
Список параметров
-
ftp_stream
-
Идентификатор соединения с FTP-сервером.
-
local_file
-
Путь к локальному файлу (файл будет перезаписан, если уже существует).
-
remote_file
-
Путь к удалённому файлу.
-
mode
-
Режим передачи. Должен быть либо
FTP_ASCII
, либоFTP_BINARY
. -
resumepos
-
Позиция начала загрузки в удаленном файле.
Возвращаемые значения
Возвращает FTP_FAILED
, FTP_FINISHED
или FTP_MOREDATA
.
Примеры
Пример #1 Пример использования ftp_nb_get()
<?php
// Начало скачивания
$ret = ftp_nb_get($my_connection, "test", "README", FTP_BINARY);
while ($ret == FTP_MOREDATA) {
// производим какие-то действия ...
echo ".";
// продолжение скачивания ...
$ret = ftp_nb_continue($my_connection);
}
if ($ret != FTP_FINISHED) {
echo "При скачивании файла произошла ошибка...";
exit(1);
}
?>
Пример #2 Возобновление скачивания файла с помощью ftp_nb_get()
<?php
// Начало скачивания
$ret = ftp_nb_get($my_connection, "test", "README", FTP_BINARY,
filesize("test"));
// ИЛИ: $ret = ftp_nb_get($my_connection, "test", "README",
// FTP_BINARY, FTP_AUTORESUME);
while ($ret == FTP_MOREDATA) {
// производим какие-то действия ...
echo ".";
// продолжение скачивания ...
$ret = ftp_nb_continue($my_connection);
}
if ($ret != FTP_FINISHED) {
echo "При скачивании файла произошла ошибка...";
exit(1);
}
?>
Пример #3 Скачивание файла начиная с позиции 100 в новый файл с помощью ftp_nb_get()
<?php
// Запрет FTP_AUTOSEEK
ftp_set_option($my_connection, FTP_AUTOSEEK, false);
// Начало скачивания
$ret = ftp_nb_get($my_connection, "newfile", "README", FTP_BINARY, 100);
while ($ret == FTP_MOREDATA) {
/* ... */
// продолжение скачивания ...
$ret = ftp_nb_continue($my_connection);
}
?>
В последнем примере, newfile будет на 100 байт
меньше, чем README на FTP сервере, потому что
скачивание начинается со смещения 100. Если не запретить
FTP_AUTOSEEK
, первые 100 байт файла
newfile будут содержать
'\0'.
Смотрите также
- ftp_nb_fget() - Скачивает файл с FTP сервера в асинхронном режиме и сохраняет его в предварительно открытом файле
- ftp_nb_continue() - Продолжает асинхронную операцию
- ftp_fget() - Скачивает файл с FTP-сервера и сохраняет его в предварительно открытом файле
- ftp_get() - Загружает файл с FTP-сервера
- ftp_alloc
- ftp_cdup
- ftp_chdir
- ftp_chmod
- ftp_close
- ftp_connect
- ftp_delete
- ftp_exec
- ftp_fget
- ftp_fput
- ftp_get_option
- ftp_get
- ftp_login
- ftp_mdtm
- ftp_mkdir
- ftp_nb_continue
- ftp_nb_fget
- ftp_nb_fput
- ftp_nb_get
- ftp_nb_put
- ftp_nlist
- ftp_pasv
- ftp_put
- ftp_pwd
- ftp_quit
- ftp_raw
- ftp_rawlist
- ftp_rename
- ftp_rmdir
- ftp_set_option
- ftp_site
- ftp_size
- ftp_ssl_connect
- ftp_systype
Коментарии
Note that you may have to keep calling ftp_nb_continue in order to complete the download. For example, if you do this:
<?php
ftp_nb_get($conn,$localfile,$remotefile,FTP_BINARY)
//do some LONG time work
while(ftp_nb_continue($conn)!=FTP_FINISHED){}
?>
Your local file may only contains a few kilobytes and the later ftp_nb_continue will keep raising warning of no more data (due to connection time out, I guess).
So you may want to do this instead:
<?php
$dl=ftp_nb_get($conn,$localfile,$remotefile,FTP_BINARY)
//part of long time work
if(ftp_nb_continue($conn)==FTP_MOREDATA) {}
//part of long time work
if(ftp_nb_continue($conn)==FTP_MOREDATA) {}
//continue to do this until you finish the long time work
while(ftp_nb_continue($conn)==FTP_MOREDATA){}
?>
This happened on my Windows XP + PHP 5.3.8 under CLI. Hope this helps someone.