Манипулирование каталогами

mkdir
Создание каталога.

Синтаксис:
bool mkdir(string $name, int $perms)

Создает каталог с именем $name и правами доступа perms. Права доступа для каталогов указываются точно так же, как и для файлов. Чаще всего значение $perms устанавливают равным 0770 (предваряющий ноль обязателен - он указывает PHP на то, что это - восьмеричная константа, а не десятичное число).

Пример:

mkdir("my_directory",0755); // создает подкаталог в текущем каталогеmkdir("/data"); // создает подкаталог data в корневом каталоге

В случае успеха функция возвращает true, иначе - false.

rmdir
Удаление каталога.

Синтаксис:
bool rmdir(string $name)

Удаляет каталог с именем $name.
Каталог должен быть пустым, а его атрибуты должны позволять это.
В случае успеха функция возвращает true, иначе - false.

chdir
Смена текущего каталога.

Синтаксис:
int chdir(string $directory);

Изменяет текущий PHP каталог на directory. Возвращает FALSE если не может изменить, TRUE если смена произошла. Параметр $directory может определять и относительный путь, задающийся от текущего каталога.

Примеры:

chdir("/tmp/data"); // переходим по абсолютному путиchdir("./js"); // переходим в подкаталог текущего каталогаchdir(".."); // переходим в родительский каталогchdir("~/data"); // переходим в /home/пользователь/data (для Unix)

getcwd
Полный путь.

Синтаксис:
string getcwd()

Данная функция возвращает текущую директорию, относительно которой проводятся файловые операции, т.е. возвращает полный путь к текущему каталогу, начиная от "корня" (/). Если такой путь не можнет быть отслежен, вызов "проваливается" и возвращается false.

diskfreespace
Определяет свободное пространство в каталоге

Синтаксис:
float diskfreespace (string directory);

Данная функция возвращает в байтах свободное пространство в каталоге directory, то есть в соответствующей ей файловой системе или на разделе диска.

Пример:

$diskspace=diskfreespace("/");// Тем самым мы определили свободное место в корневой директории "/"

 

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

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

Синтаксис:
new dir(string directory);

Псевдо-объектно ориентированный механизм для получения списка файлов каталога. Открывает каталог из directory.
После этого становятся доступны два свойства объекта: дескриптор каталога handle и строка path, указывающая, какой каталог в настоящий момент используется. Эти свойства доступны, если только каталог был открыт. Свойство handle может быть использован вместе с другими функциями работы с каталогом типа readdir(), rewinddir() и losedir().
Для класса доступны три метода: чтение, возврат к началу и закрытие (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 будет возвращать имена файлов с начала в списке каталога.