svn: /phpdoc/ru/trunk/reference/ mysqli/mysqli/init.xml mysqli/mysqli/refresh.xml mysqli/quickstart.xml mysqli/summary.xml pcre/configure.xml strings/constants.xml

[email protected] (Sergey Panteleev) Thu, 12 Nov 2020 06:27:14 +0000
Newsgroups php.doc.ru
Message-ID <[email protected]>
sergey                                   Thu, 12 Nov 2020 06:27:14 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=351362

Log:
docs(ru): Updated to English revision

Changed paths:
    U   phpdoc/ru/trunk/reference/mysqli/mysqli/init.xml
    U   phpdoc/ru/trunk/reference/mysqli/mysqli/refresh.xml
    U   phpdoc/ru/trunk/reference/mysqli/quickstart.xml
    U   phpdoc/ru/trunk/reference/mysqli/summary.xml
    U   phpdoc/ru/trunk/reference/pcre/configure.xml
    U   phpdoc/ru/trunk/reference/strings/constants.xml
svn-diffs-351362.txt (text/x-diff, 15.3 KB)
Modified: phpdoc/ru/trunk/reference/mysqli/mysqli/init.xml
===================================================================
--- phpdoc/ru/trunk/reference/mysqli/mysqli/init.xml	2020-11-11 23:33:49 UTC (rev 351361)
+++ phpdoc/ru/trunk/reference/mysqli/mysqli/init.xml	2020-11-12 06:27:14 UTC (rev 351362)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 350059 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 351331 Maintainer: tmn Status: ready -->
 <!-- Reviewed: yes Maintainer: lex -->
 <!-- $Revision$ -->
 <refentry xml:id="mysqli.init" xmlns="http://docbook.org/ns/docbook">
@@ -7,7 +7,7 @@
   <refname>mysqli::init</refname>
   <refname>mysqli_init</refname>
   <refpurpose>
-   Инициализирует MySQLi и возвращает ресурс для использования в функции
+   Инициализирует MySQLi и возвращает объект для использования в функции
    mysqli_real_connect()
   </refpurpose>
  </refnamediv>
@@ -48,7 +48,7 @@
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
-   См. <function>mysqli_real_connect</function>.
+   Смотрите <function>mysqli_real_connect</function>.
   </para>
  </refsect1>


Modified: phpdoc/ru/trunk/reference/mysqli/mysqli/refresh.xml
===================================================================
--- phpdoc/ru/trunk/reference/mysqli/mysqli/refresh.xml	2020-11-11 23:33:49 UTC (rev 351361)
+++ phpdoc/ru/trunk/reference/mysqli/mysqli/refresh.xml	2020-11-12 06:27:14 UTC (rev 351362)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 343898 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 351331 Maintainer: tmn Status: ready -->
 <!-- Reviewed: yes Maintainer: lex -->
 <!-- $Revision$ -->
 <refentry xml:id="mysqli.refresh" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -19,7 +19,7 @@
   <para>&style.procedural;</para>
   <methodsynopsis>
    <type>bool</type><methodname>mysqli_refresh</methodname>
-   <methodparam><type>resource</type><parameter>link</parameter></methodparam>
+   <methodparam><type>mysqli</type><parameter>link</parameter></methodparam>
    <methodparam><type>int</type><parameter>options</parameter></methodparam>
   </methodsynopsis>
   <para>

Modified: phpdoc/ru/trunk/reference/mysqli/quickstart.xml
===================================================================
--- phpdoc/ru/trunk/reference/mysqli/quickstart.xml	2020-11-11 23:33:49 UTC (rev 351361)
+++ phpdoc/ru/trunk/reference/mysqli/quickstart.xml	2020-11-12 06:27:14 UTC (rev 351362)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 347820 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 351328 Maintainer: tmn Status: ready -->
 <!-- Reviewed: yes Maintainer: lex -->
 <!-- $Revision$ -->
 <chapter xml:id="mysqli.quickstart" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -1649,27 +1649,24 @@
   </para>
   <para>
    Транзакциями можно управлять как средствами SQL, так и вызовами API-функций.
