ftp_nb_fput

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

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

    Описание

    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

    An FTP\Connection instance.

    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-сервер
    To Top