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

php · Dec 22, 2024 · d1c2378 · d1c2378
1 parent 079d098
commit d1c2378
Show file tree

Hide file tree

Showing 20 changed files with 298 additions and 141 deletions.
diff --git a/install/fpm/configuration.xml b/install/fpm/configuration.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: fe2ce5304bfe7eaadba78bebb877dcd197df4c41 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: b01a6761f8e5a1dc58ec92b4bba9b7b5878047fe Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <sect1 xml:id="install.fpm.configuration" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Настройка</title>
@@ -217,8 +217,8 @@
     <listitem>
      <para>
       Указывает, какой событийный механизм будет использовать FPM.
-      Доступны значения: select, pool, epoll, kqueue (*BSD), port (Solaris).
-      Значение по умолчанию: нет, работает автоопределение.
+      Доступны значения: epoll, kqueue (*BSD), port (Solaris), poll, select.
+      Значение по умолчанию: нет, работает автоопределение, отдавая предпочтение epoll и kqueue.
      </para>
     </listitem>
    </varlistentry>
@@ -1003,9 +1003,9 @@
            в стиле библиотечной C-функции <literal>strftime(3)</literal>:
            <literal>%d/%b/%Y:%H:%M:%S %z</literal> — значение по умолчанию.
            Строку формата в стиле функции <literal>strftime(3)</literal> потребуется инкапсулировать
-           в тег <literal>%{&lt;strftime_format&gt;}t</literal>, например, для форматирования строки
+           в тег <literal>%{&lt;strftime_format&gt;}T</literal>, например, для форматирования строки
            времени по стандарту ISO8601:
-           <literal>%{%Y-%m-%dT%H:%M:%S%z}t</literal>
+           <literal>%{%Y-%m-%dT%H:%M:%S%z}T</literal>
           </entry>
          </row>
          <row>

diff --git a/language-snippets.ent b/language-snippets.ent
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 9b68bf2b63200534e022bc65e800cae6c75abf26 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: ffd2ef754b37526c0b96e94859d57ce06acfbf41 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 
 <!ENTITY installation.enabled.disable 'Модуль включён по умолчанию. Модуль можно отключить во время выполнения опцией:'>
@@ -2006,6 +2006,27 @@ Etc/GMT+n и Etc/GMT-n обратные общепринятым.
   злоумышленником.
  </simpara>
 </warning>'>
+<!ENTITY dom.tokenlist.errors '<itemizedlist xmlns="http://docbook.org/ns/docbook">
+<listitem>
+ <simpara>
+  Выбрасывает ошибку <exceptionname>ValueError</exceptionname>,
+  если токен содержит нулевые байты.
+ </simpara>
+</listitem>
+<listitem>
+ <simpara>
+  Выбрасывает исключение <exceptionname>Dom\DOMException</exceptionname> с кодом <constant>Dom\SYNTAX_ERR</constant>,
+  если лексема является пустой строкой.
+ </simpara>
+</listitem>
+<listitem>
+ <simpara>
+  Выбрасывает исключение <exceptionname>Dom\DOMException</exceptionname> с кодом <constant>Dom\INVALID_CHARACTER_ERR</constant>,
+  если лексема содержит любой пробел ASCII.
+  ASCII whitespace.
+ </simpara>
+</listitem>
+</itemizedlist>'>
 
 <!-- Dom Examples -->
 <!ENTITY dom.book.example '<para xmlns="http://docbook.org/ns/docbook">Следующие примеры используют файл <filename>book.xml</filename>, который содержит следующие данные:</para>
@@ -2922,6 +2943,9 @@ xmlns="http://docbook.org/ns/docbook"><term>
 <!ENTITY fann.note.function.fann-2.2 '<note xmlns="http://docbook.org/ns/docbook"><para>Функция доступна,
 только если модуль fann собрали для модуля libfann &gt;= 2.2.</para></note>'>
 
