fopen
(PHP 4, PHP 5, PHP 7)
fopen — Открывает файл или URL
Описание
resource fopen
( string $filename
, string $mode
[, bool $use_include_path = false
[, resource $context
]] )
Список параметров
-
filename -
Если
filenameпередан в форме «scheme://…»,
он считается URL’ом и PHP проведёт поиск обработчика протокола
(также известного как «обертка») для этой схемы. Если ни одна
обёртка не закреплена за протоколом, PHP выдаст замечание,
чтобы помочь вам отследить потенциальную проблему в вашем
скрипте и затем продолжит выполнение, как если быfilename
указывал на обыкновенный файл.Если PHP установлено, что
filenameуказывает на
локальный файл, тогда выполняется попытка открыть поток к этому файлу.
Файл должен быть доступен PHP, так что вам следует убедиться,
что права доступа на файл это разрешают.
Если вы включили безопасный режим
или open_basedir, то накладываются
дальнейшие ограничения.Если PHP установлено, что
filenameуказывает на
зарегистрированный протокол и этот протокол зарегистрирован как
сетевой URL, PHP выполняет проверку состояния директивы
allow_url_fopen.
Если она выключена, PHP выдаст предупреждение и вызов fopen закончится
неудачей.Замечание:
Список поддерживаемых протоколов доступен в разделе Поддерживаемые протоколы и обработчики (wrappers).
Некоторые протоколы (обертки) поддерживают
контекст и/или опции php.ini.
Обратитесь к соответствующей странице с описанием используемого протокола
для получения списка опций, которые могут быть установлены.
(например, значение php.ini user_agent используется
оберткой http).На платформе Windows, необходимо экранировать все
обратные слеши в пути к файлу или использовать прямые слеши.
<?php
$handle = fopen("c:\folder\resource.txt", "r");
?>
-
mode -
Параметр
modeуказывает тип доступа, который вы
запрашиваете у потока. Он может быть одним из следующих вариантов:
Список возможных режимов для fopen()
используяmode
modeОписание ‘r’ Открывает файл только для чтения; помещает указатель
в начало файла.‘r+’ Открывает файл для чтения и записи; помещает указатель
в начало файла.‘w’ Открывает файл только для записи; помещает указатель
в начало файла и обрезает файл до нулевой длины.
Если файл не существует — пробует его создать.‘w+’ Открывает файл для чтения и записи; помещает указатель
в начало файла и обрезает файл до нулевой длины.
Если файл не существует — пытается его создать.‘a’ Открывает файл только для записи; помещает указатель в конец
файла. Если файл не существует — пытается его создать.‘a+’ Открывает файл для чтения и записи; помещает указатель в конец
файла. Если файл не существует — пытается его создать.‘x’ Создаёт и открывает только для записи; помещает указатель в
начало файла. Если файл уже существует, вызов
fopen() закончится неудачей, вернётFALSEи
выдаст ошибку уровняE_WARNING.
Если файл не существует, попытается его создать. Это эквивалентно
указанию флагов O_EXCL|O_CREAT для внутреннего
системного вызова open(2).‘x+’ Создаёт и открывает для чтения и записи; иначе имеет то же поведение что и‘x’. ‘c’ Открывает файл только для записи. Если файл не существует, то он создается.
Если же файл существует, то он не обрезается (в отличии от
‘w’), и вызов к этой функции не вызывает ошибку (также как
и в случае с ‘x’). Указатель на файл будет установлен
на начало файла. Это может быть полезно при желании заблокировать
файл (смотри flock()) перед изменением, так как использование
‘w’ может обрезать файл еще до того как была получена блокировка
(если вы желаете обрезать файл, можно использовать функцию
ftruncate() после запроса на блокировку).‘c+’ Открывает файл для чтения и записи; иначе имеет то же поведение, что и ‘c’. Замечание:
Разные семейства операционных систем имеют разные соглашения
относительно окончания строк. Когда вы пишете текст и хотите вставить
разрыв строки, вы должны использовать правильные символы (или символ) для
вашей операционной системы. Системы семейства Unix используют
n в качестве символа конца строки, системы
семейства Windows используют rn в качестве
символов окончания строки и системы семейства Macintosh используют
r в качестве символа конца строки.Если вы используете неверный символ конца строки при редактировании
файлов, вы можете обнаружить, что при открытии эти файлы «странно
выглядят».Windows предлагает флаг режима текстовой трансляции
(‘t’), который автоматически переведёт
n в rn во время работы с файлом.
И наоборот — вы также можете использовать ‘b’, чтобы
принудительно включить бинарный режим, в котором ваши данные
не будут преобразовываться. Чтобы использовать эти режимы, укажите
‘b’ или ‘t’ последней
буквой параметраmode.Так как установка флага трансляции по умолчанию зависит от SAPI и используемой версии
PHP, рекомендуем явно задавать указанный флаг
из соображений портируемости. Вы должны использовать режим
‘t’, если вы работаете с текстовым файлом и
использовать n для обозначения
конца строки в вашем скрипте, при этом не беспокоясь за читаемость
ваших файлов в других приложениях типа «Блокнота». Во всех остальных случаях
используйте флаг ‘b’.Если вы явно не укажете флаг ‘b’ во время работы с бинарными файлами,
вы можете столкнуться со странной порчей ваших данных, включая
испорченные файлы изображений и странные проблемы с символами rn.Замечание:
Из соображений портируемости, настоятельно рекомендуется всегда
использовать флаг ‘b’ при открытии файлов с помощью fopen().Замечание:
Кроме того, из соображений портируемости, также настойчиво
рекомендуется переписать старый код, который полагается на режим
‘t’, чтобы вместо этого он использовал правильные
концы строк и режим ‘b’. -
use_include_path -
Необязательный третий параметр
use_include_path
может быть установлен в ‘1’ илиTRUE, если вы также хотите провести
поиск файла в include_path. -
context -
Замечание: Поддержка контекста была добавлена
в PHP 5.0.0. Для описания контекстов смотрите раздел
Потоки.
Возвращаемые значения
Возвращает указатель на файл в случае успешной работы, или FALSE в случае ошибки.
Ошибки
Если открыть файл не удалось, будет сгенерирована ошибка уровня
E_WARNING. Вы можете использовать оператор
@ для подавления этой ошибки.
Список изменений
| Версия | Описание |
|---|---|
| 5.2.6 | Добавлены опции ‘c’ и ‘c+’ |
| 4.3.2 |
С версии PHP 4.3.2, по умолчанию устанавливается бинарный режим для всех платформ, различающих бинарный и текстовый режимы. Если у вас появились проблемы после обновления, попытайтесь использовать в качестве обхода проблемы флаг ‘t’, пока вы не сделаете ваш скрипт более портируемым, как это было указано выше. |
Примеры
Пример #1 Примеры использования fopen()
<?php
$handle = fopen("/home/rasmus/file.txt", "r");
$handle = fopen("/home/rasmus/file.gif", "wb");
$handle = fopen("http://www.example.com/", "r");
$handle = fopen("ftp://user:password@example.com/somefile.txt", "w");
?>
Примечания
Внимание
При использовании SSL,
Microsoft IIS нарушает протокол, закрывая соединение без отправки
индикатора close_notify. PHP сообщит об этом как «SSL: Fatal Protocol Error»
в тот момент, когда вы достигнете конца данных. Чтобы обойти это, вы должны
установить error_reporting на
уровень, исключающий E_WARNING.
PHP версий 4.3.7 и старше умеет определять, что на стороне сервера находится
проблемный IIS при открытии потока с помощью обертки https:// и не выводит предупреждение.
Если вы используете fsockopen() для создания ssl:// сокета,
вы сами отвечаете за определение и подавление этого предупреждения.
Замечание: Когда опция safe mode включена, PHP проверяет,
имеет ли каталог, с которым вы собираетесь работать, такой же UID (владельца),
как и выполняемый скрипт.
Замечание:
Если вы сталкиваетесь с проблемами во время чтения или записи
файлов, и вы используете PHP в виде серверного модуля, убедитесь
в том, что процесс сервера имеет доступ к используемым вами файлам и директориям.
Замечание:
Эта функция также может выполниться успешно, в случае если
filenameявляется директорией.
Если вы не уверены является лиfilenameфайлом или директорией,
то вам необходимо воспользоваться функцией is_dir(),
до вызова fopen().
Смотрите также
- Поддерживаемые протоколы и обработчики (wrappers)
- fclose() — Закрывает открытый дескриптор файла
- fgets() — Читает строку из файла
- fread() — Бинарно-безопасное чтение файла
- fwrite() — Бинарно-безопасная запись в файл
- fsockopen() — Открывает соединение с интернет сокетом или доменным сокетом Unix
- file() — Читает содержимое файла и помещает его в массив
- file_exists() — Проверяет наличие указанного файла или каталога
- is_readable() — Определяет существование файла и доступен ли он для чтения
- stream_set_timeout() — Устанавливает значение тайм-аута на потоке
- popen() — Открывает файловый указатель процесса
- stream_context_create() — Создаёт контекст потока
- umask() — Изменяет текущую umask
- SplFileObject
Вернуться к: Файловая система
I’m using fopen to read from a file
$fh = fopen($path, 'r') or die('Could not open file');
Now I contantly get error Could not open file. I checked the file path and even changed the permissions of the file to 777. Is there a way I can get a detailed error report as why the file can’t be opened similar to mysql_error()?
![]()
asked Mar 18, 2010 at 13:48
Turn on error reporting, or, in a production environment (from PHP 5.2.0 onwards) you should also be able to use error_get_last().
Seth Carnegie
73.2k22 gold badges178 silver badges249 bronze badges
answered Mar 18, 2010 at 13:54
![]()
PekkaPekka
438k140 gold badges968 silver badges1083 bronze badges
0
For php versions prior to 5.2 (lacking error_get_last()) you can use track_errors.
ini_set('track_errors', 1);
$fh = fopen('lalala', 'r');
if ( !$fh ) {
echo 'fopen failed. reason: ', $php_errormsg;
}
see also: http://de.php.net/reserved.variables.phperrormsg
answered Mar 18, 2010 at 13:54
VolkerKVolkerK
94.8k20 gold badges162 silver badges226 bronze badges
0
Yes.
PHP has detailed error message for you.
You just have to turn it on.
To dislay it on the screen add these 2 lines at the top of the script:
ini_set('display_errors',1);
error_reporting(E_ALL);
Or if you want it to be logged instead,
ini_set('log_errors',1);
ini_set('display_errors',0);
error_reporting(E_ALL);
Also note that using die() is very bad practice.
answered Mar 18, 2010 at 13:51
![]()
Your Common SenseYour Common Sense
157k39 gold badges211 silver badges335 bronze badges
$fh = fopen($path, 'r') or die (error_get_last());
answered May 20, 2016 at 17:44
0
I’m trying to debug a huge, antiquated (circa 2001) PHP web service and I’m encountering file open failures. The fopen call is in an included module, the caller is logging that the file could not be opened but no reason is being logged.
The code that actually does the open is:
// Read the file
if (!($fp = @fopen($fileName, 'rb'))) {
$errStr = "Failed to open '{$fileName}' for read.";
break; // try-block
}
How can I find out why fopen failed?
![]()
zombat
91.7k24 gold badges156 silver badges164 bronze badges
asked Jul 30, 2009 at 16:01
Take away the @ sign.
The @ sign suppresses error messages, so it is supressing the error the the function would normally give.
answered Jul 30, 2009 at 16:02
Tyler CarterTyler Carter
60.1k20 gold badges129 silver badges149 bronze badges
Great answers have already been given, about the @ operator, but here’s a couple of more informations that could be useful, either to you or someone else :
- If, for debugging purposes, you need the disable the
@ operator, you can install the scream extension — see also the manual — which is really useful when you’re maintaining some kind of old application not well designed / coded ^^ - Depending on your PHP configuation (if the
track_errorsoption is activated), you might be able to use$php_errormsgto get the last error message.
Considering this piece of code :
// This file doesn't exist
if (!@fopen('/tmp/non-existant-file.txt', 'r')) {
var_dump($php_errormsg);
}
// My Apache server doesn't have the right to read this file
if (!@fopen('/tmp/vboxdrv-Module.symvers', 'w')) {
var_dump($php_errormsg);
}
You would get this :
string 'fopen(/tmp/non-existant-file.txt) [<a href='function.fopen'>function.fopen</a>]: failed to open stream: No such file or directory' (length=129)
string 'fopen(/tmp/vboxdrv-Module.symvers) [<a href='function.fopen'>function.fopen</a>]: failed to open stream: Permission denied' (length=122)
So, real, useful, meaningful, error messages 😉
answered Jul 30, 2009 at 18:22
Pascal MARTINPascal MARTIN
391k79 gold badges652 silver badges659 bronze badges
answered Jul 30, 2009 at 16:04
Elzo ValugiElzo Valugi
26.7k14 gold badges94 silver badges114 bronze badges
I’m trying to debug a huge, antiquated (circa 2001) PHP web service and I’m encountering file open failures. The fopen call is in an included module, the caller is logging that the file could not be opened but no reason is being logged.
The code that actually does the open is:
// Read the file
if (!($fp = @fopen($fileName, 'rb'))) {
$errStr = "Failed to open '{$fileName}' for read.";
break; // try-block
}
How can I find out why fopen failed?
![]()
zombat
91.7k24 gold badges156 silver badges164 bronze badges
asked Jul 30, 2009 at 16:01
Take away the @ sign.
The @ sign suppresses error messages, so it is supressing the error the the function would normally give.
answered Jul 30, 2009 at 16:02
Tyler CarterTyler Carter
60.1k20 gold badges129 silver badges149 bronze badges
Great answers have already been given, about the @ operator, but here’s a couple of more informations that could be useful, either to you or someone else :
- If, for debugging purposes, you need the disable the
@ operator, you can install the scream extension — see also the manual — which is really useful when you’re maintaining some kind of old application not well designed / coded ^^ - Depending on your PHP configuation (if the
track_errorsoption is activated), you might be able to use$php_errormsgto get the last error message.
Considering this piece of code :
// This file doesn't exist
if (!@fopen('/tmp/non-existant-file.txt', 'r')) {
var_dump($php_errormsg);
}
// My Apache server doesn't have the right to read this file
if (!@fopen('/tmp/vboxdrv-Module.symvers', 'w')) {
var_dump($php_errormsg);
}
You would get this :
string 'fopen(/tmp/non-existant-file.txt) [<a href='function.fopen'>function.fopen</a>]: failed to open stream: No such file or directory' (length=129)
string 'fopen(/tmp/vboxdrv-Module.symvers) [<a href='function.fopen'>function.fopen</a>]: failed to open stream: Permission denied' (length=122)
So, real, useful, meaningful, error messages 😉
answered Jul 30, 2009 at 18:22
Pascal MARTINPascal MARTIN
391k79 gold badges652 silver badges659 bronze badges
answered Jul 30, 2009 at 16:04
Elzo ValugiElzo Valugi
26.7k14 gold badges94 silver badges114 bronze badges
PHP5 Обработка ошибок
Обработка ошибок по умолчанию в PHP очень проста. Сообщение об ошибке с именем файла, строка число и сообщение, описывающее ошибку, отправляется в браузер.
При создании скриптов и веб-приложений, обработка ошибок, является важной
частью. Если коду не хватает кода проверки ошибок, программа может выглядеть
непрофессионально и Вы можете быть открыты для рисков безопасности.
Учебник содержит несколько из наиболее распространенных методов проверки ошибок в PHP.
Вы узнаете различные методы обработки ошибок:
- Простое заявление
это() - Пользовательские ошибки и триггеры ошибок
- Отчеты об ошибках
PHP Основная обработка ошибок
В первом примере показан простой скрипт, открывающий текстовый файл: использование функции это()
Пример
<?php
$file=fopen(«welcome.txt»,»r»);
?>
Если файл не существует, Вы можете получить ошибку, как эта:
Внимание: fopen(welcome.txt) [function.fopen]: не удалось открыть поток:
Нет такого файла или каталога в C:webfoldertest.php на линии 2
Чтобы запретить пользователю получать сообщение об ошибке, подобное приведенному примеру выше, мы проверяем
файл, существует ли он до того, как мы попытаемся получить к нему доступ:
Пример
<?php
if(!file_exists(«welcome.txt»)) {
die(«Файл не найден»);
}
else {
$file=fopen(«welcome.txt»,»r»);
}
?>
Теперь, если файл не существует вы получите ошибку, как эта:
Файл не найден
Приведенный ниже код более эффективен, чем предыдущий код, поскольку он использует простой механизм обработки ошибок для остановки сценария после ошибки.
Тем не менее, остановить просто сценарий не всегда правильный путь. Рассмотрим альтернативные функции PHP для обработки ошибок.
PHP Создание пользовательского обработчика ошибок
Создать пользовательский обработчик ошибок довольно просто. Создаем специальную функцию, которая может быть вызвана при возникновении ошибки в PHP.
Эта функция должна быть способна обрабатывать, как минимум два параметра (уровень ошибки и сообщение об ошибке),
но можно принимать до пяти параметров (дополнительно: файл, номер строки и контекст ошибки):
Синтаксис
error_function(error_level,error_message,
error_file,error_line,error_context)
| Параметр | Описание |
|---|---|
| error_level | Необходимо. Указывает уровень отчета об ошибках для пользовательской ошибки. Должно быть числовое значение. См. таблицу ниже для возможных уровней отчета об ошибках |
| error_message | Необходимо. Указывает сообщение об ошибке определяемая пользователем |
| error_file | Необязательно. Задает имя файла, в котором произошла ошибка |
| error_line | Необязательно. Указывает номер строки, в которой произошла ошибка |
| error_context | Необязательно. Задает массив, содержащий все переменные и их значения, используемые при возникновении ошибки |
PHP Уровни отчетов об ошибках
Эти уровни отчетов об ошибках, являются различными типами ошибок, для которых может использоваться определяемый пользователем обработчик ошибок:
| Значение | Констант | Описание |
|---|---|---|
| 2 | E_WARNING | Неустранимые ошибки выполнения. Выполнение скрипта не останавливается |
| 8 | E_NOTICE | Уведомления среды выполнения. Сценарий нашел что-то, что могло бы быть ошибкой, но могло бы также произойти при запуске сценария, как обычно |
| 256 | E_USER_ERROR | Неустранимая ошибка пользователя. Это похоже на набор E_ERROR установленный программистом с помощью функции PHP trigger_error() |
| 512 | E_USER_WARNING | Неустранимое пользовательское предупреждение. Это похоже на набор E_WARNING установленный программистом с помощью функции PHP trigger_error() |
| 1024 | E_USER_NOTICE | Автоматическое уведомление пользователя. Это похоже на набор E_NOTICE устанавливается программистом с помощью функции PHP trigger_error() |
| 4096 | E_RECOVERABLE_ERROR | Перехватываемая неустранимая ошибка. Это похоже на набор E_ERROR но может быть перехватана пользователем, определенной обработкой (смотреть также set_error_handler()) |
| 8191 | E_ALL | Все ошибки и предупреждение (E_STRICT становится частью E_ALL в PHP 5.4) |
Теперь давайте создадим функцию для обработки ошибок:
Пример
function customError($errno, $errstr) {
echo «<b>Ошибка:</b> [$errno] $errstr<br>»;
echo «Конечный Script»;
die();
}
Приведенный выше код, является простой функцией обработки ошибок. Когда он срабатывает, он получает код ошибки и сообщение об ошибке.
Затем выводится уровень ошибки и сообщение и завершается сценарий.
Теперь, когда Вы создали функцию обработки ошибок, Вы должны решить, когда она должно сработать.
PHP Установить обработчик ошибок
Обработчик ошибок по умолчанию для PHP является встроенным обработчиком ошибок.
Мы собираемся сделать функцию над обработчиком ошибок по умолчанию на время скрипта.
Можно изменить обработчик ошибок для применения только к некоторым ошибкам, таким образом,
сценарий может обрабатывать различные ошибки по-разному.
Однако, в этом примере мы будем использовать наш пользовательский обработчик ошибок для всех ошибок:
set_error_handler(«customError»);
Поскольку мы хотим, чтобы наша пользовательская функция обрабатывала все ошибки, set_error_handler()
требуется только один параметр, второй параметр может быть добавлен, чтобы указать уровень ошибки.
Тестирование обработчика ошибок при попытке вывести несуществующую переменную:
Пример
<?php
//функция обработчика ошибок
function customError($errno, $errstr) {
echo «<b>Ошибка:</b> [$errno] $errstr»;
}
//установить обработчик ошибок
set_error_handler(«customError»);
//Вызов ошибки
echo($test);
?>
Выходные данные приведенного выше кода должны быть примерно такими:
Ошибка: [8] Неопределенна переменная: test
PHP Вызвать ошибку
В скрипте, где пользователи могут вводить данные, полезно инициировать ошибки, когда происходит незаконный ввод.
В PHP это делается с помощью функции trigger_error().
В этом примере возникает ошибка, если $test переменная больше, чем 1:
Пример
<?php
$test=2;
if ($test>=1)
{
trigger_error(«Значение должно быть 1 или ниже»);
}
?>
Выходные данные приведенного выше кода должны быть примерно такими:
Заметьте: Значение должно быть 1 или ниже
в C:webfoldertest.php на линии 6
Ошибка может быть вызвана в любом месте сценария и путем добавления
второй параметр, Вы можете указать, какой уровень ошибки срабатывает.
Возможные типы ошибок:
- E_USER_ERROR — Неустранимая пользовательская ошибка выполнения. Ошибки, из которых невозможно восстановить. Выполнение скрипта прекращается
- E_USER_WARNING — Непоправимое пользовательское предупреждение во время выполнения. Выполнение скрипта не останавливается
- E_USER_NOTICE — Невыполнение. Уведомление о времени выполнения, созданное пользователем. Сценарий нашел что-то, что могло бы быть ошибкой, но могло бы также произойти при запуске сценария
В этом примере E_USER_WARNING происходит, если переменная $test больше, чем 1. Если происходит E_USER_WARNING мы будем использовать наш пользовательский обработчик ошибок и закончить сценарий:
Пример
<?php
//функция обработчика ошибок
function customError($errno, $errstr) {
echo «<b>Ошибка:</b> [$errno] $errstr<br>»;
echo «Закончить Script»;
die();
}
//установить обработчик ошибок
set_error_handler(«customError»,E_USER_WARNING);
//вызов ошибки
$test=2;
if ($test>=1) {
trigger_error(«Значение должно быть 1 или ниже»,E_USER_WARNING);
}
?>
Выходные данные приведенного выше кода должны быть примерно такими:
Ошибка: [512] Значение должно быть 1 или ниже
Конец скрипта
Теперь, когда мы научились создавать собственные ошибки и как их вызвать,
давайте посмотрим на ошибки.
PHP Регистрация ошибок
По умолчанию, PHP отправляет отчет об ошибке в систему регистрации на сервер или файл,
в зависимости от того, как конфигурация error_log установлена в php.ini-файл. По
с помощью функции error_log() можно отправлять журнал ошибок в указанный файл или в удаленное место назначения.
Отправка сообщений об ошибках по электронной почте, может быть хорошим способом получения уведомления о конкретных ошибках.
PHP Отправка сообщение об ошибке по электронной почте
В приведенном ниже примере мы отправим электронное письмо с сообщением об ошибке и
сценарий, если возникает ошибка:
Пример
<?php
//функция обработчика ошибок
function customError($errno, $errstr) {
echo «<b>Ошибка:</b> [$errno] $errstr<br>»;
echo «Веб-мастер был уведомлен»;
error_log(«Ошибка: [$errno] $errstr»,1,
«someone@example.com»,»От: webmaster@example.com»);
}
//установить обработчик ошибок
set_error_handler(«customError»,E_USER_WARNING);
//вызов ошибки
$test=2;
if ($test>=1) {
trigger_error(«Значение должно быть 1 или ниже»,E_USER_WARNING);
}
?>
Выходные данные приведенного выше кода должны быть примерно такими:
Ошибка: [512] Значение должно быть 1 или ниже
Веб-мастер был уведомлен
И почта, полученная из кода выше, выглядит так:
Ошибка: [512] начение должно быть 1 или ниже
Не должно использоваться со всеми ошибками. Регулярные ошибки должны быть зарегистрированы на
сервере, использующий систему регистрации PHP по умолчанию.