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

2025-08-16 18:22:04 +00:00 · 2022-03-01 09:23:33 +03:00
parent f36435b10c
commit 50a4105039
9 changed files with 50 additions and 70 deletions
--- a/appendices/configure/php.xml
+++ b/appendices/configure/php.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 1b396e517f5fada0fc4ef02a7b7f66c673623430 Maintainer: mch Status: ready -->
+<!-- EN-Revision: 91da56315cff97da3020dd2934040e5035a6d1c6 Maintainer: mch Status: ready -->
 <!-- Reviewed: no -->
 <sect3 xml:id="configure.options.php" xmlns="http://docbook.org/ns/docbook">
  <title>Опции PHP</title>
@ -25,39 +25,6 @@
     </para>
    </listitem>
   </varlistentry>
-   <varlistentry xml:id="configure.enable-safe-mode">
-    <term>
-     <option role="configure">--enable-safe-mode</option>
-    </term>
-    <listitem>
-     <para>
-      Включает безопасный режим по умолчанию.
-     </para>
-     &warn.deprecated.feature-5-3-0.removed-5-4-0;
-    </listitem>
-   </varlistentry>
-   <varlistentry xml:id="configure.with-exec-dir">
-    <term>
-     <option role="configure">--with-exec-dir[=DIR]</option>
-    </term>
-    <listitem>
-     <para>
-      Разрешает запуск исполняемых файлов только из директории DIR в безопасном режиме, по умолчанию <literal>/usr/local/php/bin</literal>.
-     </para>
-     &warn.deprecated.feature-5-3-0.removed-5-4-0;
-    </listitem>
-   </varlistentry>
-   <varlistentry xml:id="configure.enable-magic-quotes">
-    <term>
-     <option role="configure">--enable-magic-quotes</option>
-    </term>
-    <listitem>
-     <para>
-      Включает автоматическое экранирование специальных символов по умолчанию.
-     </para>
-     &warn.deprecated.feature-5-3-0.removed-5-4-0;
-    </listitem>
-   </varlistentry>
   <varlistentry xml:id="configure.disable-short-tags">
    <term>
     <option role="configure">--disable-short-tags</option>
@ -68,21 +35,6 @@
     </para>
    </listitem>
   </varlistentry>
-   <varlistentry xml:id="configure.enable-zend-multibyte">
-    <term>
-     <option role="configure">--enable-zend-multibyte</option>
-    </term>
-    <listitem>
-     <para>
-      Включает поддержку многобайтового кода в синтаксическом и лексическом анализаторе языка при запуске.
-      Когда PHP скомпилирован с этой опцией, становится активной также директива
-      <link linkend="control-structures.declare.encoding">encoding</link>
-      в конструкции
-      <link linkend="control-structures.declare">declare</link>.
-     </para>
-     &warn.deprecated.feature-5-3-0.removed-5-4-0;
-    </listitem>
-   </varlistentry>
   <varlistentry xml:id="configure.with-libdir">
    <term>
     <option role="configure">--with-libdir</option>
@ -96,6 +48,18 @@
     </para>
    </listitem>
   </varlistentry>
+   <varlistentry xml:id="configure.enable-zts">
+    <term>
+     <option role="configure">--enable-zts</option>
+    </term>
+    <listitem>
+     <para>
+      Включает безопасность потоков.
+      До версии PHP 8.0.0 на системах, отличных от Windows,
+      эта опция называлась <option role="configure">--enable-maintainer-zts</option>.
+     </para>
+    </listitem>
+   </varlistentry>
  </variablelist>
 </sect3>
 <!-- Keep this comment at the end of the file
--- a/install/fpm/configuration.xml
+++ b/install/fpm/configuration.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 88333c7e4faf04190cf783247b470c7ea8b54196 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: fab4ea95f4fe1471be947602d0e9be32fb802265 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>
@ -494,7 +494,8 @@
    </term>
    <listitem>
     <para>
-      Ссылка, по которой можно посмотреть страницу состояния FPM. Если значение не установлено, то
+      Ссылка, по которой можно посмотреть <link linkend="fpm.status">страницу состояния FPM</link>.
+      Значение должно начинаться со слеша (/). Если значение не установлено, то
      страница статуса отображаться не будет. Значение по умолчанию: none.
     </para>
    </listitem>
--- a/reference/fpm/book.xml
+++ b/reference/fpm/book.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 04210d535db52aed64b82572817f059059ddfebc Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: fab4ea95f4fe1471be947602d0e9be32fb802265 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <book xml:id="book.fpm" xmlns="http://docbook.org/ns/docbook">
 <?phpdoc extension-membership="core" ?>
@ -14,6 +14,7 @@
 </preface>

 &reference.fpm.setup;
+ &reference.fpm.observability;
 &reference.fpm.reference;

 </book>
--- a/reference/parallel/setup.xml
+++ b/reference/parallel/setup.xml
@ -1,14 +1,15 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c636cca2822b42b1c56ce7f72e6efa25856533dc Maintainer: sergey Status: ready -->
+<!-- EN-Revision: 91da56315cff97da3020dd2934040e5035a6d1c6 Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
-
 <chapter xml:id="parallel.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Установка</title>

 <simplesect xml:id="parallel.requirements">
  &reftitle.required;
  <para>
-   Для работы parallel требуется сборка PHP с включённым ZTS (Zend Thread Safety) (--enable-keeper-zts или --enable-zts в Windows)
+   Для работы parallel требуется сборка PHP с включённым ZTS (Zend Thread Safety).
+   Сделать это можно указав при компиляции ключ <option role="configure">--enable-zts</option>
+   или на системах, отличных от Windows, до PHP 8.0.0, ключ <option role="configure">--enable-maintainer-zts</option>.
  </para>
  <caution>
  <para>
