ftp_nb_get
(PHP 4 >= 4.3.0, PHP 5)
ftp_nb_get — Скачивает файл с FTP сервера в асинхронном режиме и сохраняет его в локальный файл
Описание
ftp_nb_get() скачивает удалённый файл с FTP сервера и сохраняет его в локальный файл.
Разница между это функцией и ftp_get() заключается в том, что эта функция получает файл асинхронно, так что ваша программа может совершать другие операции, пока файл cкачивается.
Список параметров
- 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_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.