(PHP 4 >= 4.3.0, PHP 5, PHP 7)
ftp_nb_put — Загружает файл на FTP-сервер в асинхронном режиме
$ftp_stream
, string $remote_file
, string $local_file
[, int $mode = FTP_IMAGE
[, int $startpos = 0
]] ) : intftp_nb_put() загружает локальный файл на FTP-сервер.
Отличие этой функции от ftp_put() состоит в том, что загрузка файла происходит в асинхронном режиме, что позволяет программе выполнять другие операции во время загрузки.
ftp_streamИдентификатор соединения с FTP-сервером.
remote_fileПуть к файлу на сервере.
local_fileПуть к локальному файлу.
mode
Режим передачи. Может принимать значения
FTP_ASCII или FTP_BINARY.
startposПозиция в удаленном файле, в которую начинается загрузка
Возвращает FTP_FAILED, FTP_FINISHED
или FTP_MOREDATA.
| Версия | Описание |
|---|---|
| 7.3.0 |
Теперь параметр mode опционален. Раньше он
был обязательным.
|
Пример #1 Пример использования ftp_nb_put()
<?php
// Начало загрузки
$ret = ftp_nb_put($my_connection, "test.remote", "test.local", FTP_BINARY);
while ($ret == FTP_MOREDATA) {
// Производим какие-то действия ...
echo ".";
// Продолжение загрузки ...
$ret = ftp_nb_continue($my_connection);
}
if ($ret != FTP_FINISHED) {
echo "При загрузке файла произошла ошибка...";
exit(1);
}
?>
Пример #2 Возобновление загрузки файла с помощью ftp_nb_put()
<?php
// Начало загрузки
$ret = ftp_nb_put($my_connection, "test.remote", "test.local",
FTP_BINARY, ftp_size("test.remote"));
// ИЛИ: $ret = ftp_nb_put($my_connection, "test.remote", "test.local",
// FTP_BINARY, FTP_AUTORESUME);
while ($ret == FTP_MOREDATA) {
// Производим какие-то действия ...
echo ".";
// Продолжение загрузки ...
$ret = ftp_nb_continue($my_connection);
}
if ($ret != FTP_FINISHED) {
echo "При загрузке файла произошла ошибка...";
exit(1);
}
?>