Эта статья фактически краткий справочник по функциям для работы с файлами. Описываемые функции редко кто использует, но это не значит, что они бесполезны. Напротив, они очень даже полезны… Но они описываются далеко не в каждом учебнике по 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 – Количество выделенных блоков