ftp_ssl_connect

    (PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

    ftp_ssl_connect — Устанавливает соединение с FTP-сервером по протоколу SSL

    Описание

    ftp_ssl_connect(string $hostname, int $port = 21, int $timeout = 90): FTP\Connection|false

    Функция ftp_ssl_connect() открывает явное SSL-соединение с FTP-сервером, который указали в аргументе hostname. Подразумевается, что функция ftp_ssl_connect() завершит работу без ошибок, даже если сервер не настроили для обработки FTP-подключений по SSL-протоколу. Клиент отправит команду AUTH FTP только при вызове функции ftp_login(), поэтому вызов функции ftp_login() завершится ошибкой. Соединение, которое установили функцией ftp_ssl_connect(), не будет выполнять проверку сертификата узла одноранговой сети.

    Замечание: Почему функцию определили не в каждой сборке

    До PHP 7.0.0 доступ к функции ftp_ssl_connect() открывался, только если модуль FTP и поддержку модуля OpenSSL статически встраивали в PHP-сборку; поэтому в официальных PHP-сборках для ОС Windows функция оставалась неопределённой. Приходилось самому компилировать двоичные файлы PHP, чтобы включить поддержку функции в Windows.

    Замечание:

    Функция ftp_ssl_connect() не работает с протоколом sFTP. Информацию о взаимодействии PHP с протоколом sFTP даёт описание функции ssh2_sftp().

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

    hostname

    Адрес FTP-сервера. Параметру нельзя содержать слешей в конце имени хоста или префикса ftp:// в начале.

    port

    Параметр определяет альтернативный порт соединения. По умолчанию функция устанавливает подключение на стандартном для FTP-протокола порте — 21, если аргумент опустили или указали значение 0.

    timeout

    Параметр определяет время ожидания для сетевых операций, которые будут использовать подключение. Время ожидания по умолчанию составляет 90 секунд. Функции ftp_set_option() и ftp_get_option() также умеют изменять и запрашивать время ожидания.

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

    В случае успешного выполнения функция возвращает объект FTP\Connection или false, если возникла ошибка.

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

    Версия Описание
    8.1.0 Теперь функция возвращает экземпляр класса FTP\Connection; раньше возвращался ресурс (resource).

    Примеры

    Пример #1 Пример установки SSL-соединения с FTP-сервером функцией ftp_ssl_connect()

    <?php

    // Устанавливаем SSL-соединение
    $ftp = ftp_ssl_connect($ftp_server);

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

    if (!    $login_result) {
    // К этому времени PHP уже выдаст сообщение об ошибке уровня E_WARNING
    die("Не удалось войти");
    }

    echo     ftp_pwd($ftp);

    // Закрываем SSL-соединение
    ftp_close($ftp);

    ?>

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

    • ftp_connect() - Устанавливает соединение с FTP-сервером

    Нашли ошибку?

    Инструкция • Исправление • Сообщение об ошибке
    ＋Добавить

    Примечания пользователей

    Пользователи ещё не добавляли примечания для страницы
    To Top