Полезные функции для работы с файловой системой

Эта статья фактически краткий справочник по функциям для работы с файлами. Описываемые функции редко кто использует, но это не значит, что они бесполезны. Напротив, они очень даже полезны... Но они описываются далеко не в каждом учебнике по PHP.

file_exists

Функция file_exists() проверяет, существует ли файл в локальной файловой системе. Если файл существует, то функция возвращает истину, а если нет, то ложь. Пример:

if (! file_exists("somefile.php") ) { echo "Файл не существует!; }

is_file

Эта функия по сути делает ту же работу, что и file_exists, но она более надежна, т.к. проверяет не только существование заданного файла, но и файл ли это (вдруг дирректория?), и можно ли производить с ним операции записи/чтения. Пример:

if (! is_file("somefile.php") ) {echo "Это неправильный файл, либо в него нельзя писать/читать"; }

else {echo "Все ok, это нормальный файл";}

filesize

Как можно догадаться из названия, эта функция нужна для определения размера файла (в локальной файловой системе). Она возвращает размер файла в байтах или возвращает FALSE, если возникла ошибка. Пример:

$fsize = filesize("somefile.txt");

echo "Размер файла $fsize";

is_writeable

Эта функция проверяет, существует ли заданный файл и можно ли в него писать. Пример:

if (is_writeable("somefile.txt") ) {echo "В этот файл можно писать";}

else {echo "Файла не существует, либо в него нельзя писать";}

is_readable

Эта функция позволяет убедиться, что файл доступен для чтения (если он существует).

if (is_readable("somefile.txt") ) {echo "Этот файл доступен для чтения";}

else {echo "Файла не существует, либо его нельзя прочитать с текущими правами";}

readfile

В большинстве скриптов, которые я видел, чтение из файла осуществлялось с помощью функции fgets либо fread. При этом нужно было перед этим открыть а после закрыть. Но есть функция readfile, которая позволяет сэкономить пару инструкций. Она читает содержимое файла и перенаправляет в стандартный поток вывода (обычно браузер). Пример:

readfile("somefile.txt");

Все содержимое файла будет выведено в файле.

basename

Функция выделяет имя файла из переданного ей полного пути. Пример:

$filename = basename("/usr/brutus/file.txt");

echo $filename; //будет выведено "file.txt"

getlastmod

Функция возвращает дату последней модификации файла, из которого эта функция вызывается. Пример:

echo "Последнее обновление: ".date("d.m.Y @ H:i:s", getlastmod() );

Работа с каталогами

is_dir

Функция проверяет, является ли заданный файл каталогом. Синтаксис:

bool is_dir (string filename);

Возвращает TRUE если это каталог и FALSE если это файл

dirname

Эта функция извлекает путь до полного имени файла, подобно функции basename. Синтаксис:

string dirname ($string path);

opendir

Функция открывает заданный каталог и возвращает его идентификатор для работы с ним подобно функции fopen. Синтаксис:

int opendir (string path);

closedir

Функция закрывает манипулятор каталога подобно функции fclose. Синтаксис:

void closedir (int resource_handle);

readdir

Функция возвращает очередной элемент каталога. Синтаксис:

string readdir (int resource_handle);

Пример:

$dp = opendir('somedir');

while ($file = readdir($dp) ) {

echo $file."

";

}

closedir($dp);

rewinddir

Функция переводит указатель текущей позиции в начало каталога. К примеру функция readdir будет читать каталог с начала. Синтаксис:

void rewinddir (int resource_handle);

chdir

Функция осуществляет переход в заданный каталог. Синтаксис:

int chdir(string path);

mkdir

Функция аналогична однименной команде Unix - она создает каталог с заданным именем. Синтаксис:

int mkdir (string path, int mode);

Mode определяет разрешения, которые будут присвоены каталогу после создания.

Функции для работы с правами файла

Функции, которые будут описаны ниже, работают только в UNIX like системах.

filegroup

Эта функция возвращает идентификатор группы-владельца заданного файла. Синтаксис:

int filegroup (string filename);

fileperms

Функция возвращает разрешения (permissions) файла или FALSE в случае ошибки. Синтаксис:

int fileperm (string filename);

fileowner

Функция возвращает идентификатор владельца заданного файла. Синтаксис:

int fileowner (string filename);

chgrp

Функция пытается сменить группу-владельца данного файла. Синтаксис

int chgrp (string filename, mixed group);

chmod

Функция пытается изменить разрешения файла. Синтаксис:

int chmod (string filename, int permissions);

Замечание: параметр permissions должен состоять из четырех целых чисел, напрмер 0776.

chown

Функция chown пытается сменить владельца файла. Синтаксис:

int chown (string filename, mixed user);

stat

Эта функция возвращает массив с подробной информацией о файле. Синтаксис:

array stat (string filename);

Элементы, возвращаемые функцией:

0 - Устройство

1 - Индексный узел (inode)

2 - Режим защиты индексного угла

3 - Количество ссылок

4 - Идентификатор владельца

5 - Идентификатор группы владельца

6 - Тип устройства индексного узла

7 - Размер в байтах

8 - Время последнего обращения к файлу

9 - Время последней модификации файла

10 - Время последнего изменения

11 - Размер блока при выводе/вводе в файловой системе

12 - Количество выделенных блоков