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

# ftp_pasv

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

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

### Описание

function 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);
    ?>

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