+<!ENTITY stream.bucket.param 'Параметр <parameter>bucket</parameter> теперь ожидает экземпляр класса <classname>StreamBucket</classname>; ранее ожидался объект <classname>stdClass</classname>.'>
+<!ENTITY stream.bucket.return 'Функция теперь возвращает объект класса <classname>StreamBucket</classname>; ранее возвращался объект <classname>stdClass</classname>.'>
+
 <!-- Imagick generic return types -->
 <!ENTITY imagick.return.success 'Функция в случае успешной работы возвращает &true;.'>
 <!ENTITY imagick.imagick.throws 'Функция выбрасывает исключение ImagickException, если возникла ошибка.'>

diff --git a/reference/array/functions/array-unshift.xml b/reference/array/functions/array-unshift.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: caf779183ee9860b48c74c8994fb944039b6b56f Maintainer: shein Status: ready -->
+<!-- EN-Revision: 0987e913fcaed76897aeb239c6ed83d765a895e1 Maintainer: shein Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.array-unshift" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -153,6 +153,7 @@ $vegetables = [
 ];
 
 array_unshift($foods, $vegetables);
+
 var_dump($foods);
 
 ?>

diff --git a/reference/dom/dom/dom-tokenlist.xml b/reference/dom/dom/dom-tokenlist.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ebbc5bb97c8c063d31309725c0bb93d21213993b Maintainer: sergey Status: ready -->
+<!-- EN-Revision: ffd2ef754b37526c0b96e94859d57ce06acfbf41 Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
 <reference xml:id="class.dom-tokenlist" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>Класс Dom\TokenList</title>
@@ -46,7 +46,9 @@
     </fieldsynopsis>
 
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
-    <classsynopsisinfo role="comment">Пока не документировано</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-tokenlist')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Dom\\TokenList'])">
+     <xi:fallback/>
+    </xi:include>
    </classsynopsis>
   </section>
 
@@ -56,7 +58,7 @@
     <varlistentry xml:id="dom-tokenlist.props.length">
      <term><varname>length</varname></term>
      <listitem>
-      <simpara>Количество токенов.</simpara>
+      <simpara>Количество лексем.</simpara>
      </listitem>
     </varlistentry>
     <varlistentry xml:id="dom-tokenlist.props.value">
@@ -71,8 +73,15 @@
   <section role="notes">
    &reftitle.notes;
    &dom.note.modern.utf8;
+   <note>
+    <simpara>
+     Лексемы в списке могут быть доступны с помощью синтаксиса массива.
+    </simpara>
+   </note>
   </section>
 
  </partintro>
 
+ &reference.dom.dom.entities.tokenlist;
+
 </reference>
diff --git a/reference/intl/numberformatter/create.xml b/reference/intl/numberformatter/create.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 1976eae0d815797af97a1e16c5cd90ffc2868395 Maintainer: sergey Status: ready -->
+<!-- EN-Revision: b35a2269ff83dde1436a407952b08f78dbe39ead Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="numberformatter.create" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -88,6 +88,14 @@
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   Выбрасывается ошибка <exceptionname>ValueError</exceptionname>, если
+   значение параметра <parameter>locale</parameter> недопустимо.
+  </simpara>
+ </refsect1>
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <informaltable>
@@ -99,6 +107,15 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       <simpara>
+        Теперь выбрасывается ошибка <exceptionname>ValueError</exceptionname>, если
+        значение параметра <parameter>locale</parameter> недопустимо.
+       </simpara>
+      </entry>
+     </row>
      <row>
       <entry>8.0.0</entry>
       <entry>

