array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.ftp-set-option.php', 1 => 'ftp_set_option', 2 => 'Устанавливает параметры работы с FTP-сервером', ), 'up' => array ( 0 => 'ref.ftp.php', 1 => 'Функции FTP', ), 'prev' => array ( 0 => 'function.ftp-rmdir.php', 1 => 'ftp_rmdir', ), 'next' => array ( 0 => 'function.ftp-site.php', 1 => 'ftp_site', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/ftp/functions/ftp-set-option.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

ftp_set_option

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

ftp_set_option — Устанавливает параметры работы с FTP-сервером

Описание

ftp_set_option(FTP\Connection $ftp, int $option, int|bool $value): true

Функция управляет параметрами взаимодействия с сервером через активное FTP-соединение.

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

ftp

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

option

Параметр поддерживает только следующие опции:
Опции FTP-сеанса
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);

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