Справочник по PHP : Файлы и сети : Функции для работы с каталогами : Работа с записями

Материал из Справочник Web-языков.

								Манипулирование каталогами
Главная	::.	PHP	::.	Файлы и сети	::.	Функции для работы с каталогами	::.	Работа с записями
								FTP : Работа с FTP-сервером

Содержание 1 dir 2 closedir 3 opendir 4 readdir 5 rewinddir

[править] 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: $handlen";
  echo "Files:n";
  while ($file = readdir($handle)) {
    echo "$filen";
  }
  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 будет возвращать имена файлов с начала в списке каталога.