ftp_fput

    (PHP 4, PHP 5, PHP 7, PHP 8)

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

    Описание

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

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

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

    ftp

    An FTP\Connection instance.

    remote_filename

    Путь к удалённому файлу.

    stream

    Открытый файловый дескриптор локального файла. Чтение прекращается при достижении конца файла.

    mode

    Режим передачи. Должен быть либо FTP_ASCII, либо FTP_BINARY.

    offset

    Позиция начала загрузки в удалённом файле.

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

    Возвращает true в случае успешного выполнения или false, если возникла ошибка.

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

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

    Примеры

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

    <?php

    // открыть файл для чтения
    $file = 'somefile.txt';
    $fp = fopen($file, 'r');

    // установка соединения
    $ftp = ftp_connect($ftp_server);

    // вход с именем пользователя и паролем
    $login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

    // попытка загрузки файла
    if (ftp_fput($ftp, $file, $fp, FTP_ASCII)) {
    echo     "Файл $file успешно загружен\n";
    } else {
    echo     "При загрузке $file произошла проблема\n";
    }

    // закрываем соединение и дескриптор файла
    ftp_close($ftp);
    fclose($fp);

    ?>

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

    • ftp_put() - Загружает файл на FTP-сервер
    • ftp_nb_fput() - Загружает предварительно открытый файл на FTP-сервер в асинхронном режиме
    • ftp_nb_put() - Загружает файл на FTP-сервер в асинхронном режиме
    To Top