ftp_get

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

ftp_getСкачивает файл с FTP-сервера

Описание

ftp_get(
    FTP\Connection$ftp,
    string$local_filename,
    string$remote_filename,
    int$mode = FTP_BINARY,
    int$offset = 0
): bool

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

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

ftp

An FTP\Connection instance.

local_filename

Путь к локальному файлу (файл будет перезаписан, если уже существует).

remote_filename

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

mode

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

offset

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

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

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

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

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

Примеры

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

<?php

// объявление переменных
$local_file = 'local.zip';
$server_file = 'server.zip';

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

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

// попытка скачать $server_file и сохранить в $local_file
if (ftp_get($conn_id, $local_file, $server_file, FTP_BINARY)) {
echo
"Произведена запись в $local_file\n";
} else {
echo
"Не удалось завершить операцию\n";
}

// закрытие соединения
ftp_close($conn_id);

?>

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

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