Update stream-context-set-option.xml to En

php · Dec 24, 2024 · eb977ea · eb977ea
1 parent 61d141a
commit eb977ea
Showing 1 changed file with 39 additions and 12 deletions.
diff --git a/reference/stream/functions/stream-context-set-option.xml b/reference/stream/functions/stream-context-set-option.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f7b3a3a469091c4015c224356de4824eb99b9232 Maintainer: mch Status: ready -->
+<!-- EN-Revision: d5859815063bb6d3a0953c773920ce7425cf912e Maintainer: mch Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.stream-context-set-option" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>stream_context_set_option</refname>
-  <refpurpose>Устанавливает опцию для потока/обёртки/контекста</refpurpose>
+  <refpurpose>Устанавливает опцию для потока, обёртки или контекста</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -16,14 +16,18 @@
    <methodparam><type>string</type><parameter>option</parameter></methodparam>
    <methodparam><type>mixed</type><parameter>value</parameter></methodparam>
   </methodsynopsis>
+  <para>
+   Следующая альтернативная сигнатура устарела с PHP 8.4.0,
+   вместо неё лучше пользоваться функцией <function>stream_context_set_options</function>.
   <methodsynopsis>
    <type>bool</type><methodname>stream_context_set_option</methodname>
    <methodparam><type>resource</type><parameter>stream_or_context</parameter></methodparam>
    <methodparam><type>array</type><parameter>options</parameter></methodparam>
   </methodsynopsis>
+  </para>
   <simpara>
-   Устанавливает опцию в указанном контексте. Значение <parameter>value</parameter>
-   устанавливается в <parameter>option</parameter> для <parameter>wrapper</parameter>
+   Функция устанавливает опцию в заданном контексте. Значение <parameter>value</parameter>
+   устанавливается в параметре <parameter>option</parameter> для обёртки <parameter>wrapper</parameter>.
   </simpara>
  </refsect1>
 
@@ -35,24 +39,24 @@
      <term><parameter>stream_or_context</parameter></term>
      <listitem>
       <para>
-       Поток или ресурс контекста, к которому будут применены опции.
+       Поток или ресурс контекста, к которому требуется применить опции.
       </para>
      </listitem>
     </varlistentry>
 <varlistentry>
      <term><parameter>wrapper</parameter></term>
      <listitem>
       <para>
-       Имя обёртки (может отличаться от протокола).
-       Смотрите <link linkend="context">опции и параметры контекста</link> для получения списка параметров потока.
+       Название обёртки, которое может отличаться от протокола.
+       Список параметров потока перечисляет раздел «<link linkend="context">Опции и параметры контекста</link>».
      </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><parameter>option</parameter></term>
      <listitem>
       <para>
-       Имя опции.
+       Название опции.
       </para>
      </listitem>
     </varlistentry>
@@ -68,17 +72,17 @@
      <term><parameter>options</parameter></term>
      <listitem>
       <para>
-       Опции, которые будут применены к <parameter>stream_or_context</parameter>.
+       Опции, которые требуется установить для потока или ресурса контекста <parameter>stream_or_context</parameter>.
       </para>
       <note>
        <para>
-        Параметр <parameter>options</parameter> должен быть ассоциативным массивом
+        Аргумент <parameter>options</parameter> передают как ассоциативный массив
         ассоциативных массивов в формате
         <literal>$arr['wrapper']['option'] = $value</literal>.
        </para>
        <para>
-        Обратитесь к разделу <link linkend="context">опции и параметры контекста</link>,
-        чтобы получить список опций потока.
+        Список параметров потока перечисляет раздел
+        «<link linkend="context">Опции и параметры контекста</link>».
        </para>
       </note>
      </listitem>
@@ -94,6 +98,29 @@
   </para>
  </refsect1><!-- }}} -->
 
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       Альтернативная сигнатура с двумя параметрами устарела.
+       Вместо устаревшей сигнатуры лучше пользоваться функцией <function>stream_context_set_options</function>.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
 </refentry>
 <!-- Keep this comment at the end of the file
 Local variables: