Update 3abd17e to En (#1093)

* Update http.xml to en * Update file-get-contents.xml to en * Update libxml-set-streams-context.xml to en * Update stream-context-get-default.xml to en * Update stream-context-set-default.xml to en * Update xmlrpc-encode-request.xml to en
2026-03-23 23:32:16 +01:00 · 2025-07-25 16:28:46 +03:00
parent 552884ffaa
commit 880e6f88f2
6 changed files with 138 additions and 129 deletions
--- a/language/context/http.xml
+++ b/language/context/http.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: e7b81f2c31e6b824748eeb8106b8bd4dec386781 Maintainer: mch Status: ready -->
+<!-- EN-Revision: 3abd17e61d5022d503604cc06894254e3281acf5 Maintainer: mch Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="context.http" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false" role="stream_context_option">
 <refnamediv>
@@ -41,12 +41,12 @@
     </term>
     <listitem>
      <para>
-       Дополнительные заголовки для отправки во время запросом. Значения
+       Дополнительные заголовки для отправки в запросе. Значения
       в этой опции переопределяют другие значения наподобие
       <literal>User-Agent:</literal>, <literal>Host:</literal>
       и <literal>Authentication:</literal>, даже
       при следовании перенаправлениям заголовка <literal>Location:</literal>.
-       Поэтому не рекомендуется устанавливать заголовок <literal>Host:</literal>,
+       Поэтому лучше не устанавливать заголовок <literal>Host:</literal>,
       если включили опцию <parameter>follow_location</parameter>.
      </para>
      <para>
@@ -65,12 +65,12 @@
     </term>
     <listitem>
      <para>
-       Значение для отправки в заголовке <literal>User-Agent:</literal>. Это значение
-       будет использоваться, только если заголовок user-agent <emphasis>не</emphasis> указали
+       Значение для отправки в заголовке <literal>User-Agent:</literal>. Значение
+       учитывается, только если заголовок User-Agent <emphasis>не</emphasis> указали
       в опции контекста <literal>header</literal> выше.
      </para>
      <para>
-       По умолчанию используется значение директивы
+       По умолчанию извлекается значение директивы
       <link linkend="ini.user-agent">user_agent</link>
       из файла &php.ini;.
      </para>
@@ -84,7 +84,7 @@
     <listitem>
      <para>
       Дополнительные данные для отправки после
-       заголовков. Обычно используется
+       заголовков. Параметр часто указывают
       с POST- и PUT-запросами.
      </para>
     </listitem>
@@ -96,8 +96,8 @@
     </term>
     <listitem>
      <para>
-       URI-идентификатор, который указывает адрес прокси-сервера (например,
-       <literal>tcp://proxy.example.com:5100</literal>).
+       URI-идентификатор, который указывает адрес прокси-сервера, например:
+       <literal>tcp://proxy.example.com:5100</literal>.
      </para>
     </listitem>
    </varlistentry>
@@ -108,13 +108,13 @@
     </term>
     <listitem>
      <para>
-       Если для опции установили значение &true;, при формировании запроса
-       будет использоваться весь URI
-       (например, <literal>GET
+       Со значением &true; при формировании запроса
+       запрашивается весь URI,
+       например: <literal>GET
       http://www.example.com/path/to/file.html
-       HTTP/1.0</literal>).
-       Хотя это нестандартный формат запроса,
-       некоторые прокси-серверы его требуют.
+       HTTP/1.0</literal>.
+       Некоторые прокси-серверы требуют указывать весь идентификатор,
+       хотя это нестандартный формат запроса.
      </para>
      <para>
       По умолчанию &false;.
@@ -179,10 +179,10 @@
      <para>
       Время ожидания на чтение в секундах
       в виде числа с плавающей точкой (<type>float</type>),
-       например <literal>10.5</literal>.
+       например: <literal>10.5</literal>.
      </para>
      <para>
-       По умолчанию используется значение директивы
+       По умолчанию извлекается значение директивы
       <link linkend="ini.default-socket-timeout">default_socket_timeout</link>
       из файла &php.ini;.
      </para>
@@ -217,19 +217,19 @@
 <?php

 $postdata = http_build_query(
-    array(
+    [
        'var1' => 'некоторое содержимое',
-        'var2' => 'doh'
-    )
+        'var2' => 'doh',
+    ]
 );

-$opts = array('http' =>
-    array(
-        'method'  => 'POST',
-        'header'  => 'Content-type: application/x-www-form-urlencoded',
-        'content' => $postdata
-    )
-);
+$opts = [
+    'http' => [
+        'method'        => 'GET',
+        'max_redirects' => '0',
+        'ignore_errors' => '1',
+    ]
+];

 $context = stream_context_create($opts);

@@ -249,13 +249,13 @@ $result = file_get_contents('http://example.com/submit.php', false, $context);

 $url = "http://www.example.org/header.php";

-$opts = array('http' =>
-    array(
-        'method' => 'GET',
+$opts = [
+    'http' => [
+        'method'        => 'GET',
        'max_redirects' => '0',
-        'ignore_errors' => '1'
-    )
-);
+        'ignore_errors' => '1',
+    ]
+];

 $context = stream_context_create($opts);
 $stream = fopen($url, 'r', false, $context);
@@ -267,6 +267,7 @@ var_dump(stream_get_meta_data($stream));
 // Фактические данные в переменной $url
 var_dump(stream_get_contents($stream));
 fclose($stream);
+
 ?>
 ]]>
    </programlisting>
