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

Требования

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

Установка

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

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

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

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

ИмяЗначение по умолчаниюОбласть изменения
allow_url_fopen"1"PHP_INI_SYSTEM
user_agentNULLPHP_INI_ALL
default_socket_timeout"60"PHP_INI_ALL
fromNULL??
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 расширения Ссылка LVII, Image Functions.

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)

FILE_USE_INCLUDE_PATH (integer)

FILE_APPEND (integer)

FILE_IGNORE_NEW_LINES (integer)

FILE_SKIP_EMPTY_LINES (integer)

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

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

За списком упаковщиков URL и пояснениями обращайтесь к главе Прил. M.

Содержание
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()
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 -- Удаляет файл