Функции для работы с каталогами : Работа с записями

dir

Класс каталога (псевдо-объектно ориентированный механизм).

Синтаксис :

new dir(string directory);

Псевдо-объектно ориентированный механизм для получения списка файлов каталога. Открывает каталог из directory.

После этого становятся доступны два свойства объекта: дескриптор каталога handle и строка path, указывающая, какой каталог в настоящий момент используется. Эти свойства доступны, если только каталог был открыт. Свойство handle может быть использован вместе с другими функциями работы с каталогом типа readdir(), rewinddir() и closedir().

Для класса доступны три метода: чтение, возврат к началу и закрытие (read, rewind и close соответственно).

Пример :

$d = dir("/etc");

echo "Handle: ".$d->handle."<br>\n"; echo "Path: ".$d->path."<br>\n";

closedir

Закрыть дескриптор(handle) каталога.

Синтаксис :

void closedir(int dir_handle);

Закрывает поток каталога, обозначенный как dir_handle. Поток предварительно должен быть открыт финкцией opendir().

opendir

Открыть дескриптор каталога.

Синтаксис :

int opendir(string path);

Возвращает дескриптор открытого каталога path, который в последующем используется в функциях closedir(), readdir(), и rewinddir().

readdir

Получение имени следующего файла в списке каталога.

Синтаксис :

string readdir(int dir_handle);

Возвращает имя следующего файла из каталога. Имена файлов возвращаются в виде неупорядоченной последовательности.

Пример:

<?php $handle=opendir(".");

echo "Directory handle: $handle\n"; echo "Files:\n";

while ($file = readdir($handle)) { echo "$file\n";

}

closedir($handle); ?>

Следует отметить, что функция также возвращает значения "." и "..". Если эти значения не требуются, то их можно исключить следующим образом:

<?php $handle=opendir(".");

while($file=readdir($handle)) { if($file != "." && $file != "..") {

echo "Имя файла: $file<br>"; };

}; closedir($handle); ?>

rewinddir

Реинициализация дескриптора каталога.

Синтаксис :

void rewinddir(int dir_handle);

После вызова этой функции функция readdir() с аргументом dir_handle будет возвращать имена файлов с начала в списке каталога.

FTP : Работа с 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 : Работа файлами

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

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

Синтаксис :

int ftp_rename(int ftp_stream, string from, string to)

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

ftp_delete

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

Синтаксис :

int ftp_delete(int ftp_stream, string path)

Функция ftp_delete() удаляет файл, имя которого задано в параметре path. Функция возвращает true или false в случае ошибки.