ftp_close()

Закрывает соединение с FTP сервером (PHP 4 >= 4.2.0, PHP 5)

Описание:

bool ftp_close ( resource ftp_stream )

ftp_close() закрывает указанный идентификатор соединения с сервером и освобождает resource.

Замечание: После вызова этой функции, соединение больше не может быть использовано, и при необходимости должно быть установлено заново при помощи функции ftp_connect().

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

ftp_stream - Идентификатор соединения с FTP сервером

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

Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.

Пример. Пример использования ftp_close()

<?php

// установка соединения
$conn_id = ftp_connect($ftp_server);

// вход с именем пользователя и паролем
$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);

// вывод текущей директории
echo ftp_pwd($conn_id); // /

// закрытие соединения
ftp_close($conn_id);
?>

ftp_connect()

Устанавливает соединение с FTP сервером (PHP 3 >= 3.0.13, PHP 4, PHP 5)

Описание:

resource ftp_connect ( string host [, int port [, int timeout]] )

ftp_connect() устанавливает FTP соединение с указанным сервером host.

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

host - Адрес FTP сервера. Этот аргумент не должен содержать слешей в конце и префикса ftp:// в начале.
port - Этот аргумент указывает альтернативный порт для подключения. Если он опущен или установлен в ноль, то будет использован FTP порт по умолчанию - 21.
timeout - Этот аргумент указывает таймаут для всех последующих сетевых операций. Если опущен, используется значение по умолчанию, равное 90 секундам. Таймаут может быть изменён и получен в любой момент при помощи функций ftp_set_option() и ftp_get_option() соответственно.

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

Возвращает поток FTP в случае успешного выполнение или FALSE в случае ошибки.

Пример. Пример использования ftp_connect()

<?php

$ftp_server = "ftp.example.com";

// установить соединение или выйти
$conn_id = ftp_connect($ftp_server) or die("Не удалось установить соединение с $ftp_server");

?>

ftp_get_option()

Получает текущие параметры FTP соединения (PHP 4 >= 4.2.0, PHP 5)

Описание:

mixed ftp_get_option ( resource ftp_stream, int option )

Эта функция возвращает значение запрошенной опции option для указанного FTP соединения.

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

ftp_stream - Идентификатор соединения с FTP сервером
option - На текущий момент, поддежриваются следующие опции:

Поддерживаемые текущие опции FTP:

FTP_TIMEOUT_SEC Возвращает текущий таймаут, используемый в сетевых операциях.
FTP_AUTOSEEK Возвращает TRUE, если эта опция включена, иначе FALSE.

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

Возвращает значение в случае успешного выполнения, или FALSE, если указанная опция option не поддерживается. В последнем случае так же вызывается предупреждение.

Пример. Пример использования ftp_get_option()

<?php
// Получаем таймаут соединения
$timeout = ftp_get_option($conn_id, FTP_TIMEOUT_SEC);
?>

ftp_login()

Выполняет вход на FTP сервер (PHP 3 >= 3.0.13, PHP 4, PHP 5)

Описание:

bool ftp_login ( resource ftp_stream, string username, string password )

Выполняет вход на FTP сервер.

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

ftp_stream - Идентификатор соединения с FTP сервером
username - Имя пользователя (USER).
password - Пароль (PASS).

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

Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки. Если войти на сервер не удалось, PHP вызовет предупреждение.

Пример. Пример использования ftp_login()

<?php

$ftp_server = "ftp.example.com";
$ftp_user = "foo";
$ftp_pass = "bar";

// установить соединение или выйти
$conn_id = ftp_connect($ftp_server) or die("Не удалось установить соединение с $ftp_server");

// попытка входа
if (@ftp_login($conn_id, $ftp_user, $ftp_pass)) {
echo "Произведен вход на $ftp_server под именем $ftp_user\n";
} else {
echo "Не удалось войти под именем $ftp_user\n";
}

// close the connection
ftp_close($conn_id);
?>

ftp_pasv()

Включает или выключает пассивный режим (PHP 3 >= 3.0.13, PHP 4, PHP 5)

Описание:

bool ftp_pasv ( resource ftp_stream, bool pasv )

ftp_pasv() включает или выключает пассивный режим. В пассивном передача данных инициируется клиентом, а не сервером.

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

ftp_stream - Идентификатор соединения с FTP сервером
pasv - Если TRUE, пассивный режим будет включен, иначе выключен.

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

Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.

Пример. Пример использования 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);
?>

ftp_quit()

Псевдоним функции ftp_close() (PHP 3 >= 3.0.13, PHP 4, PHP 5)

Описание: функция является псевдонимом функции ftp_close().

ftp_set_option()

Устанавливает параметры соединения с FTP сервером (PHP 4 >= 4.2.0, PHP 5)

Описание:

bool ftp_set_option ( resource ftp_stream, int option, mixed value )

Эта функция устанавливает параметры соединения с FTP сервером.

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

ftp_stream - Идентификатор соединения с FTP сервером
option - В настоящее время поддерживаются следующие параметры:

Таблица. Поддерживаемые параметры

FTP_TIMEOUT_SEC Устанавливает таймаут сетевых операций, в секундах. Аргумент value должен быть целым, больше 0. По умолчанию таймаут равен 90 секунд.
FTP_AUTOSEEK При установке этого параметра, перед выполнением запросов GET или PUT с параметром resumepos или startpos указатель файла будет установлен на запрошенную позицию. Этот параметр установлен по умолчанию.

value - Назначение этого аргумента зависит от значения параметра option.

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

Возвращает TRUE если параметр был установлен; FALSE в противном случае. Если значение аргумента option не поддерживается или значение аргумента value не соответствует значению аргумента option, будет выведено предупреждение.

Пример. Пример использования ftp_set_option()

<?php
// установка таймаута в 10 секунд
ftp_set_option($conn_id, FTP_TIMEOUT_SEC, 10);
?>

ftp_ssl_connect()

Устанавливает соединение с FTP сервером через SSL (PHP 4 >= 4.3.0, PHP 5)

Описание:

resource ftp_ssl_connect ( string host [, int port [, int timeout]] )

ftp_ssl_connect() устанавливает соединение с FTP сервером, заданным аргументом host, через SSL.

Почему эта функция может быть не определена: Функция ftp_ssl_connect() доступна только если PHP был собран с поддержкой OpenSSL. Под Windows, вам придется собрать PHP самостоятельно для включения поддержки OpenSSL.

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

host - Имя хоста или IP адрес, без слэшей или ftp://
port - Задает порт, на котором устанавливается соединение. Если равен нулю или опущен, по умолчанию используется стандартный для протокола FTP порт 21
timeout

Задает таймаут для всех операций с этим соединением. По умолчанию таймаут устанавливается в 90 секунд. Получить и установить значение таймаута можно также с помощью функций ftp_get_option() и ftp_set_option()

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

Возвращает дескриптор соединения, или FALSE при возникновении ошибки.

Пример. Пример использования функции ftp_ssl_connect()

<?php

// установка соединения
$conn_id = ftp_ssl_connect($ftp_server);

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

echo ftp_pwd($conn_id); // /

// закрытие соединения
ftp_close($conn_id);
?>