Обновление до английской версии

2025-07-28 06:39:58 +00:00 · 2021-12-28 09:27:15 +03:00
parent 4656238c46
commit 4175bf202c
7 changed files with 67 additions and 77 deletions
--- a/reference/dom/domnodelist.xml
+++ b/reference/dom/domnodelist.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c64a35e2b57ffbb002ff79e171ba643da0406dc6 Maintainer: mch Status: ready -->
+<!-- EN-Revision: 181e9c5572ed04ed712b8d7f858f61a94647c6ac Maintainer: mch Status: ready -->
 <!-- Reviewed: no -->
 <phpdoc:classref xml:id="class.domnodelist" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 <title>Класс DOMNodeList</title>
@ -75,6 +75,14 @@
       </row>
      </thead>
      <tbody>
+       <row>
+        <entry>8.0.0</entry>
+        <entry>
+         Класс <classname>DOMNodeList</classname> теперь реализует интерфейс
+         <interfacename>IteratorAggregate</interfacename>.
+         Ранее вместо этого был реализован интерфейс <interfacename>Traversable</interfacename>.
+        </entry>
+       </row>
       <row>
        <entry>7.2.0</entry>
        <entry>
@ -99,30 +107,6 @@
  </section>
  <!-- }}} -->

-  <section role="changelog">
-   &reftitle.changelog;
-   <informaltable>
-    <tgroup cols="2">
-     <thead>
-      <row>
-       <entry>&Version;</entry>
-       <entry>&Description;</entry>
-      </row>
-     </thead>
-     <tbody>
-      <row>
-       <entry>8.0.0</entry>
-       <entry>
-        Класс <classname>DOMNodeList</classname> теперь реализует интерфейс
-        <interfacename>IteratorAggregate</interfacename>.
-        Ранее вместо этого был реализован интерфейс <interfacename>Traversable</interfacename>.
-       </entry>
-      </row>
-     </tbody>
-    </tgroup>
-   </informaltable>
-  </section>
-
 </partintro>

 &reference.dom.entities.domnodelist;
--- a/reference/filesystem/functions/fgetcsv.xml
+++ b/reference/filesystem/functions/fgetcsv.xml
@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7d93e0fe5eabef4325e6fc33abc329d1d370be86 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 291d60430d25f2b508bebb5720b41cc68f9a6ec1 Maintainer: shein Status: ready -->
 <!-- Reviewed: no -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fgetcsv">
+<refentry xml:id="function.fgetcsv" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>fgetcsv</refname>
  <refpurpose>Читает строку из файла и производит разбор данных CSV</refpurpose>
@ -10,11 +10,11 @@
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
-   <type>array</type><methodname>fgetcsv</methodname>
+   <type class="union"><type>array</type><type>false</type></type><methodname>fgetcsv</methodname>
   <methodparam><type>resource</type><parameter>stream</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>length</parameter><initializer>0</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>length</parameter><initializer>&null;</initializer></methodparam>
   <methodparam choice="opt"><type>string</type><parameter>separator</parameter><initializer>","</initializer></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>enclosure</parameter><initializer>'"'</initializer></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>enclosure</parameter><initializer>"\""</initializer></methodparam>
   <methodparam choice="opt"><type>string</type><parameter>escape</parameter><initializer>"\\"</initializer></methodparam>
  </methodsynopsis>
  <para>
@ -57,7 +57,7 @@
       если только место разрыва не будет внутри ограничителей полей (enclosure).
      </para>
      <para>
-       Отсутствие этого параметра (или установка его в 0 в PHP 5.1.0 и выше) приведёт к
+       Отсутствие этого параметра (или установка его в 0 или &null;, начиная с PHP 8.0.0) приведёт к
       тому, что длина строки будет не ограничена. Это может сказаться на скорости выполнения.
      </para>
     </listitem>
