streamWrapper::stream_open - Открывает файл или URL
Вернуться к: streamWrapper
streamWrapper::stream_open
(PHP 4 >= 4.3.2, PHP 5, PHP 7)
streamWrapper::stream_open — Открывает файл или URL
Описание
$path
, string $mode
, int $options
, string &$opened_path
)This method is called immediately after the wrapper is initialized (f.e. by fopen() and file_get_contents()).
Список параметров
-
path -
Задает URL, который будет передан в вызывающую функцию.
Замечание:
URL можно разделить на части функцией parse_url(). URL должен быть отделен символами ://. Символы : and :/ пока работают, но дальнейшая поддержка не гарантируется.
-
mode -
Режим открытия файла, аналогичен режимам для fopen().
Замечание:
Не забывайте проверять, поддерживается ли режим
modeфайломpath. -
options -
Хранит дополнительные флаги, задаваемые API потоков. Может содержать одно или несколько значений объединенных операцией ИЛИ. Значения приведены ниже.
Флаг Описание STREAM_USE_PATHЕсли путь pathотносительный, требуется искать ресурс, используя include_path.STREAM_REPORT_ERRORSЕсли этот флаг задан, Вы можете вызывать ошибки функцией trigger_error() во время открытия потока. Если флаг не задан, ошибки вызывать нельзя. -
opened_path -
Если
pathуспешно открыт, иSTREAM_USE_PATHзадана вoptions, то в аргументеopened_pathнеобходимо сохранить полный путь к открытому файлу или ресурсу.
Возвращаемые значения
Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.
Ошибки
Вызывает ошибку уровня
E_WARNING, если вызов к этому методу не удался
(например, не реализован).
Примечания
Замечание:
Свойство streamWrapper::$context будет обновлено, если корректный контекст был передан в вызываемую функцию.
Смотрите также
- fopen() - Открывает файл или URL
- parse_url() - Разбирает URL и возвращает его компоненты
Вернуться к: streamWrapper