streamWrapper::stream_open

(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)

streamWrapper::stream_open — Открывает файл или URL

Описание

public streamWrapper::stream_open(
    string $path,
    string $mode,
    int $options,
    ?string &$opened_path
): bool

Этот метод вызывается сразу после инициализации обёртки (например, fopen() и file_get_contents()).

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

path

Задаёт URL, который будет передан в вызывающую функцию.

Замечание:
URL можно разделить на части функцией parse_url(). URL должен быть отделен символами ://. Символы : и :/ пока работают, но дальнейшая поддержка не гарантируется.

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 и возвращает его компоненты

add a note

User Contributed Notes

There are no user contributed notes for this page.