(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
ftp_set_option — Устанавливает параметры работы с FTP-сервером
Функция управляет параметрами взаимодействия с сервером через активное FTP-соединение.
ftpЭкземпляр класса FTP\Connection.
optionПараметр поддерживает только следующие опции:
FTP_TIMEOUT_SEC |
Опция изменяет время ожидания в секундах для функций, которые выполняют сетевые операции.
Параметр value принимает для опции только целочисленные значения больше 0.
По умолчанию время ожидания равно 90 секундам.
|
FTP_AUTOSEEK |
При включении опции перед выполнением GET-
или PUT-запросов с параметром resumepos
или startpos указатель вначале перемещается
на заданную позицию в файле. По умолчанию параметр включён.
|
FTP_USEPASVADDRESS |
При отключении параметра PHP проигнорирует IP-адрес, который вернул сервер в ответ на команду PASV,
и вместо адреса сервера возьмёт IP-адрес хоста, который указали при вызове функции ftp_connect().
Параметр value принимает для опции только логические значения.
|
value
Параметр изменяет значение опции,
которую указали в параметре option.
Функция возвращает логическое значение true.
При передаче в параметр option значения, которое функция не поддерживает,
выбрасывается ошибка ValueError.
Функция выбрасывает ошибку TypeError, если в параметр
value передали значение, тип которого не соответствует типу опции в параметре option.
| Версия | Описание |
|---|---|
| 8.5.0 |
Тип значения возврата изменился на true; раньше объявление содержало тип bool.
|
| 8.1.0 |
Параметр ftp теперь принимает объект FTP\Connection;
раньше параметр ждал ресурс (resource).
|
Пример #1 Пример установки параметров FTP-сеанса функцией ftp_set_option()
<?php
// Установка времени сетевого ожидания равного 10 секундам
ftp_set_option($ftp, FTP_TIMEOUT_SEC, 10);