Функции для работы с файловой системой
Введение
Требования
Никакие внешние библиотеки не требуются для сборки этого расширения, но если вы хотите, чтобы PHP поддерживал LFS (large files, большие файлы) в Linux, вам нужно иметь последнюю версию glibc и скомпилировать PHP со следующими флагами компилятора: -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64.
Установка
Для использования этих функций не требуется проведение установки, поскольку они являются частью ядра PHP.
Настройка во время выполнения
Поведение этих функций зависит от установок в php.ini.
Имя | Значение по умолчанию | Область изменения |
---|---|---|
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, могут регистрировать собственные упаковщики.
Note: Эта настройка может быть установлена только в php.ini из соображений безопасности.
Note: Эта директива была представлена сразу же после выхода PHP версии 4.0.3. В этой и в последующих версиях эта функциональность может быть отключена только во время компиляции PHP с помощью ключа --disable-url-fopen-wrapper .
WarningВ версиях PHP, более ранних, чем 4.3.0, для платформ Windows, поддержка работы с удаленными файлами отсутствует для следующих функций: include(), include_once(), require(), require_once() и функции imagecreatefromXXX расширения Image.
- user_agent string
-
Устанавливает строку "User-Agent" для использования ее PHP при запросах к удаленным серверам.
- default_socket_timeout integer
-
Значение таймаута (в секундах) для потоков, использующих сокеты.
Note: Данная директива стала доступна с версии PHP 4.3.0
- from="[email protected]" string
-
Устанавливает пароль для анонимного доступа к серверу ftp (ваш адрес электронной почты).
- auto_detect_line_endings boolean
-
Когда данная директива включена, PHP проверяет данные, получаемые функциями fgets() и file() с тем, чтобы определить способ завершения строк (Unix, MS-Dos или Macintosh).
Данная директива позволяет PHP взаимодействовать с системами Macintosh, однако, по умолчанию эта директива выключена, поскольку при ее использовании возникает (несущественная) потребность в дополнительных ресурсах для определения символа окончания первой строки, а также потому, что программисты, использующие в системах Unix символы перевода строки в качестве разделителей, столкнутся с обратно-несовместимым поведением PHP.
Note: Эта директива стала доступна с версии 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 и пояснениями обращайтесь к главе List of Supported Protocols/Wrappers.
Table of Contents
- 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_uplo