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

appendices/ini.core.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 0e28c9d2faff8076a360f9485c7e38dd3c55a411 Maintainer: mch Status: ready -->
+<!-- EN-Revision: fccc7eb7010120c17732c57f93df1f321245376c Maintainer: mch Status: ready -->
 <!-- Reviewed: no -->
 <section xml:id="ini.core" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Описание встроенных директив &php.ini;</title>
@@ -249,11 +249,11 @@
       </simpara>
       <note>
        <para>
-        Если процесс стартован в режиме релиза, <link linkend="ini.zend.assertions">zend.assertions</link>
+        Если процесс запущен в режиме релиза, <link linkend="ini.zend.assertions">zend.assertions</link>
         не может быть изменён во время выполнения, так как код утверждений не генерируется.
        </para>
        <para>
-        Если процесс стартован в режиме разработки, <link linkend="ini.zend.assertions">zend.assertions</link>
+        Если процесс запущен в режиме разработки, <link linkend="ini.zend.assertions">zend.assertions</link>
         не может быть выставлен в <literal>-1</literal> во время выполнения..
        </para>
       </note>
@@ -1210,8 +1210,7 @@ include_path = ".:${USER}/pear/php"
      <listitem>
       <para>
        Ограничивает указанным деревом каталогов файлы, которые могут быть доступны для
-       PHP, включая сам файл. Эта директива <emphasis>НЕ</emphasis> подвержена влиянию
+       PHP, включая сам файл.
-       безопасного режима.
       </para>
       <para>
        Когда скрипт пытается получить доступ к файлу, например, с помощью функции

language/types/callable.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 0b005cfe4e7075d8f7c7472545eaee2b7f38526e Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: c897161ca5a62a887295c695adc161b8fde5d772 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <sect1 xml:id="language.types.callable">
  <title>Функции обратного вызова (callback-функции)</title>
@@ -104,7 +104,7 @@ class B extends A {
     }
 }
 
-call_user_func(array('B', 'parent::who')); // A
+call_user_func(array('B', 'parent::who')); // A, устарело, начиная с PHP 8.2.0
 
 // Тип 6: Объекты, реализующие __invoke, могут быть использованы как callback
 class C {

reference/datetime/book.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 1a9ee818e554e116b4721d432c6d671e14281ea0 Maintainer: aur Status: ready -->
+<!-- EN-Revision: 6071d92a37aa0dcda036e5c353072bb7cbfff739 Maintainer: aur Status: ready -->
 <!-- Reviewed: no -->
 <book xml:id="book.datetime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <?phpdoc extension-membership="core"?>
@@ -19,6 +19,13 @@
    Модуль предоставляет богатый набор методов для изменения и форматирования информации,
    включая обработку часовых поясов и переходов на летнее время.
   </para>
+  <para>
+   Возможности даты/времени в PHP реализуют календарь ISO 8601, который является
+   <link xlink:href="&url.proleptic-gregorian-calendar;">пролептическим григорианским календарём</link>,
+   реализующим текущие правила високосных дней, принятые до введения григорианского календаря,
+   а также включает год <literal>0</literal> как номер года между <literal>-1 до нашей эры</literal>
+   и <literal>1 нашей эры</literal>. Високосные секунды не поддерживаются.
+  </para>
   <para>
    Информация о дате и времени хранится в памяти в виде 64-разрядных чисел.
    Таким образом, поддерживаются все пригодные представления даты (включая отрицательные года).

reference/datetime/datetimeinterface/gettimestamp.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 02ff7fef5b34cf8f5395180d9d39fb64d9398d00 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 6071d92a37aa0dcda036e5c353072bb7cbfff739 Maintainer: shein Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="datetime.gettimestamp" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -105,6 +105,32 @@ echo date_timestamp_get($date);
    <screen>
 <![CDATA[
 1272509157
+]]>
+   </screen>
+  </example>
+  <para>
+   Если необходимо получить метку времени с миллисекундами или микросекундами,
+   можно использовать функцию <function>DateTimeInterface::format</function>.
+  </para>
+  <example>
+   <title>Получение метки времени с милли- и микросекундами</title>
+   <para>&style.oop;</para>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$date = new DateTimeImmutable();
+$milli = (int)$date->format('Uv'); // Метка времени с миллисекундами
+$micro = (int)$date->format('Uu'); // Метка времени с микросекундами
+
+echo $milli, "\n", $micro, "\n";
+?>
+]]>
+   </programlisting>
+   &examples.outputs.similar;
+   <screen>
+<![CDATA[
+1674057635586
+1674057635586918
 ]]>
    </screen>
   </example>