-   Для включения и выключения режима автофиксации изменений рекомендуется
+   Для включения и выключения режима автофиксации изменений (<literal>autocommit</literal>) рекомендуется
    пользоваться API функциями.
   </para>
   <para>
    <example>
-    <title>Установка режима автофиксации средствами SQL и функциями API</title>
+    <title>Установка режима автофиксации (<literal>autocommit</literal>) средствами SQL и функциями API</title>
     <programlisting role="php">
 <![CDATA[
 <?php
+mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
 $mysqli = new mysqli("example.com", "user", "password", "database");
-if ($mysqli->connect_errno) {
-    echo "Не удалось подключиться к MySQL: (" . $mysqli->connect_errno . ") " . $mysqli->connect_error;
-}

+
 /* Рекомендуется управлять настройками транзакций средствами API */
 $mysqli->autocommit(false);

 /* Не будет распознаваться и учитываться плагинами репликации и балансировки нагрузки */
-if (!$mysqli->query('SET AUTOCOMMIT = 0')) {
-    echo "Не удалось выполнить запрос: (" . $mysqli->errno . ") " . $mysqli->error;
-}
+$mysqli->query('SET AUTOCOMMIT = 0');
 ?>
 ]]>
     </programlisting>
@@ -1680,7 +1677,7 @@
    нагрузки, могут отслеживать вызовы API-функций. Плагин репликации может
    сообщать балансировщику нагрузки о запущенной транзакции, если эта транзакция
    обслуживается API-функциями. Сервер не сможет распределять нагрузку между
-   репликами базы, если смена режима автофиксации, фиксация и откат транзакций
+   репликами базы, если смена режима автофиксации (<literal>autocommit</literal>), фиксация и откат транзакций
    осуществляются SQL-запросами.
   </para>
   <para>
@@ -1689,6 +1686,7 @@
     <programlisting role="php">
 <![CDATA[
 <?php
+mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
 $mysqli = new mysqli("example.com", "user", "password", "database");
 $mysqli->autocommit(false);

@@ -1697,7 +1695,6 @@

 $mysqli->query("INSERT INTO test(id) VALUES (2)");
 $mysqli->commit();
-?>
 ]]>
     </programlisting>
    </example>
@@ -1712,8 +1709,9 @@
   <para>
    <simplelist>
     <member><methodname>mysqli::autocommit</methodname></member>
-    <member><methodname>mysqli_result::commit</methodname></member>
-    <member><methodname>mysqli_result::rollback</methodname></member>
+    <member><methodname>mysqli::begin_transaction</methodname></member>
+    <member><methodname>mysqli::commit</methodname></member>
+    <member><methodname>mysqli::rollback</methodname></member>
    </simplelist>
   </para>
  </section>

Modified: phpdoc/ru/trunk/reference/mysqli/summary.xml
===================================================================
--- phpdoc/ru/trunk/reference/mysqli/summary.xml	2020-11-11 23:33:49 UTC (rev 351361)
+++ phpdoc/ru/trunk/reference/mysqli/summary.xml	2020-11-12 06:27:14 UTC (rev 351362)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351218 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351331 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <chapter xml:id="mysqli.summary" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -214,7 +214,7 @@
      <entry><function>mysqli_init</function></entry>
      <entry>-</entry>
      <entry>Инициализирует MySQLi и возвращает ресурс для использования с
-      mysqli_real_connect. [Не вызывается из объекта, так как возвращает объект $mysqli.]</entry>
+      mysqli_real_connect.</entry>
     </row>
     <row>
      <entry><methodname>mysqli::kill</methodname></entry>

Modified: phpdoc/ru/trunk/reference/pcre/configure.xml
===================================================================
--- phpdoc/ru/trunk/reference/pcre/configure.xml	2020-11-11 23:33:49 UTC (rev 351361)
+++ phpdoc/ru/trunk/reference/pcre/configure.xml	2020-11-12 06:27:14 UTC (rev 351362)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 346442 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351360 Maintainer: shein Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <section xml:id="pcre.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -10,21 +10,15 @@
   Также можно использовать внешнюю PCRE-библиотеку, указав при сборке
   параметр <option role="configure">--with-pcre-regex=DIR</option>, где
   <literal>DIR</literal> указывает на директорию с библиотеками и
-  подключаемыми файлами PCRE. Для PHP 5.6 и 7.0 рекомендуется использовать
-  PCRE 8.10 и выше.
+  подключаемыми файлами PCRE. Рекомендуется использовать PCRE 8.10 и выше;
+  с PHP 7.3.0 требуется PCRE2.
  </para>
  <para>
-  Начиная с PHP 7.0.0, по умолчанию поддерживается JIT-компиляция PCRE. Ее можно
+  По умолчанию поддерживается JIT-компиляция PCRE. Ее можно
   отключить с помощью опции <option role="configure">--without-pcre-jit</option>
   начиная с PHP 7.0.12.
  </para>
  &windows.builtin;
- <note>
-  <para>
-   До версии PHP 5.3.0, это расширение можно было отключить при сборке,
-   передав опцию <option role="configure">--without-pcre-regex</option>.
-  </para>
- </note>
  <para>
   PCRE - активный проект и по мере того как он меняется, меняется и
   функционал PHP, который полагается на него. Возможно, некоторые
@@ -47,120 +41,40 @@
     </thead>
     <tbody>
      <row>
-      <entry>7.3.0</entry>
-      <entry>10.32</entry>
+      <entry>7.4.12, 8.0.0</entry>
+      <entry>10.35</entry>
       <entry></entry>
      </row>
      <row>
-      <entry>7.2.0</entry>
-      <entry>8.41</entry>
+      <entry>7.4.6</entry>
+      <entry>10.34</entry>
       <entry></entry>
      </row>
      <row>
-      <entry>7.0.3 / 5.6.18 / 5.5.32</entry>
-      <entry>8.38</entry>
-      <entry>See CVE-2015-8383, CVE-2015-8386, CVE-2015-8387, CVE-2015-8389, CVE-2015-8390, CVE-2015-8391, CVE-2015-8393, CVE-2015-8394</entry>
-     </row>
-     <row>
-      <entry>7.0.0 / 5.6.9 / 5.5.26 / 5.4.41</entry>
-      <entry>8.37</entry>
-      <entry>See CVE-2015-2325, CVE-2015-2326</entry>
-     </row>
-     <row>
-      <entry>5.6.0 / 5.5.10</entry>
-      <entry>8.34</entry>
+      <entry>7.4.0</entry>
+      <entry>10.33</entry>
       <entry></entry>
      </row>
      <row>
-      <entry>5.5.0 / 5.4.14 / 5.3.24</entry>
-      <entry>8.32</entry>
+      <entry>7.3.0</entry>
+      <entry>10.32</entry>
       <entry></entry>
      </row>
      <row>
-      <entry>5.4.9 / 5.3.19</entry>
-      <entry>8.31</entry>
+      <entry>7.2.0</entry>
+      <entry>8.41</entry>
       <entry></entry>
      </row>
      <row>
-      <entry>5.3.7</entry>
-      <entry>8.12</entry>
-      <entry></entry>
+      <entry>7.0.3</entry>
+      <entry>8.38</entry>
+      <entry>Смотрите CVE-2015-8383, CVE-2015-8386, CVE-2015-8387, CVE-2015-8389, CVE-2015-8390, CVE-2015-8391, CVE-2015-8393, CVE-2015-8394</entry>
      </row>
      <row>
-      <entry>5.3.6</entry>
-      <entry>8.11</entry>
-      <entry></entry>
+      <entry>7.0.0</entry>
+      <entry>8.37</entry>
+      <entry>Смотрите CVE-2015-2325, CVE-2015-2326</entry>
      </row>
