fopen

Список параметров

filename

При передаче в параметр filename аргумента в форме "scheme://..." функция распознает значение как URL-адрес, и PHP выполнит поиск обработчика протокола — «обёртки» — для этой схемы. Если для этого протокола не зарегистрировали ни одной обёртки, PHP выдаст замечание, чтобы помочь отследить потенциальную проблему в скрипте, а затем продолжит выполнение так, как если бы параметр filename указывал на обыкновенный файл.

PHP попытается открыть поток для файла, если оценит путь filename как указатель на локальный файл. PHP считает файл, только если права доступа к файлу разрешают такой доступ. PHP применит дополнительные ограничения, если включили директиву open_basedir.

PHP проверит, включили ли директиву allow_url_fopen, если оценит параметр filename как указатель на зарегистрированный протокол и этот протокол зарегистрировали как сетевой URL-адрес. PHP выдаст предупреждение и вызов функции fopen() завершится ошибкой, если директиву выключили.

Замечание:

Список поддерживаемых протоколов перечисляет раздел «Протоколы и обёртки». Отдельные протоколы, или обёртки, поддерживают опции контекста и (или) файла php.ini. Обратитесь к странице с описанием протокола, чтобы получить список опций, которые можно установить (например, значение директивы user_agent в файле php.ini использует обёртка http).

На платформе Windows требуется экранировать обратные слеши в пути к файлу или указывать прямые слеши.

<?php

$handle = fopen("c:\\folder\\resource.txt", "r");

?>

mode

Параметр mode указывает тип доступа к потоку. Доступны следующие режимы:

Список возможных режимов для параметра mode функции fopen()

mode	Описание
'r'	Открывает файл только для чтения; помещает указатель в начало файла.
'r+'	Открывает файл для чтения и записи; помещает указатель в начало файла.
'w'	Открывает файл только для записи; помещает указатель в начало файла и обрезает файл до нулевой длины. Функция пытается создать файл, если файл не существует.
'w+'	Открывает файл для чтения и записи; в остальном ведёт себя аналогично флагу 'w'.
'a'	Открывает файл только для записи; помещает указатель в конец файла. Функция пытается создать файл, если файл не существует. В этом режиме функция fseek() не влияет на положение указателя, записи каждый раз добавляются в конец.
'a+'	Открывает файл для чтения и записи; помещает указатель в конец файла. Функция пытается создать файл, если файл не существует. В этом режиме функция fseek() влияет только на позицию считывания, записи каждый раз добавляются в конец.
'x'	Создаёт и открывает файл только для записи; помещает указатель в начало файла. Вызов функции fopen() закончится неудачей, вернёт false и выдаст ошибку уровня E_WARNING, если файл уже существует. Функция пытается создать файл, если файл не существует. Это эквивалентно указанию флагов O_EXCL|O_CREAT для внутреннего системного вызова open(2).
'x+'	Создаёт и открывает файл для чтения и записи; в остальном ведёт себя аналогично флагу 'x'.
'c'	Открывает файл только для записи. Функция создаст файл, если файл не существует. Файл не обрезается — в отличие от режима 'w', — а вызов этой функции не вызывает ошибку, как и в режиме 'x', если файл существует. Функция передвинет указатель в начало файла. Это полезно, если требуется получить рекомендательную блокировку (см. описание функции flock()) перед попыткой изменения файла, поскольку режим 'w' иногда обрезает файл ещё до получения блокировки. Для обрезки файла вызывают функцию ftruncate() после запроса на блокировку, если требуется.
'c+'	Открывает файл для чтения и записи; в остальном ведёт себя аналогично флагу 'c'.
'e'	Устанавливает флаг close-on-exec (закрытия при исполнении) для открытого дескриптора файла. Флаг доступен только в PHP, который скомпилировали на системах с поддержкой стандарта POSIX.1-2008.
'n'	Устанавливает неблокирующий флаг для открытого файлового дескриптора. Флаг доступен только в PHP, который скомпилировали на системах с поддержкой стандарта POSIX.1-2008.

Замечание:

В разных семействах операционных систем действуют разные соглашения о завершении строк. Когда при записи текстового файла требуется вставить разрыв строки, необходимо использовать правильный для операционной системы символ (или символы). Системы на базе Unix в качестве символа конца строки используют символ \n, системы семейства Windows в качестве символов окончания строки используют последовательность символов \r\n, а системы семейства Macintosh (Mac OS Classic) — символ \r.

Файлы, в которые записали неправильные символы конца строк, «выглядят странно», когда такие файлы открывают в других приложениях.

ОС Windows предлагает флаг перевода в текстовый режим ('t'), который во время работы с файлом автоматически переведёт символ \n в символы \r\n. И наоборот — можно также использовать флаг 'b', чтобы принудительно включить двоичный режим, который не будет переводить данные. Чтобы использовать эти флаги, значение 'b' или 't' указывают последним символом параметра mode.

Режим перевода по умолчанию — флаг 'b'. При работе с простыми текстовыми файлами можно указать режим 't', а для обозначения концов строк в скрипте использовать режим \n, но помнить, что файлы будут использоваться в приложениях наподобие старых версий «Блокнота». В остальных случаях лучше указывать флаг 'b'.

Иногда при работе с двоичными файлами, для которых указали флаг 't', возникают странные проблемы с данными, включая повреждённые файлы изображений и проблемы с символами \r\n.

Замечание:

В целях переносимости также настоятельно рекомендуется переписать код, который использует или полагается на режим 't', чтобы вместо этого режима использовались правильные окончания строк и режим 'b'.

Замечание: Функция игнорирует параметр mode при работе с обёртками потоков php://output, php://input, php://stdin, php://stdout, php://stderr и php://fd.

use_include_path

Для необязательного третьего параметра use_include_path разрешается устанавливать значение true, если также требуется искать файл в списке путей директивы include_path.

context

Ресурс (resource) контекста потока.