@@ -114,7 +140,8 @@ echo date_timestamp_get($date);
   &reftitle.seealso;
   <simplelist>
    <member><function>DateTime::setTimestamp</function></member>
-   <member><function>DateTime::format</function></member>
+   <member><function>DateTimeImmutable::setTimestamp</function></member>
+   <member><function>DateTimeInterface::format</function></member>
   </simplelist>
  </refsect1>
 

reference/errorfunc/functions/set-error-handler.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: bd38d9d20ab0186531a9e923494a30ac23b1ff8c Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 23906aa9f613d0f67538e4292b220cebf624d5f2 Maintainer: tmn Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.set-error-handler" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -36,10 +36,10 @@
   </para>
 
   <para>
-   Также важно помнить, что на совести обработчика лежит вызов функции
+   Также обратите внимание, что обработчик обязан при необходимости остановить
-   <function>die</function> в случае необходимости. Если происходит возврат
+   выполнение скрипта, вызвав функцию <function>exit</function>.
-   из обработчика ошибок, управление передаётся следующему выражению,
+   Если происходит возврат из обработчика ошибок,
-   стоящему за тем, что вызвало ошибку.
+   управление передаётся следующему выражению, стоящему за тем, что вызвало ошибку.
   </para>
   <para>
    Ошибки следующих типов не могут быть обработаны пользователем:

reference/filesystem/functions/is-writable.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 871a231f4a1caa5fb258ae53b1bb7d1fb2a0f949 Maintainer: shein Status: ready -->
+<!-- EN-Revision: fccc7eb7010120c17732c57f93df1f321245376c Maintainer: shein Status: ready -->
 <!-- Reviewed: no -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.is-writable">
  <refnamediv>
@@ -20,8 +20,7 @@
   </para>
   <para>
    Не забывайте, что PHP может обращаться к файлу от имени того пользователя,
-   от которого запущен веб-сервер (обычно 'nobody'). Ограничения безопасного
+   от которого запущен веб-сервер (обычно 'nobody').
-   режима не принимаются во внимание.
   </para>
  </refsect1>
 

reference/imagick/imagickkernel/scale.xml

@@ -1,11 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 66d9935ec5fe3ce3bed8c312ca0cb30b7a9995cf Maintainer: sergey Status: ready -->
+<!-- EN-Revision: 560a2e6464b7e9ba479ebf7dcc3725819f7eba83 Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
-
 <refentry xml:id="imagickkernel.scale" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>ImagickKernel::scale</refname>
-  <refpurpose>Описание</refpurpose>
+  <refpurpose>Масштабирует список ядер на заданную величину</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -16,14 +15,11 @@
    <methodparam choice="opt"><type>int</type><parameter>normalizeFlag</parameter></methodparam>
   </methodsynopsis>
   <para>
-   ScaleKernelInfo() масштабирует заданный список ядер на заданную величину,
+   Масштабирует заданный список ядер на заданную величину,
-   с нормализацией суммы значений ядра или без неё (в соответствии с заданными флагами).
+   с нормализацией или без нормализации суммы значений ядер (согласно заданным флагам).
 
    Точное поведение функции зависит от используемого типа нормализации,
    смотрите подробности на http://www.imagemagick.org/api/morphology.php#ScaleKernelInfo.
-
-   Флаг должен быть одним из следующих: Imagick::NORMALIZE_KERNEL_VALUE, Imagick::NORMALIZE_KERNEL_CORRELATE,
-   Imagick::NORMALIZE_KERNEL_PERCENT или не установлен.
   </para>
 
 
@@ -31,7 +27,31 @@
 
  <refsect1 role="parameters">
   &reftitle.parameters;
-  &no.function.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>scale</parameter></term>
+     <listitem>
+      <para>
+
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>normalizeFlag</parameter></term>
+     <listitem>
+      <para>
+       <simplelist>
+        <member>Imagick::NORMALIZE_KERNEL_NONE</member>
+        <member>Imagick::NORMALIZE_KERNEL_VALUE</member>
+        <member>Imagick::NORMALIZE_KERNEL_CORRELATE</member>
+        <member>Imagick::NORMALIZE_KERNEL_PERCENT</member>
+       </simplelist>
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
  </refsect1>
 
  <refsect1 role="returnvalues">