-     <row>
-      <entry>5.3.4</entry>
-      <entry>8.10</entry>
-      <entry></entry>
-     </row>
-     <row>
-      <entry>5.3.3 / 5.2.14</entry>
-      <entry>8.02</entry>
-      <entry></entry>
-     </row>
-     <row>
-      <entry>5.3.2</entry>
-      <entry>8.00</entry>
-      <entry></entry>
-     </row>
-     <row>
-      <entry>5.3.0 / 5.2.13</entry>
-      <entry>7.9</entry>
-      <entry></entry>
-     </row>
-     <row>
-      <entry>5.2.7</entry>
-      <entry>7.8</entry>
-      <entry></entry>
-     </row>
-     <row>
-      <entry>5.2.6</entry>
-      <entry>7.6</entry>
-      <entry></entry>
-     </row>
-     <row>
-      <entry>5.2.5</entry>
-      <entry>7.3</entry>
-      <entry></entry>
-     </row>
-     <row>
-      <entry>5.2.4</entry>
-      <entry>7.2</entry>
-      <entry></entry>
-     </row>
-     <row>
-      <entry>5.2.2</entry>
-      <entry>7.0</entry>
-      <entry></entry>
-     </row>
-     <row>
-      <entry>5.2.0</entry>
-      <entry>6.7</entry>
-      <entry></entry>
-     </row>
-     <row>
-      <entry>5.1.3</entry>
-      <entry>6.6</entry>
-      <entry></entry>
-     </row>
-     <row>
-      <entry>5.1.0</entry>
-      <entry>6.2</entry>
-      <entry></entry>
-     </row>
-     <row>
-      <entry>5.0.5</entry>
-      <entry>5.0</entry>
-      <entry></entry>
-     </row>
-     <row>
-      <entry>5.0.0</entry>
-      <entry>4.5</entry>
-      <entry></entry>
-     </row>
     </tbody>
    </tgroup>
   </table>

Modified: phpdoc/ru/trunk/reference/strings/constants.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/constants.xml	2020-11-11 23:33:49 UTC (rev 351361)
+++ phpdoc/ru/trunk/reference/strings/constants.xml	2020-11-12 06:27:14 UTC (rev 351362)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351133 Maintainer: shein Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 351278 Maintainer: shein Status: ready -->
+<!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <appendix xml:id="string.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
@@ -24,7 +24,7 @@
    </term>
    <listitem>
     <simpara>
-
+     Указывает, поддерживаются ли стандартные хеши на основе DES в <function>crypt</function>. Всегда <literal>1</literal>.
     </simpara>
    </listitem>
   </varlistentry>
@@ -35,7 +35,7 @@
    </term>
    <listitem>
     <simpara>
-
+     Указывает, поддерживаются ли расширенные хеши на основе DES в <function>crypt</function>. Всегда <literal>1</literal>.
     </simpara>
    </listitem>
   </varlistentry>
@@ -46,7 +46,7 @@
    </term>
    <listitem>
     <simpara>
-
+     Указывает, поддерживаются ли хеши MD5 в <function>crypt</function>. Всегда <literal>1</literal>.
     </simpara>
    </listitem>
   </varlistentry>
@@ -57,10 +57,32 @@
    </term>
    <listitem>
     <simpara>
-
+     Указывает, поддерживаются ли хеши Blowfish в <function>crypt</function>. Всегда <literal>1</literal>.
     </simpara>
    </listitem>
   </varlistentry>
+  <varlistentry xml:id="constant.crypt-sha256">
+   <term>
+    <constant>CRYPT_SHA256</constant>
+     <type>int</type>
+   </term>
+   <listitem>
+    <simpara>
+     Указывает, поддерживаются ли хеши SHA-256 в <function>crypt</function>. Всегда <literal>1</literal>.
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.crypt-sha512">
+   <term>
+    <constant>CRYPT_SHA512</constant>
+     <type>int</type>
+   </term>
+   <listitem>
+    <simpara>
+     Указывает, поддерживаются ли хеши SHA-512 в <function>crypt</function>. Всегда <literal>1</literal>.
+    </simpara>
+   </listitem>
+  </varlistentry>
    <varlistentry xml:id="constant.html-specialchars">
    <term>
     <constant>HTML_SPECIALCHARS</constant>