@ -105,7 +105,7 @@
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
-   Возвращает индексированный массив с прочтёнными полями.
+   Возвращает индексированный массив с прочтёнными полями в случае успешного выполнения&return.falseforfailure;.
  </para>
  <note>
   <para>
@ -134,6 +134,12 @@
      </row>
     </thead>
     <tbody>
+      <row>
+       <entry>8.0.0</entry>
+       <entry>
+        Параметр <parameter>length</parameter> теперь допускает значение &null;.
+       </entry>
+      </row>
      <row>
       <entry>7.4.0</entry>
       <entry>
--- a/reference/filesystem/functions/fputcsv.xml
+++ b/reference/filesystem/functions/fputcsv.xml
@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: fcbbbd9fda2c03ed4a2e02ac23f2c06f8983f9d0 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 291d60430d25f2b508bebb5720b41cc68f9a6ec1 Maintainer: shein Status: ready -->
 <!-- Reviewed: no -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fputcsv">
+<refentry xml:id="function.fputcsv" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>fputcsv</refname>
  <refpurpose>Форматирует строку в виде CSV и записывает её в файловый указатель</refpurpose>
@ -14,7 +14,7 @@
   <methodparam><type>resource</type><parameter>stream</parameter></methodparam>
   <methodparam><type>array</type><parameter>fields</parameter></methodparam>
   <methodparam choice="opt"><type>string</type><parameter>separator</parameter><initializer>","</initializer></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>enclosure</parameter><initializer>'"'</initializer></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>enclosure</parameter><initializer>"\""</initializer></methodparam>
   <methodparam choice="opt"><type>string</type><parameter>escape</parameter><initializer>"\\"</initializer></methodparam>
   <methodparam choice="opt"><type>string</type><parameter>eol</parameter><initializer>"\n"</initializer></methodparam>
  </methodsynopsis>
--- a/reference/ftp/functions/ftp-mkdir.xml
+++ b/reference/ftp/functions/ftp-mkdir.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4d1c34c9b7a30cfc3a59641122c707a2812cfed7 Maintainer: blindman Status: ready -->
+<!-- EN-Revision: 181e9c5572ed04ed712b8d7f858f61a94647c6ac Maintainer: blindman Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.ftp-mkdir" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
@ -38,6 +38,7 @@
   </variablelist>
  </para>
 </refsect1>
+
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
@ -46,6 +47,14 @@
  </para>
 </refsect1>

+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   Выдаёт ошибку уровня <constant>E_WARNING</constant>, если каталог
+   уже существует или соответствующие права доступа препятствуют созданию каталога.
+  </simpara>
+ </refsect1>
+
 <refsect1 role="changelog">
  &reftitle.changelog;
  <informaltable>
@ -63,14 +72,6 @@
  </informaltable>
 </refsect1>

- <refsect1 role="errors">
-  &reftitle.errors;
-  <simpara>
-   Выдаёт ошибку уровня <constant>E_WARNING</constant>, если каталог
-   уже существует или соответствующие права доступа препятствуют созданию каталога.
-  </simpara>
- </refsect1>
-
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
--- a/reference/image/configure.xml
+++ b/reference/image/configure.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: e12ed8b6aa81a21cdb906eff8bbf805a2476b403 Maintainer: aur Status: ready -->
+<!-- EN-Revision: ef24d91830c7cfcccf469ba40b031b141582ed69 Maintainer: aur Status: ready -->
 <!-- Reviewed: no -->
 <section xml:id="image.installation" xmlns="http://docbook.org/ns/docbook">
 &reftitle.install;
@ -17,8 +17,8 @@
  (чтобы выбрать использование внешнего <productname>libgd</productname>, а не встроенного).
 </para>
 <para>
-  В Windows-системах, вы должны включить модуль GD2 DLL <filename>php_gd2.dll</filename>
-  в &php.ini;.
+  В Windows-системах, вы должны включить модуль GD DLL <filename>php_gd.dll</filename> в &php.ini;.
+  До PHP 8.0.0, DLL-файл назывался <filename>php_gd2.dll</filename>.
 </para>

 <para>