--- a/reference/filesystem/functions/file-get-contents.xml
+++ b/reference/filesystem/functions/file-get-contents.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ea62fb83196997032641b50fe44420305466195e Maintainer: shein Status: ready -->
+<!-- EN-Revision: 3abd17e61d5022d503604cc06894254e3281acf5 Maintainer: shein Status: ready -->
 <!-- Reviewed: no -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.file-get-contents" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
@@ -22,7 +22,7 @@
   что функция <function>file_get_contents</function> возвращает
   содержимое файла в строке длиной <parameter>length</parameter>
   байтов со смещения <parameter>offset</parameter>.
-   В случае неудачи функция <function>file_get_contents</function> вернёт &false;.
+   Функция <function>file_get_contents</function> вернёт &false;, если возникнет ошибка.
  </para>
  <para>
   Вызов функции <function>file_get_contents</function>
@@ -56,14 +56,12 @@
     <listitem>
      <note>
       <para>
-        Разрешается указывать константу
-        <constant>FILE_USE_INCLUDE_PATH</constant> для поиска файла
-        в списке путей <link linkend="ini.include-path">include path</link>.
-        Обратите внимание, в коде <link
-        linkend="language.types.declarations.strict">со строгой типизацией</link>
+        Для поиска файла в списке путей директивы <link linkend="ini.include-path">include path</link>
+        в параметр перадают константу <constant>FILE_USE_INCLUDE_PATH</constant>.
+        Обратите внимание, в коде <link linkend="language.types.declarations.strict">со строгой типизацией</link>
        так сделать не получится, потому что
        значение константы <constant>FILE_USE_INCLUDE_PATH</constant> принадлежит типу <type>int</type>.
-        Тогда лучше задать &true;.
+        В строгом режиме лучше установить значение &true;.
       </para>
      </note>
     </listitem>
@@ -74,8 +72,8 @@
      <para>
       Корректный ресурс контекста, который возвращает функция
       <function>stream_context_create</function>.
-       Чтобы пропустить параметр, в него передают значение &null;,
-       когда особый контекст не нужен.
+       В параметр передают значение &null;,
+       если специфичный контекст не требуется.
      </para>
     </listitem>
    </varlistentry>
@@ -84,13 +82,13 @@
     <listitem>
      <para>
       Смещение, с которого начнётся чтение оригинального потока.
-       Отрицательное значение смещения будет отсчитываться с конца потока.
+       Отрицательное значение смещения отсчитывается с конца потока.
      </para>
      <para>
-       Поиск смещения (<parameter>offset</parameter>) не поддерживается при
-       работе с удалёнными файлами. Попытка поиска смещения на нелокальных
-       файлах может работать при небольших смещениях, но результат будет
-       непредсказуемым, так как функция работает на буферизованном потоке.
+       Поиск смещения <parameter>offset</parameter> не поддерживается
+       при работе с удалёнными файлами. Попытка поиска смещения на нелокальных
+       файлах иногда работает при небольших смещениях, но результат будет
+       непредсказуемым, поскольку функция работает на буферизованном потоке.
      </para>
     </listitem>
    </varlistentry>
@@ -111,7 +109,7 @@
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
-   Функция возвращает прочтённые данные&return.falseforfailure;.
+   Функция возвращает данные, которые считала,&return.falseforfailure;.
  </para>
  &return.falseproblem;
 </refsect1>
@@ -119,13 +117,13 @@
 <refsect1 role="errors">
  &reftitle.errors;
  <para>
