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

Введение

Требования

Никакие внешние библиотеки не требуются для сборки этого расширения, но если вы хотите, чтобы PHP поддерживал LFS (large files, большие файлы) в Linux, вам нужно иметь последнюю версию glibc и скомпилировать PHP со следующими флагами компилятора: -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64.

Установка

Для использования этих функций не требуется проведение установки, поскольку они являются частью ядра PHP.

Настройка во время выполнения

Поведение этих функций зависит от установок в php.ini.

Таблица 87. Директивы конфигурации для файловых систем и потоков

Имя	Значение по умолчанию	Область изменения
allow_url_fopen	"1"	PHP_INI_SYSTEM
user_agent	NULL	PHP_INI_ALL
default_socket_timeout	"60"	PHP_INI_ALL
from	NULL	??
auto_detect_line_endings	"Off"	PHP_INI_ALL

Краткое разъяснение конфигурационных директив.

allow_url_fopen boolean

Данная директива включает поддержку упаковщиков URL (URL wrappers), которые позволяют работать с объектами URL, как с обычными файлами. Упаковщики, доступные по умолчанию, служат для работы с удаленными файлами с использованием протокола ftp или http. Некоторые расширения, например, zlib, могут регистрировать собственные упаковщики.

Замечание: Эта настройка может быть установлена только в php.ini из соображений безопасности.

Замечание: Эта директива была представлена сразу же после выхода PHP версии 4.0.3. В этой и в последующих версиях эта функциональность может быть отключена только во время компиляции PHP с помощью ключа --disable-url-fopen-wrapper.

Внимание

В версиях PHP, более ранних, чем 4.3.0, для платформ Windows, поддержка работы с удаленными файлами отсутствует для следующих функций: include(), include_once(), require(), require_once() и функции imagecreatefromXXX расширения Image.

user_agent string

Устанавливает строку "User-Agent" для использования ее PHP при запросах к удаленным серверам.

default_socket_timeout integer

Значение таймаута (в секундах) для потоков, использующих сокеты.

Замечание: Данная директива стала доступна с версии PHP 4.3.0

from="joe@example.com" string

Устанавливает пароль для анонимного доступа к серверу ftp (ваш адрес электронной почты).

auto_detect_line_endings boolean

Когда данная директива включена, PHP проверяет данные, получаемые функциями fgets() и file() с тем, чтобы определить способ завершения строк (Unix, MS-Dos или Macintosh).

Данная директива позволяет PHP взаимодействовать с системами Macintosh, однако, по умолчанию эта директива выключена, поскольку при ее использовании возникает (несущественная) потребность в дополнительных ресурсах для определения символа окончания первой строки, а также потому, что программисты, использующие в системах Unix символы перевода строки в качестве разделителей, столкнутся с обратно-несовместимым поведением PHP.

Замечание: Эта директива стала доступна с версии PHP 4.3.0

Типы ресурсов

Предопределенные константы

Перечисленные ниже константы определены данным расширением и могут быть доступны только в том случае, если PHP был собран с поддержкой этого расширения или же в том случае, если данное расширение подгружается во время выполнения.

GLOB_BRACE (integer)
GLOB_ONLYDIR (integer)
GLOB_MARK (integer)
GLOB_NOSORT (integer)
GLOB_NOCHECK (integer)
GLOB_NOESCAPE (integer)
PATHINFO_DIRNAME (integer)
PATHINFO_BASENAME (integer)
PATHINFO_EXTENSION (integer)
PATHINFO_FILENAME (integer): Появилась в PHP 5.2.0.
FILE_USE_INCLUDE_PATH (integer)
FILE_APPEND (integer)
FILE_IGNORE_NEW_LINES (integer)
FILE_SKIP_EMPTY_LINES (integer)

Смотрите также

Описания родственных функций вы сможете найти в главах Каталог и Выполнение программ.

За списком упаковщиков URL и пояснениями обращайтесь к главе Приложение O, List of Supported Protocols/Wrappers.

