Руководство по PHP
Пред. |  | След.

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

# Введение

# Требования

Никакие внешние библиотеки не требуются для сборки этого расширения, но если вы хотите, чтобы 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_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 расширения Ссылка LXIII, 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)

`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 и пояснениями обращайтесь к главе Прил. M.

Пред. | Начало | След.
filepro | Уровень выше | basename