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

# ftp_fput

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

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

### Описание

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

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

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

`ftp`
  Экземпляр класса FTP\Connection.
`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-сервер в асинхронном режиме

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open