stream_wrapper_register - Регистрирует обёртку URL, реализованную в виде PHP-класса
Вернуться к: Функции для работы с потоками
stream_wrapper_register
(PHP 4 >= 4.3.2, PHP 5, PHP 7)
stream_wrapper_register — Регистрирует обёртку URL, реализованную в виде PHP-класса
Описание
$protocol
, string $classname
[, int $flags = 0
] )Позволяет вам реализовать ваши собственные обработчики протоколов и потоков для использования со всеми другими функциями файловой системы (такими, как fopen(), fread() и т. д.).
Список параметров
-
protocol -
Название регистрируемой обёртки.
-
classname -
Название класса, который реализует протокол
protocol. -
flags -
Должно быть установлено в
STREAM_IS_URL, если параметрprotocolявляется протоколом URL. По умолчанию 0, локальный поток.
Возвращаемые значения
Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.
stream_wrapper_register() будет возвращать FALSE, если
протокол protocol уже имеет обработчик.
Список изменений
| Версия | Описание |
|---|---|
| 5.2.4 |
Добавлен параметр flags.
|
Примеры
Пример #1 Как зарегистрировать обёртку потока
<?php
$existed = in_array("var", stream_get_wrappers());
if ($existed) {
stream_wrapper_unregister("var");
}
stream_wrapper_register("var", "VariableStream");
$myvar = "";
$fp = fopen("var://myvar", "r+");
fwrite($fp, "line1\n");
fwrite($fp, "line2\n");
fwrite($fp, "line3\n");
rewind($fp);
while (!feof($fp)) {
echo fgets($fp);
}
fclose($fp);
var_dump($myvar);
if ($existed) {
stream_wrapper_restore("var");
}
?>
Результат выполнения данного примера:
line1 line2 line3 string(18) "line1 line2 line3 "
Смотрите также
- Класс-прототип streamWrapper
- Пример класса, зарегистрированного в качестве обертки потока
- stream_wrapper_unregister() - Отменяет регистрацию обертки URL
- stream_wrapper_restore() - Восстанавливает ранее разрегистрированную встроенную обёртку
- stream_get_wrappers() - Извлекает список зарегистрированных потоков
Вернуться к: Функции для работы с потоками