reference/info/functions/assert-options.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: bbd4f6a100b48cd3390590037088fe7c5c5cc0e7 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: e2e41fdb46fd7e23acc16c7e7ff36a9894b2cec7 Maintainer: tmn Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.assert-options" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -94,13 +94,14 @@
        Необязательный аргумент, новое значение настройки.
       </para>
       <para>
-       Callback-функция, установленная с помощью <constant>ASSERT_CALLBACK</constant> или assert.callback, должна иметь следующую подпись:
+       У callback-функции, установленной с помощью <constant>ASSERT_CALLBACK</constant> или assert.callback,
+       должна быть следующая сигнатура:
        <methodsynopsis role="procedural">
         <type>void</type><methodname>assert_callback</methodname>
-               <methodparam><type>string</type><parameter>file</parameter></methodparam>
+        <methodparam><type>string</type><parameter>file</parameter></methodparam>
-               <methodparam><type>int</type><parameter>line</parameter></methodparam>
+        <methodparam><type>int</type><parameter>line</parameter></methodparam>
-               <methodparam><type>string</type><parameter>assertion</parameter></methodparam>
+        <methodparam><type class="union"><type>string</type><type>null</type></type><parameter>assertion</parameter></methodparam>
-               <methodparam choice="opt"><type>string</type><parameter>description</parameter></methodparam>
+        <methodparam choice="opt"><type>string</type><parameter>description</parameter></methodparam>
        </methodsynopsis>
        <variablelist>
         <varlistentry>
@@ -123,8 +124,10 @@
          <term><parameter>assertion</parameter></term>
          <listitem>
           <simpara>
-           Утверждение, которое было передано в <function>assert</function>,
+           До PHP 8.0.0 утверждение, которое передавалось в функцию <function>assert</function>,
-           преобразованное в строку.
+           но только если утверждение задано в виде строки.
+           (Если утверждение является булевым условием, этот параметр будет пустой строкой).
+           Начиная с PHP 8.0.0, этот параметр всегда &null;.
           </simpara>
          </listitem>
         </varlistentry>

reference/info/functions/assert.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 59af09939ab6e191c9836ea3b33b934e1a99a263 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: e2e41fdb46fd7e23acc16c7e7ff36a9894b2cec7 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.assert" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -32,10 +32,9 @@
     Если <parameter>assertion</parameter> задаётся в виде строки, оно будет
     рассматриваться функцией <function>assert</function> как PHP-код.
     Если вы передадите в качестве параметра <parameter>assertion</parameter>
-    логическое выражение, то это выражение не будет отображаться как параметр для
+    логическое выражение, то это выражение не будет передано в качестве параметра
-    функции утверждения, заданной с помощью <function>assert_options</function>.
+    callback-функции, заданной с помощью <function>assert_options</function>.
-    Это выражение будет преобразовано в строку перед вызовом функции обработчика, а
+    Вместо этого callback-функция получит пустую строку.
-    в случае &false; будет использована пустая строка.
    </para>
    <para>
     Утверждения должны использоваться только в целях отладки. Их можно использовать

reference/mail/ini.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 10c85e65bb92ed3677329a8985a7ed0b07c35171 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: fccc7eb7010120c17732c57f93df1f321245376c Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <section xml:id="mail.configuration" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.runtime;
@@ -104,8 +104,7 @@
     <listitem>
      <para>
       Принудительно добавить указанные параметры для отправки в sendmail.
-      Эти параметры всегда заменяют значение пятого параметра в <function>mail</function>,
+      Эти параметры всегда заменяют значение пятого параметра в <function>mail</function>.
-      даже в безопасном режиме.
      </para>
     </listitem>
    </varlistentry>

reference/mbstring/functions/mb-encoding-aliases.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 92f1b8b177eb5730382abf9f27bae868f1bb636f Maintainer: northcat Status: ready -->
+<!-- EN-Revision: 96bc008584eaea7d899b13234a88b1d84f82032b Maintainer: northcat Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.mb-encoding-aliases" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -35,18 +35,41 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   В случае успешного выполнения возвращает индексный массив с псевдонимами кодировки&return.falseforfailure;
+   Функция возвращает индексный массив с псевдонимами кодировки.
   </para>
  </refsect1>
 
  <refsect1 role="errors">
   &reftitle.errors;
   <para>
