Справочник по PHP : Файлы и сети : Функции для работы с каталогами : Работа с записями
смотрим также
Материал из Справочник Web-языков
Содержание |
dir
Класс каталога (псевдо-объектно ориентированный механизм).
Синтаксис:
new dir(string directory);
Псевдо-объектно ориентированный механизм для получения списка файлов каталога. Открывает каталог из directory.
После этого становятся доступны два свойства объекта: дескриптор каталога handle и строка path, указывающая, какой каталог в настоящий момент используется. Эти свойства доступны, если только каталог был открыт. Свойство handle может быть использован вместе с другими функциями работы с каталогом типа readdir(), rewinddir() и closedir(). Для класса доступны три метода: чтение, возврат к началу и закрытие (read, rewind и close соответственно).
Пример:
$d = dir("/etc"); echo "Handle: ".$d->handle."
\n"; echo "Path: ".$d->path."
\n"; while($entry=$d->read()) { // Последовательно выводить echo $entry."
\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
"; }; }; closedir($handle); ?>
rewinddir
Реинициализация дескриптора каталога.
Синтаксис:
void rewinddir(int dir_handle);
После вызова этой функции функция readdir() с аргументом dir_handle будет возвращать имена файлов с начала в списке каталога.