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