--- a/reference/mysqli/mysqli_result/num-rows.xml
+++ b/reference/mysqli/mysqli_result/num-rows.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: dfa86bcd6d25c244c5c18d8da25878dd71e299df Maintainer: mch Status: ready -->
+<!-- EN-Revision: 181e9c5572ed04ed712b8d7f858f61a94647c6ac Maintainer: mch Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="mysqli-result.num-rows" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
@ -94,6 +94,17 @@ printf("Получено %d строк.\n", $row_cnt);
  </example>
 </refsect1>

+ <refsect1 role="notes">
+  &reftitle.notes;
+  <note>
+   <para>
+    В отличие от функции <function>mysqli_stmt_num_rows</function>,
+    у этой функции нет варианта в объектно-ориентированном стиле.
+    В объектно-ориентированном стиле используйте метод чтения.
+   </para>
+  </note>
+ </refsect1>
+
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
@ -107,17 +118,6 @@ printf("Получено %d строк.\n", $row_cnt);
  </para>
 </refsect1>

- <refsect1 role="notes">
-  &reftitle.notes;
-  <note>
-   <para>
-    В отличие от функции <function>mysqli_stmt_num_rows</function>,
-    у этой функции нет варианта в объектно-ориентированном стиле.
-    В объектно-ориентированном стиле используйте метод чтения.
-   </para>
-  </note>
- </refsect1>
-
 </refentry><!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
--- a/reference/stream/functions/stream-socket-client.xml
+++ b/reference/stream/functions/stream-socket-client.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c3067ab0a7f55632c87da73368fd3c739e110a57 Maintainer: mch Status: ready -->
+<!-- EN-Revision: 181e9c5572ed04ed712b8d7f858f61a94647c6ac Maintainer: mch Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.stream-socket-client" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
@ -124,6 +124,22 @@
  </para>
 </refsect1><!-- }}} -->

+ <refsect1 role="errors"><!-- {{{ -->
+  &reftitle.errors;
+  <para>
+   В случае неудачного вызова функции аргументы  <parameter>error_code</parameter> и
+   <parameter>error_message</parameter> будут заполнены системной ошибкой,
+   которая произошла при системном вызове
+   <literal>connect()</literal>. Если значение, возвращённое в аргументе
+   <parameter>error_code</parameter> равно <literal>0</literal> и функция
+   возвратила значение &false;, это означает, что ошибка
+   произошла до вызова <literal>connect()</literal>. Это произошло
+   скорее всего из-за проблемы инициализации сокета. Примите во внимание,
+   что аргументы <parameter>error_code</parameter> и
+   <parameter>error_message</parameter> всегда будут передаваться по ссылке.
+  </para>
+ </refsect1><!-- }}} -->
+
 <refsect1 role="changelog">
  &reftitle.changelog;
  <informaltable>
@ -146,23 +162,6 @@
  </informaltable>
 </refsect1>

- <refsect1 role="errors"><!-- {{{ -->
-  &reftitle.errors;
-  <para>
-   В случае неудачного вызова функции аргументы  <parameter>error_code</parameter> и
-   <parameter>error_message</parameter> будут заполнены системной ошибкой,
-    которая произошла при системном вызове
-   <literal>connect()</literal>. Если значение, возвращённое в аргументе
-   <parameter>error_code</parameter> равно <literal>0</literal> и функция
-   возвратила значение &false;, это означает, что ошибка
-   произошла до вызова <literal>connect()</literal>. Это произошло
-   скорее всего из-за проблемы инициализации сокета. Примите во внимание,
-   что аргументы <parameter>error_code</parameter> и
-   <parameter>error_message</parameter> всегда будут передаваться по ссылке.
-  </para>
- </refsect1><!-- }}} -->
-
-
 <refsect1 role="examples"><!-- {{{ -->
  &reftitle.examples;
  <para>