ftp_nb_fput

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

ftp_nb_fput — Загружает предварительно открытый файл на FTP-сервер в асинхронном режиме

Описание

function ftp_nb_fput(
FTP\Connection $ftp,
string $remote_filename,
resource $stream,
int $mode = FTP_BINARY ,
int $offset = 0
): int

ftp_nb_fput() закачивает данные из дескриптора файла в удалённый файл на FTP-сервере.

Разница между этой функцией и ftp_fput() заключается в том, что эта функция загружает файл асинхронно, так что ваша программа может совершать другие операции, пока файл закачивается.

Список параметров

ftp: Экземпляр класса FTP\Connection .
remote_filename: Путь к удалённому файлу.
stream: Открытый файловый дескриптор локального файла. Чтение прекращается при достижении конца файла.
mode: Режим передачи. Должен быть либо FTP_ASCII , либо FTP_BINARY .
offset: Позиция начала загрузки в удалённом файле.

Возвращаемые значения

Возвращает FTP_FAILED , FTP_FINISHED или FTP_MOREDATA .

Список изменений

Версия	Описание
8.1.0	Параметр `ftp` теперь принимает объект FTP\Connection ; раньше параметр ждал ресурс (resource ).
7.3.0	Теперь параметр `mode` опционален. Раньше он был обязательным.

Примеры

Пример #1 Пример использования ftp_nb_fput()

<?php
$file = 'index.php';
$fp = fopen($file, 'r');
$ftp = ftp_connect($ftp_server);
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);
// Начало загрузки
$ret = ftp_nb_fput($ftp, $file, $fp, FTP_BINARY);
while ($ret == FTP_MOREDATA) {
 // производим какие-то действия ...
 echo ".";
 // продолжение загрузки ...
 $ret = ftp_nb_continue($ftp);
}
if ($ret != FTP_FINISHED) {
 echo "При загрузке файла произошла ошибка...";
 exit(1);
}
fclose($fp);
?>

Смотрите также

ftp_nb_put() - Загружает файл на FTP-сервер в асинхронном режиме
ftp_nb_continue() - Продолжает асинхронную операцию
ftp_put() - Загружает файл на FTP-сервер
ftp_fput() - Загружает предварительно открытый файл на FTP-сервер

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

+Добавить

Примечания пользователей 2 notes

down

jascha at bluestatedigital dot com ¶

21 years ago

There is an easy way to check progress while uploading a file. Just use the ftell function to watch the position in the file handle. ftp_nb_fput will increment the position as the file is transferred.
Example:
<?
 $fh = fopen ($file_name, "r");
 $ret = ftp_nb_fput ($ftp, $file_name, $fh, FTP_BINARY);
 while ($ret == FTP_MOREDATA) {
 print ftell ($fh)."\n";
 $ret = ftp_nb_continue($ftp);
 }
 if ($ret != FTP_FINISHED) {
 print ("error uploading\n");
 exit(1);
 }
 fclose($fh);
?>
This will print out the number of bytes transferred thus far, every time the loop runs. Coverting this into a percentage is simply a matter of dividing the number of bytes transferred by the total size of the file.

down

-3

marcopardo at gmx dot de ¶

6 years ago

FTP_FAILED = 0
FTP_FINISHED = 1
FTP_MOREDATA = 2

+Добавить