Update stream-wrapper-register.xml

This commit is contained in:
Mikhail Alferov
2024-06-12 10:43:46 +03:00
committed by GitHub
parent c0e6c3ed31
commit 3c68765213

View File

@ -4,7 +4,7 @@
<refentry xml:id="function.stream-wrapper-register" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>stream_wrapper_register</refname>
<refpurpose>Регистрирует обёртку URL, реализованную в виде PHP-класса</refpurpose>
<refpurpose>Регистрирует URL-обёртку, которую реализовали как PHP-класс</refpurpose>
</refnamediv>
<refsect1 role="description"><!-- {{{ -->
&reftitle.description;
@ -15,9 +15,9 @@
<methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
Позволяет вам реализовать ваши собственные обработчики протоколов и потоков для использования
со всеми другими функциями файловой системы (такими как <function>fopen</function>,
<function>fread</function> и т.д.).
Функция разрешает реализовать пользовательские обработчики протоколов и потоков для работы
с другими функциями, которые работают с файловой системом (например, <function>fopen</function>,
<function>fread</function> и т. д.).
</para>
</refsect1><!-- }}} -->
@ -38,7 +38,7 @@
<term><parameter>class</parameter></term>
<listitem>
<para>
Название класса, который реализует протокол <parameter>protocol</parameter>.
Название класса, который реализует протокол из параметра <parameter>protocol</parameter>.
</para>
</listitem>
</varlistentry>
@ -46,9 +46,9 @@
<term><parameter>flags</parameter></term>
<listitem>
<para>
Должно быть установлено в <constant>STREAM_IS_URL</constant>, если
параметр <parameter>protocol</parameter> является протоколом URL. По умолчанию 0,
локальный поток.
Для параметра требуется установить значение <constant>STREAM_IS_URL</constant>, если
параметр <parameter>protocol</parameter> — URL-протокол. Значение по умолчанию равняется 0 —
локальный поток.
</para>
</listitem>
</varlistentry>
@ -62,8 +62,8 @@
&return.success;
</para>
<para>
<function>stream_wrapper_register</function> будет возвращать &false;, если
протокол <parameter>protocol</parameter> уже имеет обработчик.
Функция <function>stream_wrapper_register</function> будет возвращать &false;, если
у протокола <parameter>protocol</parameter> уже есть обработчик.
</para>
</refsect1>
@ -71,15 +71,19 @@
&reftitle.examples;
<para>
<example>
<title>Как зарегистрировать обёртку потока</title>
<title>Пример регистрации обёртки потока</title>
<programlisting role="php">
<![CDATA[
<?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+");
@ -92,7 +96,9 @@ rewind($fp);
while (!feof($fp)) {
echo fgets($fp);
}
fclose($fp);
var_dump($myvar);
if ($existed) {