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

Author: saundefined

language/predefined/closure/getcurrent.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 6fc2c24b6b465f4057d076a39c6910b8a484daad Maintainer: malferov Status: ready -->
+<!-- EN-Revision: f6406cdb5ef1b83108f4022996985967c3e45b0b Maintainer: malferov Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="closure.getcurrent" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -20,7 +20,7 @@
   </para>
   <para>
    Метод доступен только внутри замыкания; вызов извне контекста замыкания
-   сгенерирует ошибку.
+   сгенерирует ошибку: Current function is not a closure (текущая функция не является замыканием).
   </para>
  </refsect1>
 
@@ -55,7 +55,7 @@
 <?php
 
 $fibonacci = function (int $n) {
-    if (0 === $n || 1 === $n) {
+    if ($n === 0 || $n === 1) {
         return $n;
     }
 

language/predefined/generator/rewind.xml

@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 873a99f094902ad72129ab391b1fb80525fab30e Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 5e6944e79f2b19783627d76bd7fd1411feb23c65 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="generator.rewind" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Generator::rewind</refname>
-  <refpurpose>Перематывает генератор к первому выражению yield</refpurpose>
+  <refpurpose>Выполняет генератор до первого выражения yield</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -14,11 +14,10 @@
    <void/>
   </methodsynopsis>
   <para>
-   Метод перематывает генератор к первому выражению &yield;.
-   При перемотке генератор выполнит код, который идёт перед первым выражением &yield;,
-   если при вызове метода генератор ещё не дошёл до первого выражения &yield;.
-   Метод выбросит исключение <classname>Exception</classname>,
-   если метод вызывали, когда генератор уже перешёл ко второму выражению &yield;.
+   Выполняет генератор до <emphasis>первого</emphasis> выражения &yield; включительно.
+   Если генератор уже находится в <emphasis>первом</emphasis> &yield;, никаких действий не будет выполнено.
+   Если генератор когда-либо продвигался дальше выражения &yield;,
+   метод выбросит ошибку <classname>Exception</classname>.
   </para>
 
   <note>

language/predefined/iterator/rewind.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 460f49a93d103cac99556147cb9325b095ca3d42 Maintainer: das Status: ready -->
+<!-- EN-Revision: 7fbb16f538011636999459326a55d5f153ef2c61 Maintainer: das Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->
 <refentry xml:id="iterator.rewind" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -22,6 +22,15 @@
     Метод <emphasis>не будет</emphasis> вызван <emphasis>после</emphasis>
     цикла &foreach;.
    </para>
+   <simpara>
+    Поскольку &foreach; всегда вызывает метод <methodname>rewind</methodname> перед началом итерации,
+    ручное перемещение позиции итератора (например, с помощью метода <methodname>SplFileObject::seek</methodname>)
+    будет сброшено.
+   </simpara>
+   <simpara>
+    Для выполнения итерации без перемотки итератора, оберните его в
+    <classname>NoRewindIterator</classname>.
+   </simpara>
   </note>
  </refsect1>
 

reference/curl/functions/curl-close.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ce98b568f85353c4bf263133f09c4db9294833f9 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 86c8ebd19ed93843f293bdcecc9ce68cb4ab57bc Maintainer: shein Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.curl-close" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -52,6 +52,18 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.5.0</entry>
+      <entry>
+       Функция объявлена устаревшей.
+      </entry>
+     </row>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       Функция теперь является <acronym>NOP</acronym>.
+      </entry>
+     </row>
      &curl.changelog.handle-param;
     </tbody>
    </tgroup>

reference/datetime/constants.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 130701dd4e64351d38da565ab3043a8f795698f8 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 6bbb5b9685d27ac9df744702e06525047a163d4b Maintainer: tmn Status: ready -->
 <!-- Reviewed: no -->
 <appendix xml:id="datetime.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
@@ -68,6 +68,7 @@
    <listitem>
     <simpara>
      Дата и время в формате Atom (пример: <literal>2005-08-15T15:52:01+00:00</literal>).
+     совместимо с ISO-8601, RFC 3399 и XML Schema.
     </simpara>
    </listitem>
   </varlistentry>
@@ -92,7 +93,7 @@
    </term>
    <listitem>
     <simpara>
-     Дата и время в формате стандарта ISO-8601 (пример: <literal>2005-08-15T15:52:01+0000</literal>).
+     Дата и время в ISO-8601-подобном формате (пример: <literal>2005-08-15T15:52:01+0000</literal>).
     </simpara>
     <note>
      <simpara>

reference/datetime/datetimeimmutable/createfromformat.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: cafec7df4c6ba597b5ac45b03191aea18f3cabab Maintainer: shein Status: ready -->
+<!-- EN-Revision: f5e51d56b0a4dd7e70dd47ea7eb3c07fdc207ddd Maintainer: shein Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="datetimeimmutable.createfromformat" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -383,7 +383,7 @@
            «секунда», «милли-» или «микросекунда» и «часовой пояс»
            до начальных значений Unix-эпохи: <literal>0</literal> для часа, минуты и секунды,
            <literal>1</literal> для месяца и дня, <literal>1970</literal> для года
-           и <literal>UTC</literal> для информации о часовом поясе
+           и часового пояса по умолчанию
           </entry>
           <entry>
            Без символа <literal>!</literal> метод установит полям

reference/intl/locale/canonicalize.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 1976eae0d815797af97a1e16c5cd90ffc2868395 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 14a6825b9b50f0ee22f19b3fce82ced1c866ca57 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="locale.canonicalize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -14,11 +14,18 @@
    <modifier>public</modifier> <modifier>static</modifier> <type class="union"><type>string</type><type>null</type></type><methodname>Locale::canonicalize</methodname>
    <methodparam><type>string</type><parameter>locale</parameter></methodparam>
   </methodsynopsis>
-  <para>
-
-  </para>
 
-  &warn.undocumented.func;
+  <simpara>
+   Канонизирует переданную строку локали в формат ICU.
+  </simpara>
+  <simpara>
+   Метод может не указывать или возвращать действительную локаль.
+   Это лишь версия входных данных, которая была канонизирована в соответствии с правилами ICU.
+  </simpara>
+  <simpara>
+   Поведение метода зависит от версии ICU,
+   используемой PHP (<constant>INTL_ICU_VERSION</constant>).
+  </simpara>
 
  </refsect1>
 
@@ -28,9 +35,9 @@
    <varlistentry>
     <term><parameter>locale</parameter></term>
     <listitem>
-     <para>
-
-     </para>
+     <simpara>
+      Оригинальная строка локализации.
+     </simpara>
     </listitem>
    </varlistentry>
   </variablelist>
@@ -44,6 +51,25 @@
   &intl.locale-len.return;
  </refsect1>
 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title>Пример использования функции <function>locale_canonicalize</function></title>
+   <programlisting role="php">
+<![CDATA[
+echo Locale::canonicalize('en-US.utf8') . "\n";
+echo Locale::canonicalize('totally-not-valid') . "\n";
+]]>
+   </programlisting>
+  </example>
+  &example.outputs.similar;
+  <screen>
+<![CDATA[
+en_US
+totally_NOT_VALID
+]]>
+  </screen>
+ </refsect1>
 
 </refentry>
 <!-- Keep this comment at the end of the file

reference/json/setup.xml

@@ -1,20 +1,17 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: irker Status: ready -->
+<!-- EN-Revision: 2b5015d025e2b72b2a4dd894323961626872cac7 Maintainer: irker Status: ready -->
 <!-- Reviewed: no -->
 <chapter xml:id="json.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.setup;
 
  <section xml:id="json.installation">
   &reftitle.install;
   <para>
-   Модуль JSON включается и компилируется в PHP по умолчанию.
+   Модуль JSON является встроенным модулем PHP, поэтому он всегда включён.
   </para>
   <para>
-   Начиная с PHP 8.0.0 модуль JSON включили в ядро PHP, поэтому модуль не требуется включать и нельзя отключить.
-  </para>
-  <para>
-   &pecl.info;
-   <link xlink:href="&url.pecl.package;json">&url.pecl.package;json</link>
+   До PHP 8.0.0 модуль JSON был включён в состав PHP и скомпилирован по умолчанию,
+   но его можно было явно отключить с помощью <option role="configure">--disable-json</option>.
   </para>
  </section>
 

reference/ldap/functions/ldap-get-option.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 3ec3fa6848aae4b4535557105a42fbf8d57dcc07 Maintainer: mch Status: ready -->
+<!-- EN-Revision: aa120f36c5762e99f9ee121d8caf910e0a67121e Maintainer: mch Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.ldap-get-option" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -11,7 +11,7 @@
   &reftitle.description;
   <methodsynopsis>
    <type>bool</type><methodname>ldap_get_option</methodname>
-   <methodparam><type>LDAP\Connection</type><parameter>ldap</parameter></methodparam>
+   <methodparam><type class="union"><type>LDAP\Connection</type><type>null</type></type><parameter>ldap</parameter></methodparam>
    <methodparam><type>int</type><parameter>option</parameter></methodparam>
    <methodparam choice="opt"><type class="union"><type>array</type><type>string</type><type>int</type></type><parameter role="reference">value</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
@@ -28,7 +28,8 @@
      <term><parameter>ldap</parameter></term>
      <listitem>
       <para>
-       &ldap.parameter.ldap;
+       Либо экземпляр <classname>LDAP\Connection</classname>, возвращаемый функцией <function>ldap_connect</function>,
+       для получения опции для этого соединения, либо &null; для получения глобальной опции.
       </para>
      </listitem>
     </varlistentry>
@@ -243,6 +244,12 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.5.0</entry>
+      <entry>
+       Параметр <parameter>ldap</parameter> теперь допускает значение &null;.
+      </entry>
+     </row>
      &ldap.changelog.ldap-object;
     </tbody>
    </tgroup>

reference/opcache/functions/opcache-is-script-cached.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 87d6bb1bbd5f118f5b0cf0160438f06c0f91ea45 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 3c36a56c9e6875fbe3295827a15747d6eae9572e Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.opcache-is-script-cached">
  <refnamediv>
@@ -17,6 +17,8 @@
    Функция проверяет, закеширован ли указанный скрипт в OPCache.
    Может быть использована для определения, прогрет ли кеш для конкретного скрипта.
    Функция проверяет только кеш в памяти, не проверяя файловый кеш.
+   Для проверки файлового кеша используйте функцию
+   <function>opcache_is_script_cached_in_file_cache</function>.
   </simpara>
  </refsect1>
 
@@ -37,7 +39,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <simpara>
-   Возвращает &true;, если <parameter>filename</parameter> закеширован в OPCache,
+   Возвращает &true;, если <parameter>filename</parameter> закеширован в OPCache в памяти,
    &false; если нет.
   </simpara>
  </refsect1>
@@ -46,6 +48,7 @@
   &reftitle.seealso;
   <simplelist>
    <member><function>opcache_compile_file</function></member>
+   <member><function>opcache_is_script_cached_in_file_cache</function></member>
   </simplelist>
  </refsect1>
 </refentry>