-   Вызывает ошибку уровня <constant>E_WARNING</constant>, если
+   Выбрасывает исключение <classname>ValueError</classname>, если
    кодировка <parameter>encoding</parameter> неизвестна.
   </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.0.0</entry>
+      <entry>
+       Если параметр <parameter>encoding</parameter> неизвестен, теперь выбрасывается исключение <classname>ValueError</classname>;
+       ранее выдавалась ошибка уровня <constant>E_WARNING</constant> и функция возвращала &false;.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <example>

reference/mysqli/ini.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 65716f4761484e314ee86fa23493f00f7823ace1 Maintainer: sergey Status: ready -->
+<!-- EN-Revision: f26734be49cca400204fcf3243271c7ff138823d Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
 <section xml:id="mysqli.configuration" xmlns="http://docbook.org/ns/docbook">
  &reftitle.runtime;
@@ -265,7 +265,7 @@
       Автоматически восстанавливать соединение при его потере.
      </para>
      <note>
-      <simpara>Эта настройка игнорируется драйвером "mysqlnd".</simpara>
+      <simpara>Эта настройка игнорируется драйвером "mysqlnd" и была удалена в PHP 8.2.0.</simpara>
      </note>
     </listitem>
    </varlistentry>

reference/mysqli/mysqli_driver.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 035c126c0393fe154bac46e2c3c489ebadce48a5 Maintainer: mch Status: ready -->
+<!-- EN-Revision: 779e37dc5ff4bd62095546eb554da30834821cb4 Maintainer: mch Status: ready -->
 <!-- Reviewed: no -->
 <phpdoc:classref xml:id="class.mysqli-driver" 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>Класс mysqli_driver</title>
@@ -52,26 +52,11 @@
      <type>int</type>
      <varname linkend="mysqli-driver.props.driver-version">driver_version</varname>
     </fieldsynopsis>
-    <fieldsynopsis>
-     <modifier>public</modifier>
-     <modifier>readonly</modifier>
-     <type>bool</type>
-     <varname linkend="mysqli-driver.props.embedded">embedded</varname>
-    </fieldsynopsis>
-    <fieldsynopsis>
-     <modifier>public</modifier>
-     <type>bool</type>
-     <varname linkend="mysqli-driver.props.reconnect">reconnect</varname>
-     <initializer>false</initializer>
-    </fieldsynopsis>
     <fieldsynopsis>
      <modifier>public</modifier>
      <type>int</type>
      <varname linkend="mysqli-driver.props.report-mode">report_mode</varname>
     </fieldsynopsis>
-
-    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
-    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.mysqli-driver')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='mysqli_driver'])" />
    </classsynopsis>
 <!-- }}} -->
 
@@ -118,7 +103,13 @@
     <varlistentry xml:id="mysqli-driver.props.reconnect">
      <term><varname>reconnect</varname></term>
      <listitem>
-      <para>Разрешить или запретить переподключение (смотрите INI-директиву mysqli.reconnect)</para>
+      <para>Разрешить или запретить переподключение (смотрите INI-директиву <link linkend="ini.mysqli.reconnect">mysqli.reconnect</link>)</para>
+      <warning>
+       <simpara>
+        Свойство было <emphasis>удалено</emphasis>
+        вместе с INI-директивой <link linkend="ini.mysqli.reconnect">mysqli.reconnect</link> в PHP 8.2.0.
+       </simpara>
+      </warning>
      </listitem>
     </varlistentry>
     <varlistentry xml:id="mysqli-driver.props.report-mode">
@@ -138,6 +129,47 @@
   </section>
 <!-- }}} -->
 
+  <section role="changelog">
+   &reftitle.changelog;
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>8.2.0</entry>
+       <entry>
+        Свойство <property>mysqli_driver::$reconnect</property> было удалено.
+       </entry>
+      </row>
+      <row>
+       <entry>8.1.0</entry>
+       <entry>
+        Свойство <property>mysqli_driver::$driver_version</property> объявлено устаревшим.
+       </entry>
+      </row>
+      <row>
+       <entry>8.0.0</entry>
+       <entry>
+        Свойство <property>mysqli_driver::$embedded</property> было удалено.
+       </entry>
+      </row>
+      <row>
+       <entry>7.4.0</entry>
+       <entry>
+        Метод <methodname>mysqli_driver::embedded_server_start</methodname> и
+        <methodname>mysqli_driver:embedded_server_end</methodname> были удалены.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </section>
+
  </partintro>
 
  &reference.mysqli.entities.mysqli-driver;