ftp_nb_fput
(PHP 4 >= 4.3.0, PHP 5)
ftp_nb_fput — Загружает предварительно открытый файл на FTP сервер в асинхронном режиме
Описание
ftp_nb_fput() закачивает данные из дескриптора файла в удалённый файл на FTP сервере.
Разница между это функцией и ftp_fput() заключается в том, что эта функция получает файл асинхронно, так что ваша программа может совершать другие операции, пока файл закачивается.
Список параметров
- ftp_stream
-
Идентификатор соединения с FTP сервером
- remote_file
-
Путь к удалённому файлу.
- handle
-
Открытый файловый дескриптор локального файла. Чтение прекращается при достижении конца файла.
- mode
-
Режим передачи. Должен быть либо FTP_ASCII, либо FTP_BINARY.
- startpos
Возвращаемые значения
Возвращает FTP_FAILED, FTP_FINISHED или FTP_MOREDATA.
Примеры
Пример #1 Пример использования ftp_nb_fput()
<?php
$file = 'index.php';
$fp = fopen($file, 'r');
$conn_id = ftp_connect($ftp_server);
$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);
// Начало закачивания
$ret = ftp_nb_fput($conn_id, $file, $fp, FTP_BINARY);
while ($ret == FTP_MOREDATA) {
// производим какие-то дествия ...
echo ".";
// продолжение закачивания ...
$ret = ftp_nb_continue($conn_id);
}
if ($ret != FTP_FINISHED) {
echo "При закачивании файла произолшла ошибка...";
exit(1);
}
fclose($fp);
?>
- 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
Коментарии
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.
FTP_FAILED = 0FTP_FINISHED = 1
FTP_MOREDATA = 2