Справочник по PHP

Работа с записями


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";while($entry=$d->read()) { // Последовательно выводить  echo $entry."<br>\n";    // имя каждого файла,}                          // имеющегося в каталоге$d->close();

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

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



Содержание раздела