-   Функция выдаёт ошибку уровня <constant>E_WARNING</constant>,
-   если не получится найти файл <parameter>filename</parameter>, для параметра <parameter>length</parameter>
-   задали значение меньше нуля или поиск по смещению <parameter>offset</parameter> в потоке
+   Функция выдаст ошибку уровня <constant>E_WARNING</constant>,
+   если не найдёт файл <parameter>filename</parameter>, для параметра <parameter>length</parameter>
+   установили значение меньше нуля или поиск по смещению <parameter>offset</parameter> в потоке
   завершится неудачно.
  </para>
  <para>
-   Когда функция <function>file_get_contents</function> вызывается для каталога,
+   При вызове функции <function>file_get_contents</function> на каталоге
   в ОС Windows генерируется ошибка уровня <constant>E_WARNING</constant>,
   а с PHP 7.4 и в других операционных системах.
  </para>
@@ -221,13 +219,13 @@ string(14) "lle Bjori Ro"
 <?php

 // Создаём поток
-$opts = array(
-    'http'=>array(
-        'method' => "GET",
-        'header' => "Accept-language: en\r\n" .
-             "Cookie: foo=bar\r\n"
-    )
-);
+$opts = [
+  'http' => [
+    'method' => "GET",
+    'header' => "Accept-language: en\r\n" .
+                "Cookie: foo=bar",
+  ]
+];

 $context = stream_context_create($opts);

--- a/reference/libxml/functions/libxml-set-streams-context.xml
+++ b/reference/libxml/functions/libxml-set-streams-context.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 81bc2b5f454f893206009e0e931a72c85a86ac63 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 3abd17e61d5022d503604cc06894254e3281acf5 Maintainer: tmn Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.libxml-set-streams-context" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
@@ -83,21 +83,22 @@
  <para>
   <example>
    <title>Пример установки контекста потоков функцией <function>libxml_set_streams_context</function></title>
-    <programlisting role="php">
+    <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php

-$opts = array(
-    'http' => array(
+$opts = [
+    'http' => [
        'user_agent' => 'PHP libxml agent',
-    )
-);
+    ]
+];

 $context = stream_context_create($opts);
 libxml_set_streams_context($context);

 // Загрузить файл по протоколу HTTP
-$doc = DOMDocument::load('http://www.example.com/file.xml');
+$dom = new DOMDocument();
+$doc = $dom->load('http://www.example.com/file.xml');

 ?>
 ]]>
--- a/reference/stream/functions/stream-context-get-default.xml
+++ b/reference/stream/functions/stream-context-get-default.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 6a5b227850bbad1ec81fd52b6a08e12e3f2c03ac Maintainer: mch Status: ready -->
+<!-- EN-Revision: 3abd17e61d5022d503604cc06894254e3281acf5 Maintainer: mch Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.stream-context-get-default" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
@@ -14,11 +14,11 @@
   <methodparam choice="opt"><type class="union"><type>array</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>
  </methodsynopsis>
  <simpara>
-   Возвращает контекст потока по умолчанию, который используется в любых файловых операциях
-   (<function>fopen</function>, <function>file_get_contents</function> и т.д.),
-   вызванных без параметра контекста. Опции для контекста по умолчанию могут быть
-   опционально указаны с помощью этой функцией используя тот же синтаксис, что и для
-   <function>stream_context_create</function>.
+   Функция возвращает контекст потока по умолчанию, который применяют функции наподобие
+   <function>fopen</function>, <function>file_get_contents</function>
+   при вызове без параметра контекста. При вызове с необязательным аргументом
+   функция установит опции контекста по умолчанию. Синтаксис опций аналогичен
+   формату параметра <parameter>options</parameter> функции <function>stream_context_create</function>.
  </simpara>
 </refsect1>

@@ -30,7 +30,7 @@
     <term><parameter>options</parameter></term>
     <listitem>
      <simpara>
-       <parameter>options</parameter> должен быть ассоциативным массивом
+       Параметр <parameter>options</parameter> принимает ассоциативный массив
       ассоциативных массивов в формате
       <literal>$arr['wrapper']['option'] = $value</literal> или &null;.
      </simpara>
@@ -43,7 +43,7 @@
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
-   Ресурс (<type>resource</type>) контекста потока.
+   Функция возвращает ресурс (<type>resource</type>) контекста потока.
  </para>
 </refsect1>

@@ -61,7 +61,7 @@
     <row>
      <entry>8.0.0</entry>
      <entry>
-       Параметр <parameter>options</parameter> теперь допускает значение null.
+       Параметр <parameter>options</parameter> теперь принимает значение null.
      </entry>
     </row>
    </tbody>
@@ -73,39 +73,39 @@
  &reftitle.examples;
  <para>
   <example xml:id="stream-context-get-default.example.basic">
