ftp_pasv

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

ftp_pasvВключает или выключает пассивный режим

Описание

ftp_pasv(FTP\Connection $ftp, bool $enable): bool

ftp_pasv() включает или выключает пассивный режим. В пассивном режиме передача данных инициируется клиентом, а не сервером. Данный режим может понадобиться в случае, если клиент находится за брандмауэром.

Обратите внимание, что ftp_pasv() может быть вызвана только после успешной авторизации, иначе она завершится с ошибкой.

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

ftp

Экземпляр класса FTP\Connection.

enable

Если true, пассивный режим будет включён, иначе выключен.

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

Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.

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

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

Примеры

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

<?php
$file
= 'somefile.txt';
$remote_file = 'readme.txt';

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

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

// включение пассивного режима
ftp_pasv($conn_id, true);

// загрузка файла
if (ftp_put($conn_id, $remote_file, $file, FTP_ASCII)) {
echo
"$file успешно загружен на сервер\n";
} else {
echo
"Не удалось загрузить $file на сервер\n";
}

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