ftp_nb_fget
(PHP 4 >= 4.3.0, PHP 5)
ftp_nb_fget — Скачивает файл с FTP сервера в асинхронном режиме и сохраняет его в предварительно открытом файле
Описание
$ftp_stream
, resource $handle
, string $remote_file
, int $mode
[, int $resumepos = 0
] )ftp_nb_fget() скачивает удалённый файл с FTP-сервера.
Разница между этой функцией и ftp_fget() заключается в том, что эта функция получает файл асинхронно, так что ваша программа может совершать другие операции, пока файл скачивается.
Список параметров
-
ftp_stream -
Идентификатор соединения с FTP-сервером.
-
handle -
Открытый файловый дескриптор для сохранения данных.
-
remote_file -
Путь к удалённому файлу.
-
mode -
Режим передачи. Должен быть либо
FTP_ASCII, либоFTP_BINARY. -
resumepos -
Позиция начала загрузки в удаленном файле.
Возвращаемые значения
Возвращает FTP_FAILED, FTP_FINISHED
или FTP_MOREDATA.
Примеры
Пример #1 Пример использования ftp_nb_fget()
<?php
// открыть файл для записи
$file = 'index.php';
$fp = fopen($file, 'w');
$conn_id = ftp_connect($ftp_server);
$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);
// Начало скачивания
$ret = ftp_nb_fget($conn_id, $fp, $file, FTP_BINARY);
while ($ret == FTP_MOREDATA) {
// производим какие-то действия ...
echo ".";
// продолжение скачивания ...
$ret = ftp_nb_continue($conn_id);
}
if ($ret != FTP_FINISHED) {
echo "При скачивании файла произошла ошибка...";
exit(1);
}
// закрытие файла
fclose($fp);
?>
Смотрите также
- ftp_nb_get() - Скачивает файл с 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
Коментарии
If you want to monitor the progress of the download, you may use the filesize()-Function.
But note: The results of said function are cached, so you'll always get 0 bytes. Call clearstatcache() before calling filesize() to determine the actual size of the downloaded file.
This may have performance implications, but if you want to provide the information, there's no way around it.
Above sample extended:
<?php
// get the size of the remote file
$fs = ftp_size($my_connection, "test");
// Initate the download
$ret = ftp_nb_get($my_connection, "test", "README", FTP_BINARY);
while ($ret == FTP_MOREDATA) {
clearstatcache(); // <- this is important
$dld = filesize($locfile);
if ( $dld > 0 ){
// calculate percentage
$i = ($dld/$fs)*100;
printf("\r\t%d%% downloaded", $i);
}
// Continue downloading...
$ret = ftp_nb_continue ($my_connection);
}
if ($ret != FTP_FINISHED) {
echo "There was an error downloading the file...";
exit(1);
}
?>
Philip