-    <title>Пример использования <function>stream_context_get_default</function></title>
+    <title>Пример получения контекста потока по умолчанию функцией <function>stream_context_get_default</function></title>
    <programlisting role="php">
 <![CDATA[
 <?php
-$default_opts = array(
-  'http'=>array(
-    'method'=>"GET",
-    'header'=>"Accept-language: en\r\n" .
-              "Cookie: foo=bar",
-    'proxy'=>"tcp://10.54.1.39:8000"
-  )
-);

+$default_opts = [
+  'http' => [
+    'method' => "GET",
+    'header' => "Accept-language: en\r\n" .
+                "Cookie: foo=bar",
+    'proxy' =>  "tcp://10.54.1.39:8000",
+  ]
+];

-$alternate_opts = array(
-  'http'=>array(
-    'method'=>"POST",
-    'header'=>"Content-type: application/x-www-form-urlencoded\r\n" .
-              "Content-length: " . strlen("baz=bomb"),
-    'content'=>"baz=bomb"
-  )
-);
+$alternate_opts = [
+  'http' => [
+    'method'  => "POST",
+    'header'  => "Content-type: application/x-www-form-urlencoded\r\n" .
+                 "Content-length: " . strlen("baz=bomb"),
+    'content' => "baz=bomb",
+  ]
+];

 $default = stream_context_get_default($default_opts);
 $alternate = stream_context_create($alternate_opts);

-/* Отправляет обычный GET-запрос на прокси-сервер 10.54.1.39
- * Для www.example.com используются опции контекста, указанные в $default_opts
+/* Функция отправляет стандартный GET-запрос на прокси-сервер 10.54.1.39;
+ * для адреса www.example.com применяются опции контекста из массива $default_opts
 */
 readfile('http://www.example.com');

-/* Отправляет POST-запрос напрямую к www.example.com
- * Используемые опции контекста определены в $alternate_opts
+/* Функция отправляет POST-запрос на адрес www.example.com;
+ * применяются опции контекста из массива $alternate_opts
 */
 readfile('http://www.example.com', false, $alternate);

@@ -122,7 +122,7 @@ readfile('http://www.example.com', false, $alternate);
   <simplelist>
    <member><function>stream_context_create</function></member>
    <member><function>stream_context_set_default</function></member>
-    <member>Список поддерживаемых обёрток с опциями контекста (<xref linkend="wrappers"/>).</member>
+    <member><xref linkend="wrappers"/>: список поддерживаемых обёрток и опций контекста</member>
   </simplelist>
  </para>
 </refsect1><!-- }}} -->
--- a/reference/stream/functions/stream-context-set-default.xml
+++ b/reference/stream/functions/stream-context-set-default.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f3aca6e5fd6dee9473aa034a1e2214daaf2ad070 Maintainer: mch Status: ready -->
+<!-- EN-Revision: 3abd17e61d5022d503604cc06894254e3281acf5 Maintainer: mch Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.stream-context-set-default" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
@@ -14,10 +14,11 @@
   <methodparam><type>array</type><parameter>options</parameter></methodparam>
  </methodsynopsis>
  <simpara>
-   Функция устанавливает контекст потока по умолчанию, который будет использоваться всякий раз, когда файловые операции
-   (функции <function>fopen</function>, <function>file_get_contents</function> и т. д.)
-   вызываются без параметра контекста. Используется тот же синтаксис, что и в функции
-   <function>stream_context_create</function>.
+   Функция устанавливает контекст потока по умолчанию, который станут применять функции наподобие
+   <function>fopen</function>, <function>file_get_contents</function>
+   при вызове без параметра контекста. При вызове с необязательным аргументом
+   функция установит опции контекста по умолчанию. Синтаксис опций аналогичен
+   формату параметра <parameter>options</parameter> функции <function>stream_context_create</function>.
  </simpara>
 </refsect1>

