array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'streamwrapper.stream-open.php', 1 => 'streamWrapper::stream_open', 2 => 'Открывает файл или URL', ), 'up' => array ( 0 => 'class.streamwrapper.php', 1 => 'streamWrapper', ), 'prev' => array ( 0 => 'streamwrapper.stream-metadata.php', 1 => 'streamWrapper::stream_metadata', ), 'next' => array ( 0 => 'streamwrapper.stream-read.php', 1 => 'streamWrapper::stream_read', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/stream/streamwrapper/stream-open.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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 будет обновлено, если корректный контекст был передан в вызываемую функцию.

Смотрите также