PHP 8.4.0 RC4 available for testing

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