Справочник по PHP - [42]

Синтаксис:

int ftp_systype(int ftp_stream)

Функция возвращает строковое значение или false в случае ошибки.

Работа с FTP-сервером

ftp_connect

Производит подключение к FTP-серверу.

Синтаксис:

int ftp_connect(string host [, int port])

В функции ftp_connect() аргумент host указывает имя сервера, к которому производится подключение, а необязательный аргумент port указывает какой порт нужно использовать (по умолчанию это 21).

Функция возвращает дескриптор потока FTP или false в случае ошибки.

ftp_pasv

Производит переключение пассивного режима.

Синтаксис:

int ftp_pasv(int ftp_stream, int pasv)

Функция ftp_pasv() производит переключение режима подключения в пассивный, в случае, если аргумент pasv равен true. Если false - то режим подключения будет активный.

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

Функция возвращает true или false при ошибке.

ftp_login

Производит вход на сервер FTP.

Синтаксис:

int ftp_login(int ftp_stream, string username, string password)

Функция ftp_login() производит регистрацию в системе под именем username с паролем password. Возвращает true или false при ошибке.

ftp_quit

Производит завершение сеанса FTP.

Синтаксис:

int ftp_quit(int ftp_stream)

ftp_pwd

Производит определение текущего каталога.

Синтаксис:

int ftp_pwd(int ftp_stream)

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

ftp_cdup

Производит переход в корневой каталог.

Синтаксис:

int ftp_cdup(int ftp_stream)

Функция возвращает true или false при ошибке.

ftp_chdir

Производит переход в каталог.

Синтаксис:

int ftp_chdir(int ftp_stream, string directory)

Функция возвращает true или false при ошибке.

ftp_mkdir

Производит создание каталога.

Синтаксис:

int ftp_mkdir(int ftp_stream, string directory)

Функция возвращает имя созданного каталога или false при ошибке.

ftp_rmdir

Производит удаление каталога.

Синтаксис:

int ftp_rmdir(int ftp_stream, string directory)

Функция true или false при ошибке.

ftp_nlist

Производит получение листинга каталога.

Синтаксис:

int ftp_nlist(int ftp_stream, string directory)

Функция ftp_nlist() возвращает массив файловых имен или false при ошибке.

ftp_rawlist

Получение подробного листинга каталога.

Синтаксис:

int ftp_rawlist(int ftp_stream, string directory)

Функция ftp_rawlist() выполняет FTP-команду LIST, и возвращате его результаты в массиве, где каждый элемент соответствует строке текста "как есть". Идентификатор типа системы, возвращаемый ftp_systype(), может быть использован для определения того, как следует интерпретировать результаты.

ftp_systype

Возвращает системный идентификатор типа FTP-сервера.

Синтаксис:

int ftp_systype(int ftp_stream)

Функция возвращает строковое значение или false в случае ошибки.

Работа с файлами

ftp_get

Производит загрузку с FTP-сервера.

Синтаксис:

int ftp_get(int ftp_stream, string local_file, string remote_file, int mode)

Функция ftp_get() загружает файл под названием remote_file с FTP-сервера и локально сохраняет его под именем local_file.

Параметр mode устанавливает режим передачи файла и может принимать значения FTP_ASCII(текстовой) или FTP_BINARY(бинарный, двоичный).

Функция возвращает true или false при ошибке.

ftp_fget

Производит загрузку и запись файла.

Синтаксис:

int ftp_fget(int ftp_stream, string fp, string remote_file, int mode)

Функция ftp_fget() загружает файл под названием remote_file с FTP-сервера и сохраняет его в файле, который имеет дескриптор fp. Параметр mode устанавливает режим передачи файла и может принимать значения FTP_ASCII(текстовой) или FTP_BINARY(бинарный, двоичный).

Функция возвращает true или false при ошибке.

ftp_put

Производит загрузку файла на FTP-сервер.

Синтаксис:

int ftp_put(int ftp_stream, string remote_file, string local_file, int mode)

Функция ftp_put() загружает файл на FTP-сервер под именем remote_file. Параметр mode устанавливает режим передачи файла и может принимать значения FTP_ASCII(текстовой) или FTP_BINARY(бинарный, двоичный).

Функция возвращает true или false при ошибке.

$upload = ftp_put($ftp_id, "C:\file.txt", "/file.txt", FTP_ASCII);

ftp_fput

Производит чтение и загрузку файла на FTP-сервер.

Синтаксис:

int ftp_fput(int ftp_stream, string remote_file, string fp, int mode)

Функция ftp_fput() читает открытый файл с дескриптором fp до конца и загружает этот файл на FTP-сервер под именем remote_file. Параметр mode устанавливает режим передачи файла и может принимать значения FTP_ASCII(текстовой) или FTP_BINARY(бинарный, двоичный).

Функция возвращает true или false при ошибке.

ftp_size

Определяет размер файла.

Синтаксис:

int ftp_size(int ftp_stream, string remote_file)

Функция ftp_size() возвращает размер файла, заданного в параметре remote_file, в байтах или -1 при ошибке.

Не все серверы поддерживают эту возможность.

ftp_mdtm

Возвращает время последней модификации файла.

Синтаксис:

int ftp_mdtm(int ftp_stream, string remote_file)

Функция ftp_mdtm() возвращает время, последней модификации, представленное в формате Unix, или -1 при ошибке.

Данная функция не работает с каталогами.

ftp_rename

Производит переименование файла.