Учебник по 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 будет возвращать имена файлов с начала в списке каталога.