Update f56de7e to En (#1113)

* Update get.xml to En * Update post.xml to En * Update php.xml to En * Update php.xml Удалил лишний закрывающий тег ?>
2026-03-23 23:32:16 +01:00 · 2025-10-11 01:35:49 +03:00
parent 18f5e1ef75
commit 7969d22a55
3 changed files with 101 additions and 62 deletions
--- a/language/predefined/variables/get.xml
+++ b/language/predefined/variables/get.xml
@@ -1,18 +1,17 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: cdaea0421544885f02ff3d36bd203dc01b78299e Maintainer: mch Status: ready -->
+<!-- EN-Revision: f56de7ebe7a1a85ce9e44a2bf6b77b07adfe3ae4 Maintainer: mch Status: ready -->
 <!-- Reviewed: no -->
-
 <refentry role="variable" xml:id="reserved.variables.get" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>$_GET</refname>
-  <refpurpose>Переменные HTTP GET</refpurpose>
+  <refpurpose>Переменные строки запроса</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <para>
-   Ассоциативный массив переменных, переданных скрипту через параметры URL (известные также как строка запроса).
-   Обратите внимание, что массив не только заполняется для GET-запросов, а скорее для всех запросов со строкой запроса.
+   Ассоциативный массив переменных, которые передали скрипту через параметры URL-адреса, в строке запроса.
+   На заполнение массива влияет только состав URL-адреса — содержит ли адрес аргументы в строке запроса, а не HTTP-метод запроса.
  </para>
 </refsect1>

@@ -20,17 +19,18 @@
  &reftitle.examples;
  <para>
   <example xml:id="variable.get.basic">
-    <title>Пример использования <varname>$_GET</varname></title>
+    <title>Пример работы с переменными массива <varname>$_GET</varname></title>
    <programlisting role="php">
 <![CDATA[
 <?php
+
 echo 'Привет, ' . htmlspecialchars($_GET["name"]) . '!';
+
 ?>
 ]]>
    </programlisting>
    <simpara>
-     Подразумевается, что пользователь ввёл в браузере
-     адрес http://example.com/?name=Иван
+     Подразумевается, что пользователь ввёл в браузере адрес <literal>http://example.com/?name=Иван</literal>.
    </simpara>
    &example.outputs.similar;
    <screen>
@@ -47,7 +47,7 @@ echo 'Привет, ' . htmlspecialchars($_GET["name"]) . '!';
  &note.is-superglobal;
  <note>
   <para>
-    Параметры GET обрабатываются <function>urldecode</function>.
+    Перед записью в массив <varname>$_GET</varname> значения автоматически обрабатываются функцией <function>urldecode</function>.
   </para>
  </note>
 </refsect1>
--- a/language/predefined/variables/post.xml
+++ b/language/predefined/variables/post.xml
@@ -1,19 +1,18 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: cdaea0421544885f02ff3d36bd203dc01b78299e Maintainer: mch Status: ready -->
+<!-- EN-Revision: f56de7ebe7a1a85ce9e44a2bf6b77b07adfe3ae4 Maintainer: mch Status: ready -->
 <!-- Reviewed: no -->
-
 <refentry role="variable" xml:id="reserved.variables.post" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>$_POST</refname>
-  <refpurpose>Переменные HTTP POST</refpurpose>
+  <refpurpose>Данные форм из запросов HTTP-методом POST</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <para>
-   Ассоциативный массив данных, переданных скрипту через HTTP методом POST
-   при использовании  <literal>application/x-www-form-urlencoded</literal> или <literal>multipart/form-data</literal>
-   в заголовке Content-Type запроса HTTP.
+   Ассоциативный массив данных, которые передали скрипту в запросе по протоколу HTTP методом POST
+   со значением <literal>application/x-www-form-urlencoded</literal> или <literal>multipart/form-data</literal>
+   в HTTP-заголовке Content-Type.
  </para>
 </refsect1>

@@ -21,16 +20,19 @@
  &reftitle.examples;
  <para>
   <example xml:id="variable.post.basic">
-    <title>Пример использования <varname>$_POST</varname></title>
+    <title>Пример работы с переменными массива <varname>$_POST</varname></title>
    <programlisting role="php">
 <![CDATA[
 <?php
+
 echo 'Привет ' . htmlspecialchars($_POST["name"]) . '!';
+
 ?>
 ]]>
    </programlisting>
    <simpara>
-     Подразумевается, что пользователь отправил через POST name=Иван
+     Подразумевается, что пользователь отправил POST-запрос с данными name=Иван
+     в теле запроса.
    </simpara>
    &example.outputs.similar;
    <screen>
@@ -45,6 +47,17 @@ echo 'Привет ' . htmlspecialchars($_POST["name"]) . '!';
 <refsect1 role="notes">
  &reftitle.notes;
  &note.is-superglobal;
+  <note>
+   <simpara>
+    Обёртка <link linkend="wrappers.php.input"><filename>php://input</filename></link>
+    умеет считывать из тела POST-запроса данные, которые при передаче закодировали другим способом,
+    например <literal>application/json</literal> или <literal>application/xml</literal>.
+    Суперглобальный массив <varname>$_POST</varname> работает только с данными
+    в форматах <literal>application/x-www-form-urlencoded</literal>
+    и <literal>multipart/form-data</literal>, а поток <filename>php://input</filename>
+    получает прямой доступ к сырым данным из тела запроса.
+   </simpara>
+  </note>
 </refsect1>

 <refsect1 role="seealso">
--- a/language/wrappers/php.xml
+++ b/language/wrappers/php.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 0592e6316d3869b49637df29c471097e7bf78592 Maintainer: mch Status: ready -->
+<!-- EN-Revision: f56de7ebe7a1a85ce9e44a2bf6b77b07adfe3ae4 Maintainer: mch Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="wrappers.php" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false" role="stream_wrapper">
 <refnamediv>
@@ -185,89 +185,89 @@
     </thead>
     <tbody>
      <row>
-       <entry>Ограничение по <link linkend="ini.allow-url-fopen">allow_url_fopen</link></entry>
+       <entry>Ограничение по директиве <link linkend="ini.allow-url-fopen">allow_url_fopen</link></entry>
       <entry>Нет</entry>
      </row>
      <row>
-       <entry>Ограничение по <link linkend="ini.allow-url-include">allow_url_include</link></entry>
+       <entry>Ограничение по директиве <link linkend="ini.allow-url-include">allow_url_include</link></entry>
       <entry>
-        только <literal>php://input</literal>,
+        только потоки <literal>php://input</literal>,
        <literal>php://stdin</literal>,
-        <literal>php://memory</literal> и
-        <literal>php://temp</literal>.
+        <literal>php://memory</literal>
+        и <literal>php://temp</literal>.
       </entry>
      </row>
      <row>
       <entry>Чтение</entry>
       <entry>
-        только <literal>php://stdin</literal>,
+        только потоки <literal>php://stdin</literal>,
        <literal>php://input</literal>,
        <literal>php://fd</literal>,
-        <literal>php://memory</literal> и
-        <literal>php://temp</literal>.
+        <literal>php://memory</literal>
+        и <literal>php://temp</literal>.
       </entry>
      </row>
      <row>
       <entry>Запись</entry>
       <entry>
-        только <literal>php://stdout</literal>,
+        только потоки <literal>php://stdout</literal>,
        <literal>php://stderr</literal>,
        <literal>php://output</literal>,
        <literal>php://fd</literal>,
-        <literal>php://memory</literal> и
-        <literal>php://temp</literal>.
+        <literal>php://memory</literal>
+        и <literal>php://temp</literal>.
       </entry>
      </row>
      <row>
       <entry>Добавление</entry>
       <entry>
-        только <literal>php://stdout</literal>,
+        только потоки <literal>php://stdout</literal>,
        <literal>php://stderr</literal>,
        <literal>php://output</literal>,
        <literal>php://fd</literal>,
-        <literal>php://memory</literal> и
-        <literal>php://temp</literal>. (Эквивалентно записи)
+        <literal>php://memory</literal>
+        и <literal>php://temp</literal>. (Эквивалентно записи)
       </entry>
      </row>
      <row>
       <entry>Одновременное чтение и запись</entry>
       <entry>
-        только <literal>php://fd</literal>,
-        <literal>php://memory</literal> и
-        <literal>php://temp</literal>.
+        только потоки <literal>php://fd</literal>,
+        <literal>php://memory</literal>
+        и <literal>php://temp</literal>.
       </entry>
      </row>
      <row>
-       <entry>Поддержка <function>stat</function></entry>
+       <entry>Поддержка функции <function>stat</function></entry>
       <entry>
-        нет. Тем не менее, <literal>php://memory</literal> и
-        <literal>php://temp</literal> поддерживают <function>fstat</function>.
+        нет. Тем не менее, потоки <literal>php://memory</literal>
+        и <literal>php://temp</literal> поддерживают функцию <function>fstat</function>.
       </entry>
      </row>
      <row>
-       <entry>Поддержка <function>unlink</function></entry>
+       <entry>Поддержка функции <function>unlink</function></entry>
       <entry>Нет</entry>
      </row>
      <row>
-       <entry>Поддержка <function>rename</function></entry>
+       <entry>Поддержка функции <function>rename</function></entry>
       <entry>Нет</entry>
      </row>
      <row>
-       <entry>Поддержка <function>mkdir</function></entry>
+       <entry>Поддержка функции <function>mkdir</function></entry>
       <entry>Нет</entry>
      </row>
      <row>
-       <entry>Поддержка <function>rmdir</function></entry>
+       <entry>Поддержка функции <function>rmdir</function></entry>
       <entry>Нет</entry>
      </row>
      <row>
-       <entry>Поддержка <function>stream_select</function></entry>
+       <entry>Поддержка функции <function>stream_select</function></entry>
       <entry>
-        только <literal>php://stdin</literal>,
+        только потоки <literal>php://stdin</literal>,
        <literal>php://stdout</literal>,
        <literal>php://stderr</literal>,
-        <literal>php://fd</literal> и
-        <literal>php://temp</literal>.
+        <literal>php://fd</literal>
+        и <literal>php://temp</literal>.
       </entry>
      </row>
     </tbody>
@@ -281,8 +281,8 @@
  <example><!-- {{{ -->
   <title>php://temp/maxmemory</title>
   <para>
-    Этот необязательный параметр разрешает установить ограничение памяти до того, как
-    поток <filename>php://temp</filename> начнёт использовать временный файл.
+    Этот необязательный параметр устанавливает ограничение памяти перед началом
+    работы потока <filename>php://temp</filename> с временным файлом.
   </para>
   <programlisting role="php">
 <![CDATA[
@@ -294,7 +294,7 @@ $fp = fopen("php://temp/maxmemory:$fiveMBs", 'r+');

 fputs($fp, "hello\n");

-// Читаем то, что записали
+// Читаем данные, которые записали на предыдущем шаге
 rewind($fp);
 echo stream_get_contents($fp);

@@ -305,9 +305,9 @@ echo stream_get_contents($fp);
  <example><!-- {{{ -->
   <title>php://filter/resource=&lt;поток для фильтрации&gt;</title>
   <para>
-    Этот параметр должен находиться
-    в конце спецификации <filename>php://filter</filename>
-    и указывать на поток, который необходимо отфильтровать.
+    Параметр указывают
+    в конце спецификации <filename>php://filter</filename>.
+    Значение параметра указывает на поток, который требуется отфильтровать.
   </para>
   <programlisting role="php">
 <![CDATA[
@@ -318,6 +318,7 @@ echo stream_get_contents($fp);
  поскольку на самом деле фильтры не указали */

 readfile("php://filter/resource=http://www.example.com");
+
 ?>
 ]]>
   </programlisting>
@@ -332,12 +333,12 @@ readfile("php://filter/resource=http://www.example.com");
 <![CDATA[
 <?php

-/* Этот скрипт выведет содержимое
+/* Скрипт выведет содержимое ресурса
  www.example.com полностью в верхнем регистре */
 readfile("php://filter/read=string.toupper/resource=http://www.example.com");

-/* Этот скрипт делает тоже самое, что вверхний, но
-  будет также кодировать алгоритмом ROT13 */
+/* Скрипт выполняет аналогичную работу,
+  но также кодирует данные алгоритмом ROT13 */
 readfile("php://filter/read=string.toupper|string.rot13/resource=http://www.example.com");

 ?>
@@ -347,28 +348,28 @@ readfile("php://filter/read=string.toupper|string.rot13/resource=http://www.exam
  <example><!-- {{{ -->
   <title>php://filter/write=&lt;список фильтров для применения к цепочке записи&gt;</title>
   <para>
-    Этот параметр принимает одно
+    Параметр принимает одно
    или несколько имён фильтров, разделённых вертикальной чертой <literal>|</literal>.
   </para>
   <programlisting role="php">
 <![CDATA[
 <?php

-/* Этот скрипт будет фильтровать строку "Hello World"
-  через фильтр rot13, затем записывать результат
+/* Скрипт отфильтрует строку "Hello World"
+  через фильтр rot13, затем запишет результат
  в файл example.txt в текущем каталоге */
-file_put_contents("php://filter/write=string.rot13/resource=example.txt","Hello World");
+file_put_contents("php://filter/write=string.rot13/resource=example.txt", "Hello World");

 ?>
 ]]>
   </programlisting>
  </example><!-- }}} -->
  <example>
-   <title>php://memory и php://temp нельзя переиспользовать</title>
+   <title>Недоступность повторного обращения к потокам php://memory и php://temp</title>
   <para>
    Потоки <filename>php://memory</filename> и <filename>php://temp</filename>
-    нельзя переиспользовать, то есть после закрытия потоков невозможно
-    сослаться на них снова.
+    невозможно переиспользовать, поэтому после закрытия потокового ресурса
+    нельзя обратиться к потоку повторно.
   </para>
   <programlisting role="php">
 <![CDATA[
@@ -377,6 +378,31 @@ file_put_contents("php://filter/write=string.rot13/resource=example.txt","Hello
 file_put_contents('php://memory', 'PHP');
 echo file_get_contents('php://memory'); // Ничего не выведет

+?>
+]]>
+   </programlisting>
+  </example>
+  <example>
+   <title>Чтение JSON-данных из тела запроса через обёртку php://input</title>
+   <para>
+    Пример показывает, как считывать входные данные в формате JSON из тела POST, PUT
+    и PATCH-запросов через обёртку <filename>php://input</filename>.
+   </para>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+$input = file_get_contents("php://input");
+
+$json_array = json_decode(
+    json: $input,
+    associative: true,
+    flags: JSON_THROW_ON_ERROR
+);
+
+echo "Поступили JSON-данные: ";
+print_r($json_array);
+
 ?>
 ]]>
   </programlisting>