ftp_nb_fput
(PHP 4 >= 4.3.0, PHP 5)
ftp_nb_fput — Загружает предварительно открытый файл на FTP-сервер в асинхронном режиме
Описание
$ftp_stream
, string $remote_file
, resource $handle
, int $mode
[, int $startpos = 0
] )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_nb_put() - Загружает файл на FTP сервер в асинхронном режиме
- ftp_nb_continue() - Продолжает асинхронную операцию
- ftp_put() - Загружает файл на FTP-сервер
- ftp_fput() - Загружает предварительно открытый файл на 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
Коментарии
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