ftp_fget

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

    ftp_fget — Скачивает файл с FTP-сервера и сохраняет его в предварительно открытом файле

    Описание

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

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

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

    ftp

    An FTP\Connection instance.

    stream

    Открытый файловый дескриптор, в который будут сохранены данные.

    remote_filename

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

    mode

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

    offset

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

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

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

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

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

    Примеры

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

    <?php

    // путь к удалённому файлу
    $remote_file = 'somefile.txt';
    $local_file = 'localfile.txt';

    // открываем файл для записи
    $handle = fopen($local_file, 'w');

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

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

    // пытаемся скачать файл и сохранить его в $handle
    if (ftp_fget($ftp, $handle, $remote_file, FTP_ASCII, 0)) {
    echo     "Произведена запись в $local_file\n";
    } else {
    echo     "При скачивании $remote_file в $local_file произошла проблема\n";
    }

    // закрытие соединения и локального файла
    ftp_close($ftp);
    fclose($handle);
    ?>

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

    • ftp_get() - Скачивает файл с FTP-сервера
    • ftp_nb_get() - Скачивает файл с FTP-сервера в асинхронном режиме и сохраняет его в локальный файл
    • ftp_nb_fget() - Скачивает файл с FTP-сервера в асинхронном режиме и сохраняет его в предварительно открытом файле
    To Top