@@ -55,24 +56,24 @@
  &reftitle.examples;
  <para>
   <example xml:id="stream-context-set-default.example.basic"><!-- {{{ -->
-    <title>Пример использования функции <function>stream_context_set_default</function></title>
+    <title>Пример установки контекста потока по умолчанию функцией <function>stream_context_set_default</function></title>
    <programlisting role="php">
 <![CDATA[
 <?php

-$default_opts = array(
-    'http' => array(
-        'method' => "GET",
-        'header' => "Accept-language: en\r\n" .
-            "Cookie: foo=bar",
-        'proxy' => "tcp://10.54.1.39:8000"
-    )
-);
+$default_opts = [
+  'http' => [
+    'method' => "GET",
+    'header' => "Accept-language: en\r\n" .
+                "Cookie: foo=bar",
+    'proxy'  => "tcp://10.54.1.39:8000",
+  ]
+];

 $default = stream_context_set_default($default_opts);

-/* Отправляет обычный GET-запрос к прокси-серверу по адресу 10.54.1.39
- * Для www.example.com используются опции контекста, которые указали в переменной $default_opts
+/* Отправляет стандартный GET-запрос на прокси-сервер по адресу 10.54.1.39;
+ * для адреса www.example.com применяются опции контекста из массива $default_opts
 */
 readfile('http://www.example.com');

@@ -89,7 +90,7 @@ readfile('http://www.example.com');
   <simplelist>
    <member><function>stream_context_create</function></member>
    <member><function>stream_context_get_default</function></member>
-    <member>Listing of supported wrappers with context options (<xref linkend="wrappers"/>).</member>
+    <member><xref linkend="wrappers"/>: список поддерживаемых обёрток и опций контекста</member>
   </simplelist>
  </para>
 </refsect1><!-- }}} -->
--- a/reference/xmlrpc/functions/xmlrpc-encode-request.xml
+++ b/reference/xmlrpc/functions/xmlrpc-encode-request.xml
@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: mch Status: ready -->
+<!-- EN-Revision: 3abd17e61d5022d503604cc06894254e3281acf5 Maintainer: mch Status: ready -->
 <!-- Reviewed: no -->

 <refentry xml:id="function.xmlrpc-encode-request" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>xmlrpc_encode_request</refname>
-  <refpurpose>Генерирует XML для метода запроса</refpurpose>
+  <refpurpose>Генерирует XML-запрос для вызова удалённого метода</refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
@@ -26,7 +26,7 @@
     <term><parameter>method</parameter></term>
     <listitem>
      <para>
-       Имя метода для вызова.
+       Название метода для вызова.
      </para>
     </listitem>
    </varlistentry>
@@ -42,13 +42,13 @@
     <term><parameter>output_options</parameter></term>
     <listitem>
      <para>
-       Массив, уточняющий параметры вывода, может содержать (значения по умолчанию выделены):
+       Массив для определения параметров вывода. Значения по умолчанию выделены курсивом:
       <itemizedlist>
        <listitem><para>output_type: php, <emphasis>xml</emphasis></para></listitem>
        <listitem><para>verbosity: no_white_space, newlines_only, <emphasis>pretty</emphasis></para></listitem>
-        <listitem><para>escaping: cdata, <emphasis>non-ascii, non-print, markup</emphasis> (может быть строка с одним значением или массив с несколькими значениями)</para></listitem>
+        <listitem><para>escaping: cdata, <emphasis>non-ascii, non-print, markup</emphasis> — строка с единственным значением или массив значений</para></listitem>
        <listitem><para>version: simple, <emphasis>xmlrpc</emphasis>, soap 1.1, auto</para></listitem>
-        <listitem><para>encoding: <emphasis>iso-8859-1</emphasis>, другой набор символов, поддерживаемый iconv</para></listitem>
+        <listitem><para>encoding: <emphasis>iso-8859-1</emphasis> или другой набор символов, который поддерживается утилитой iconv</para></listitem>
       </itemizedlist>
      </para>
     </listitem>
@@ -60,7 +60,7 @@
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
-   Возвращает строку, содержащую XML-представление запроса.
+   Функция возвращает строку, которая содержит XML-представление запроса.
  </para>
 </refsect1>

@@ -68,23 +68,31 @@
  &reftitle.examples;
  <para>
   <example>
-    <title>Пример клиентской функции XMLRPC</title>
+    <title>Пример клиентской XMLRPC-функции</title>
    <programlisting role="php">
 <![CDATA[
 <?php
-$request = xmlrpc_encode_request("method", array(1, 2, 3));
-$context = stream_context_create(array('http' => array(
-    'method' => "POST",
-    'header' => "Content-Type: text/xml",
-    'content' => $request
-)));
+
+$request = xmlrpc_encode_request("method", [1, 2, 3]);
+
+$context = stream_context_create([
+    'http' => [
+        'method'  => "POST",
+        'header'  => "Content-Type: text/xml",
+        'content' => $request,
+    ]
+]);
+
 $file = file_get_contents("http://www.example.com/xmlrpc", false, $context);
+
 $response = xmlrpc_decode($file);
+
 if ($response && xmlrpc_is_fault($response)) {
    trigger_error("xmlrpc: $response[faultString] ($response[faultCode])");
 } else {
    print_r($response);
 }
+
 ?>
 ]]>
    </programlisting>