Содержание

basename — Возвращает имя файла из указанного пути
chgrp — Изменяет группу владельцев файла
chmod — Изменяет режим доступа к файлу или каталогу
chown — Изменяет владельца файла
clearstatcache — Очищает кэш состояния файлов
copy — Копирует файл
delete — См.описание функции unlink() или unset()
dirname — Возвращает имя каталога из указанного пути
disk_free_space — Получить размер доступного пространства в каталоге
disk_total_space — Возвращает объем каталога
diskfreespace — Псевдоним функции disk_free_space()
fclose — Закрывает дескриптор файла
feof — Проверяет, достигнут ли конец файла
fflush — Сброс буфера вывода в файл
fgetc — Считывает символ из файла
fgetcsv — Читает строку из файла и производит разбор данных CSV
fgets — Читает строку из файла
fgetss — Прочитать строку из файла и отбросить HTML-теги
file_exists — Проверить наличие указанного файла или каталога
file_get_contents — Получить содержимое файла в виде одной строки
file_put_contents — Записать строку в файл
file — Читает содержимое файла и помещает его в массив
fileatime — Получить время последнего доступа к файлу
filectime — Получить время последнего изменения i-узла
filegroup — Получить идентификатор группы файла
fileinode — Получить номер inode файла
filemtime — Получить время последнего изменения файла
fileowner — Получить идентификатор владельца файла
fileperms — Получить информацию о правах на файл
filesize — Получить размер файла
filetype — Получить тип файла
flock — Портируемое рекомендательное запирание файлов
fnmatch — Совпадает ли имя файла с шаблоном
fopen — Открывает файл или URL
fpassthru — Выводит все оставшиеся данные из файлового указателя
fputcsv — Форматирует строку в виде CSV и записывает её в файловый указатель
fputs — Псевдоним функции fwrite()
fread — Бинарно-безопасное чтение файла
fscanf — Обрабатывает данные из файла в соответствии с форматом
fseek — Устанавливает смещение в файловом указателе
fstat — Получает информацию о файле используя открытый файловый указатель
ftell — Сообщает текущее смещение чтения/записи файла
ftruncate — Урезает файл до указанной длинны
fwrite — Бинарно-безопасная запись в файл
glob — Находит файловые пути, совпадающие с шаблоном
is_dir — Определает, является ли файл директорией
is_executable — Определяет, является ли файл исполняемым
is_file — Определяет, является ли файл обычным файлом
is_link — Определяет, является ли файл символической ссылкой
is_readable — Определяет, доступен ли файл для чтения
is_uploaded_file — Определяет, был ли файл загружен при помощи HTTP POST
is_writable — Определяет, доступен ли файл для записи
is_writeable — Псевдоним функции is_writable()
lchgrp — Changes group ownership of symlink
lchown — Changes user ownership of symlink
link — Создаёт жёсткую ссылку
linkinfo — Получает информацию о ссылке
lstat — Получает информацию о файле или символической ссылке
mkdir — Создаёт директорию
move_uploaded_file — Перемещает загруженный файл в новое место
parse_ini_file — Обрабатывает конфигурационный файл
pathinfo — Возвращает информацию о пути к файлу
pclose — Закрывает файловый указатель процесса
popen — Открывает файловый указатель процесса
readfile — Выводит файл
readlink — Возвращает файл, на который указывает символическая ссылка
realpath — Возвращает канонизированный абсолютный путь к файлу
rename — Переименовывает файл или директорию
rewind — Сбрасывает курсор у файлового указателя
rmdir — Удаляет директорию
set_file_buffer — Псевдоним функции stream_set_write_buffer()
stat — Получает информацию о файле
symlink — Создаёт символическую ссылку
tempnam — Создаёт файл с уникальным именем
tmpfile — Создаёт временный файл
touch — Устанавливает время доступа и модификации файла
umask — Изменяет текущую umask
unlink — Удаляет файл