--- a/reference/pdo_pgsql/PDO/pgsqlGetNotify.xml
+++ b/reference/pdo_pgsql/PDO/pgsqlGetNotify.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: d5ba7eb2cd3954040c940bfd3a5b800b8db07ac8 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="pdo.pgsqlgetnotify" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
@ -9,7 +9,7 @@
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
-   <modifier>public</modifier> <type>array</type><methodname>PDO::pgsqlGetNotify</methodname>
+   <modifier>public</modifier> <type class="union"><type>array</type><type>false</type></type><methodname>PDO::pgsqlGetNotify</methodname>
   <methodparam choice="opt"><type>int</type><parameter>result_type</parameter><initializer><constant>PDO::FETCH_USE_DEFAULT</constant></initializer></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>ms_timeout</parameter><initializer>0</initializer></methodparam>
  </methodsynopsis>
--- a/reference/pht/configure.xml
+++ b/reference/pht/configure.xml
@ -1,12 +1,14 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 18f9cbcbc404fa3161104e4f3969531f686457af Maintainer: sergey Status: ready -->
+<!-- EN-Revision: 91da56315cff97da3020dd2934040e5035a6d1c6 Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
-
 <section xml:id="pht.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.install;

 <para>
-  PHP должен быть скомпилирован с включённым режимом ZTS (Zend Thread Safety). Если PHP компилируется из исходных текстов, необходимо использовать параметр конфигурации <option role="configure">--enable-maintainer-zts</option> (--enable-zts в Windows).
+  PHP должен быть скомпилирован с включённым режимом ZTS (Zend Thread Safety).
+  Если PHP компилируется из исходных текстов, необходимо использовать параметр конфигурации
+  <option role="configure">--enable-zts</option> (или на системах, отличных от Windows, до версии PHP 8.0.0,
+  <option role="configure">--enable-maintainer-zts</option>).
 </para>

 <para>
--- a/reference/pthreads/setup.xml
+++ b/reference/pthreads/setup.xml
@ -1,14 +1,15 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ba08db8805ddb14cbab613c893dd47eacbda22f2 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 91da56315cff97da3020dd2934040e5035a6d1c6 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
-
 <chapter xml:id="pthreads.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.setup;

 <section xml:id="pthreads.requirements">
  &reftitle.required;
  <para>
-   Для pthreads необходима потокобезопасная сборка PHP, т.е. ZTS (Zend Thread Safety). Сделать это можно указав при компиляции ключ --enable-maintainer-zts, либо --enable-zts для Windows.
+   Для pthreads необходима потокобезопасная сборка PHP, т.е. ZTS (Zend Thread Safety).
+   Сделать это можно указав при компиляции ключ <option role="configure">--enable-zts</option>
+   или на системах, отличных от Windows, до PHP 8.0.0, ключ <option role="configure">--enable-maintainer-zts</option>.
  </para>
  <caution>
   <para>
--- a/reference/spl/splfixedarray.xml
+++ b/reference/spl/splfixedarray.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c80e398bcb1f060d16de768e46933d1a09f2de65 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 604002c979be4a699309f685ba913a04f71b69b9 Maintainer: shein Status: ready -->
 <!-- Reviewed: no -->
 <phpdoc:classref xml:id="class.splfixedarray" 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>Класс SplFixedArray</title>
@ -78,9 +78,15 @@
       <entry>8.1.0</entry>
       <entry>
        Класс <classname>SplFixedArray</classname> теперь реализует
-        интерфейс <interfacename>JsonSerializable</interfacename> и
-        <interfacename>IteratorAggregate</interfacename>.
-        Ранее был реализован только интерфейс <interfacename>Iterator</interfacename>.
+        интерфейс <interfacename>JsonSerializable</interfacename>.
+       </entry>
+      </row>
+      <row>
+       <entry>8.0.0</entry>
+       <entry>
+        Класс <classname>SplFixedArray</classname> теперь реализует
+        интерфейс <interfacename>IteratorAggregate</interfacename>.
+        Ранее был реализован интерфейс <interfacename>Iterator</interfacename>.
       </entry>
      </row>
     </tbody>
--- a/reference/sync/syncreaderwriter/construct.xml
+++ b/reference/sync/syncreaderwriter/construct.xml
@ -1,7 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 0da76b0197f60f498c56cc7a57c243b3865ce6b7 Maintainer: sergey Status: ready -->
+<!-- EN-Revision: f12b4010435efc7a015e65fbd274740710368487 Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
-
 <refentry xml:id="syncreaderwriter.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>SyncReaderWriter::__construct</refname>
@ -13,7 +12,7 @@
  <methodsynopsis>
   <modifier>public</modifier> <methodname>SyncReaderWriter::__construct</methodname>
   <methodparam choice="opt"><type>string</type><parameter>name</parameter></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>autounlock</parameter><initializer>&true;</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>autounlock</parameter><initializer>1</initializer></methodparam>
  </methodsynopsis>
  <para>
   Создаёт именованный или безымянный объект чтения-записи.
@ -36,6 +35,11 @@
       с бессмысленным сообщением об ошибке.
      </para>
     </note>
+     <note>
+      <simpara>
+       В Windows параметр <parameter>name</parameter> не должен содержать обратных слешей.
+      </simpara>
+     </note>
    </listitem>
   </varlistentry>
   <varlistentry>