diff --git a/reference/reflection/reflectionproperty/isdefault.xml b/reference/reflection/reflectionproperty/isdefault.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ec2fe9a592f794978114ef5021db9f1d00c2e05d Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 969db61a5f40e5f1cd259c3f46b74d8393ee2a23 Maintainer: tmn Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="reflectionproperty.isdefault" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -42,6 +42,8 @@
     <programlisting role="php">
 <![CDATA[
 <?php
+
+#[\AllowDynamicProperties]
 class Foo {
     public $bar;
 }

diff --git a/reference/simplexml/functions/simplexml-import-dom.xml b/reference/simplexml/functions/simplexml-import-dom.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 62514381ff35348ffc4061b691132e36adf96210 Maintainer: aur Status: ready -->
+<!-- EN-Revision: 739803892eb2a24535d5269752097c3792542adb Maintainer: aur Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.simplexml-import-dom" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -74,6 +74,12 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       Добавлена поддержка <classname>Dom\Document</classname>.
+      </entry>
+     </row>
      <row>
       <entry>8.4.0</entry>
       <entry>
@@ -91,34 +97,51 @@
   &reftitle.examples;
   <para>
    <example>
-    <title>Импорт DOM</title>
+    <title>Импорт <classname>DOMDocument</classname></title>
     <programlisting role="php">
 <![CDATA[
 <?php
-
-$dom = new DOMDocument();
-
-$dom->loadXML('<books><book><title>чепуха</title></book></books>');
-
+$dom = new DOMDocument;
+$dom->loadXML('<books><book><title>blah</title></book></books>');
 if (!$dom) {
-    echo 'Ошибка при разборе документа';
+    echo 'Error while parsing the document';
     exit;
 }
 
 $s = simplexml_import_dom($dom);
 
 echo $s->book[0]->title;
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+blah
+]]>
+    </screen>
+   </example>
+   <example>
+    <title>Импорт <classname>Dom\Document</classname></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$dom = Dom\XMLDocument::createFromString('<books><book><title>blah</title></book></books>');
+
+$s = simplexml_import_dom($dom);
 
+echo $s->book[0]->title;
 ?>
 ]]>
     </programlisting>
     &example.outputs;
     <screen>
 <![CDATA[
-чепуха
+blah
 ]]>
     </screen>
    </example>
+
   </para>
  </refsect1>
 

diff --git a/reference/stream/functions/stream-bucket-append.xml b/reference/stream/functions/stream-bucket-append.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 54b06426830ad1c96a042a848f40916b42f30d48 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 32caa89e81d180f209425159e2be2f243a3e12cc Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.stream-bucket-append" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -12,13 +12,33 @@
   <methodsynopsis>
    <type>void</type><methodname>stream_bucket_append</methodname>
    <methodparam><type>resource</type><parameter>brigade</parameter></methodparam>
-   <methodparam><type>object</type><parameter>bucket</parameter></methodparam>
+   <methodparam><type>StreamBucket</type><parameter>bucket</parameter></methodparam>
   </methodsynopsis>
 
   &warn.undocumented.func;
 
  </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>&stream.bucket.param;</entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
 </refentry>
 <!-- Keep this comment at the end of the file
 Local variables:

diff --git a/reference/stream/functions/stream-bucket-make-writeable.xml b/reference/stream/functions/stream-bucket-make-writeable.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 3561c702e7bea3265a72bbd598d0ef079db60145 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 32caa89e81d180f209425159e2be2f243a3e12cc Maintainer: tmn Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.stream-bucket-make-writeable" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -10,7 +10,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type class="union"><type>object</type><type>null</type></type><methodname>stream_bucket_make_writeable</methodname>
+   <type class="union"><type>StreamBucket</type><type>null</type></type><methodname>stream_bucket_make_writeable</methodname>
    <methodparam><type>resource</type><parameter>brigade</parameter></methodparam>
    </methodsynopsis>
    <para>
@@ -38,34 +38,30 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Функция возвращает объект бакета со свойствами, которые перечисляют следующие абзацы, или &null;.
-   <variablelist>
-    <varlistentry>
-     <term>
-      <property>data</property>
-      (<type>string</type>)
-     </term>
-     <listitem>
-      <para>
-       <parameter>data</parameter> <literal>bucket</literal> Текущая строка в бакете.
-      </para>
-     </listitem>
-    </varlistentry>
-    <varlistentry>
-     <term>
-      <property>datalen</property>
-      (<type>integer</type>)
-     </term>
-     <listitem>
-      <para>
-       <parameter>datalen</parameter> <literal>bucket</literal> Длина строки в бакете.
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
+   Функция возвращает объект бакета или &null;.
   </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>&stream.bucket.return;</entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>