svn: /phpdoc/ru/trunk/ language/control-structures/return.xml language/oop5.xml reference/mysqli/overview.xml reference/opcache/configure.xml

Modified: phpdoc/ru/trunk/language/control-structures/return.xml
===================================================================
--- phpdoc/ru/trunk/language/control-structures/return.xml	2020-11-14 01:02:51 UTC (rev 351386)
+++ phpdoc/ru/trunk/language/control-structures/return.xml	2020-11-14 06:26:02 UTC (rev 351387)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 344782 Maintainer: mch Status: ready -->
+<!-- EN-Revision: 351365 Maintainer: mch Status: ready -->
 <!-- Reviewed: yes Maintainer: lex -->
 <!-- $Revision$ -->
 <sect1 xml:id="function.return" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -53,6 +53,11 @@
    </simpara>
   </note>
  </para>
+
+ <para>
+  Начиная с PHP 7.1.0, операторы возврата без аргумента вызывают <constant>E_COMPILE_ERROR</constant>,
+  если только тип возврата не <type>void</type>, в этом случае такую же ошибку вызывают операторы возврата с аргументом.
+ </para>
 </sect1>

 <!-- Keep this comment at the end of the file

Modified: phpdoc/ru/trunk/language/oop5.xml
===================================================================
--- phpdoc/ru/trunk/language/oop5.xml	2020-11-14 01:02:51 UTC (rev 351386)
+++ phpdoc/ru/trunk/language/oop5.xml	2020-11-14 06:26:02 UTC (rev 351387)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351112 Maintainer: aur Status: ready -->
+<!-- EN-Revision: 351365 Maintainer: aur Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <chapter xml:id="language.oop5" xmlns="http://docbook.org/ns/docbook">
@@ -11,12 +11,11 @@
    PHP включает полноценную объектную модель.
    Некоторые из ее особенностей:
    <link linkend="language.oop5.visibility">видимость</link>,
-   <link linkend="language.oop5.abstract">абстрактные</link> и
+   <link linkend="language.oop5.abstract">абстрактные</link> and
    <link linkend="language.oop5.final">ненаследуемые</link> (final) классы и методы,
    а также <link linkend="language.oop5.magic">магические методы</link>,
-   <link linkend="language.oop5.interfaces">интерфейсы</link>,
-   <link linkend="language.oop5.cloning">клонирование</link> и
-   <link linkend="language.oop5.typehinting">объявление типа</link>.
+   <link linkend="language.oop5.interfaces">интерфейсы</link> и
+   <link linkend="language.oop5.cloning">клонирование</link>.
   </para>
   <para>
    PHP работает с объектами так же, как с ссылками или дескрипторами, это означает
@@ -46,7 +45,6 @@
  &language.oop5.final;
  &language.oop5.cloning;
  &language.oop5.object-comparison;
- &language.oop5.typehinting;
  &language.oop5.late-static-bindings;
  &language.oop5.references;
  &language.oop5.serialization;

Modified: phpdoc/ru/trunk/reference/mysqli/overview.xml
===================================================================
--- phpdoc/ru/trunk/reference/mysqli/overview.xml	2020-11-14 01:02:51 UTC (rev 351386)
+++ phpdoc/ru/trunk/reference/mysqli/overview.xml	2020-11-14 06:26:02 UTC (rev 351387)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351293 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 351329 Maintainer: tmn Status: ready -->
 <!-- Reviewed: yes Maintainer: lex -->
 <!-- $Revision$ -->
 <chapter xml:id="mysqli.overview" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -20,7 +20,7 @@
     методов, функций и переменных, которые можно вызывать из вашего приложения
     для выполнения поставленных задач. Применительно к PHP приложениям, которые
     должны взаимодействовать с базами данных, необходимые для этого API, как
-    правило, представлены PHP-расширениями.
+    правило, представлены PHP-модулями.
   </para>

   <para>
@@ -89,22 +89,22 @@
   </para>

   <para>
-    <emphasis role="bold">Что такое расширение?</emphasis>
+    <emphasis role="bold">Что такое модуль?</emphasis>
   </para>

   <para>
     В документации к PHP вы будете неоднократно сталкиваться с термином
-    <emphasis>расширение</emphasis>. Код PHP как такового состоит из ядра и
-    присоединенных к нему необязательных расширений, которые увеличивают круг
-    задач, которые может выполнять ядро. Относящиеся к MySQL расширения, такие
-    как <literal>mysqli</literal> и <literal>mysql</literal>, взаимодействуют с
-    ядром с помощью фреймворка PHP расширений.
+    <emphasis>модуль</emphasis>. Код PHP как такового состоит из ядра и
+    присоединенных к нему необязательных модулей, которые увеличивают круг
+    задач, которые может выполнять ядро. Относящиеся к MySQL модули, такие
+    как mysqli и драйвер PDO MySQL, взаимодействуют с
+    ядром с помощью фреймворка PHP модулей.
   </para>

   <para>
-    Обычно расширения предоставляют свой API-интерфейс PHP-программисту, чтобы
-    тот мог программно использовать возможности расширения. Однако, некоторые
-    расширения, использующие фреймворк PHP-расширений, не предоставляют
+    Обычно модули предоставляют свой API-интерфейс PHP-программисту, чтобы
+    тот мог программно использовать возможности модуля. Однако, некоторые
+    модули, использующие фреймворк PHP-модули, не предоставляют
     программистам никаких интерфейсов.
   </para>

@@ -114,7 +114,7 @@
   </para>

   <para>
-    Термины API и расширение нельзя воспринимать как синонимы, так как расширение
+    Термины API и модуль нельзя воспринимать как синонимы, так как модуль
     может и не предоставлять API программисту.
   </para>

@@ -125,7 +125,7 @@
   </para>

   <para>
-    API предоставляет на выбор три набора инструментов для подключения к серверу
+    API предоставляет на выбор два набора инструментов для подключения к серверу
     баз данных MySQL:
   </para>

@@ -133,18 +133,12 @@

     <listitem>
       <para>
-        Расширение PHP MySQL
+        Модуль PHP mysqli
       </para>
     </listitem>

     <listitem>
       <para>
-        Расширение PHP mysqli
-      </para>
-    </listitem>
-
-    <listitem>
-      <para>
         Объекты данных PHP (PDO)
       </para>
     </listitem>
@@ -157,37 +151,6 @@
   </para>

   <para>
-    <emphasis role="bold">Что такое расширение PHP MySQL?</emphasis>
-  </para>
-
-  <para>
-    Это оригинальное расширение позволяет разрабатывать PHP-приложения, которые
-    могут взаимодействовать с базой данных MySQL. Расширение
-    <literal>mysql</literal> предоставляет процедурный интерфейс и предназначено
-    для использования с MySQL версии 4.1.3 или более ранними версиями. Его также можно использовать
-    и с более свежими версиями СУБД, но в этом случае многие возможности сервера,
-    появившиеся после версии 4.1.3, будут недоступны программисту.
-  </para>
-
-  <note>
-    <para>
-      Если вы работаете с сервером MySQL 4.1.3 или более поздних версий,
-      <emphasis>настоятельно</emphasis> рекомендуется использовать
-      расширение <literal>mysqli</literal>.
-    </para>
-  </note>
-
-  <para>
-    Исходные коды расширения <literal>mysql</literal> расположены в директории
-    расширений PHP <filename>ext/mysql</filename>.
-  </para>
-
-  <para>
-    Дополнительную информацию о расширении <literal>mysql</literal> можно
-    почерпнуть из ресурса <xref linkend="book.mysql"/>.
-  </para>
-
-  <para>
     <emphasis role="bold">
      Что такое PHP-модуль mysqli?
     </emphasis>
@@ -240,26 +203,19 @@
     </itemizedlist>
   </para>

-  <note>
-    <para>
-      При работе с MySQL версий 4.1.3 и выше <emphasis>настоятельно</emphasis>
-      рекомендуется использовать именно это расширение.
-    </para>
-  </note>
-
   <para>
-    Наравне с объектно-ориентированным расширение предоставляет и процедурный
+    Наравне с объектно-ориентированным интерфейсом модуль предоставляет и процедурный
     интерфейс.
   </para>

   <para>
-    Расширение <literal>mysqli</literal> собирается при помощи фреймворка
-    расширений PHP, его исходный код расположен в директории
+    модуль <literal>mysqli</literal> собирается при помощи фреймворка
+    модулей PHP, его исходный код расположен в директории
     <filename>ext/mysqli</filename>.
   </para>

   <para>
-    За дополнительной информацией о расширении <literal>mysqli</literal>,
+    За дополнительной информацией о модуле <literal>mysqli</literal>,
     обращайтесь к разделу <xref linkend="book.mysqli"/>.
   </para>

@@ -288,7 +244,7 @@
   </para>

   <para>
-    PDO собирается при помощи фреймворка расширений PHP, его исходный код
+    PDO собирается при помощи фреймворка модулей PHP, его исходный код
     расположен в директории <filename>ext/pdo</filename>.
   </para>

@@ -314,7 +270,7 @@
   </para>

   <para>
-    Драйвер PDO MYSQL собирается при помощи фреймворка расширений PHP, его исходный код
+    Драйвер PDO MYSQL собирается при помощи фреймворка модулей PHP, его исходный код
     расположен в директории <filename>ext/pdo_mysql</filename>. Он не предоставляет
     API-интерфейс программисту PHP.
   </para>
@@ -329,8 +285,8 @@
   </para>

   <para>
-    Чтобы обеспечить взаимодействие с сервером MySQL, расширения
-    <literal>mysql</literal> и <literal>mysqli</literal>, а также драйвер
+    Чтобы обеспечить взаимодействие с сервером MySQL, модуль
+    <literal>mysqli</literal> и драйвер
     PDO MYSQL используют низкоуровневую библиотеку, в которой реализованы
     необходимые протоколы. В прошлом была доступна только одна такая библиотека:
     Клиентская библиотека MySQL (MySQL Client Library), также известная как
@@ -347,8 +303,7 @@
   </para>

   <para>
-    Каждое из расширений <literal>mysql</literal> или
-    <literal>mysqli</literal>, а также драйвер PDO MySQL можно индивидуально
+    И модуль <literal>mysqli</literal> и драйвер PDO MySQL можно индивидуально
     настроить для работы либо с <literal>libmysqlclient</literal>, либо с
     <literal>mysqlnd</literal>. Так как <literal>mysqlnd</literal> создавался
     специально для PHP-систем, у него есть преимущество в скорости и расходах
@@ -356,15 +311,8 @@
     предпочтительней.
   </para>

-  <note>
-    <para>
-      Нативный драйвер MySQL может использоваться только с MySQL версии 4.1.3 и
-      выше.
-    </para>
-  </note>
-
   <para>
-    Нативный драйвер MYSQL собирается при помощи фреймворка расширений PHP, его
+    Нативный драйвер MYSQL собирается при помощи фреймворка модулей PHP, его
     исходный код расположен в директории <filename>ext/mysqlnd</filename>. Он
     не предоставляет API-интерфейс программисту PHP.
   </para>
@@ -381,23 +329,21 @@
   </para>

   <para>
-    В приведенной таблице приводится сравнение функционала трех основных методов
+    В приведенной таблице приводится сравнение функционала основных методов
     подключения к MySQL из PHP:
   </para>

   <table>
    <title>Сравнение опций MySQL API в PHP</title>
-    <tgroup cols="4">
-      <colspec colwidth="25*"/>
-      <colspec colwidth="25*"/>
-      <colspec colwidth="25*"/>
-      <colspec colwidth="25*"/>
+    <tgroup cols="3">
+      <colspec colwidth="34*"/>
+      <colspec colwidth="33*"/>
+      <colspec colwidth="33*"/>
       <thead>
         <row>
           <entry></entry>
-          <entry>Расширение PHP mysqli</entry>
+          <entry>Модуль PHP mysqli</entry>
           <entry>PDO (используя драйвер PDO MySQL и нативный драйвер MySQL)</entry>
-          <entry>Расширение PHP MySQL</entry>
         </row>
       </thead>
       <tbody>
@@ -405,61 +351,41 @@
           <entry>Версия PHP, в которой был внедрен функционал</entry>
           <entry>5.0</entry>
           <entry>5.0</entry>
-          <entry>До 3.0</entry>
         </row>
         <row>
-          <entry>Включено в PHP 5.x</entry>
-          <entry>Да</entry>
-          <entry>Да</entry>
-          <entry>Да</entry>
-        </row>
-        <row>
           <entry>Статус разработки MySQL</entry>
           <entry>Разработка продолжается</entry>
-          <entry>Разработка продолжается по состоянию на PHP 5.3</entry>
-          <entry>Только поддержка</entry>
+          <entry>Разработка продолжается</entry>
         </row>
         <row>
-          <entry>Рекомендовано MySQL для разработки новых проектов</entry>
-          <entry>Да - отдается предпочтение</entry>
-          <entry>Да</entry>
-          <entry>Нет</entry>
-        </row>
-        <row>
           <entry>API поддерживает наборы символов</entry>
           <entry>Да</entry>
           <entry>Да</entry>
-          <entry>Нет</entry>
         </row>
         <row>
           <entry>API поддерживает подготавливаемые запросы на стороне сервера</entry>
           <entry>Да</entry>
           <entry>Да</entry>
-          <entry>Нет</entry>
         </row>
         <row>
           <entry>API поддерживает подготавливаемые запросы на стороне клиента</entry>
           <entry>Нет</entry>
           <entry>Да</entry>
-          <entry>Нет</entry>
         </row>
         <row>
           <entry>API поддерживает хранимые процедуры</entry>
           <entry>Да</entry>
           <entry>Да</entry>
-          <entry>Нет</entry>
         </row>
         <row>
           <entry>API поддерживает множественные запросы</entry>
           <entry>Да</entry>
           <entry>По большей части</entry>
-          <entry>Нет</entry>
         </row>
         <row>
           <entry>Поддержка всего функционала MySQL 4.1+</entry>
           <entry>Да</entry>
           <entry>По большей части</entry>
-          <entry>Нет</entry>
         </row>
       </tbody>
     </tgroup>

Modified: phpdoc/ru/trunk/reference/opcache/configure.xml
===================================================================
--- phpdoc/ru/trunk/reference/opcache/configure.xml	2020-11-14 01:02:51 UTC (rev 351386)
+++ phpdoc/ru/trunk/reference/opcache/configure.xml	2020-11-14 06:26:02 UTC (rev 351387)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 350081 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351292 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes Maintainer: lex -->

 <sect1 xml:id="opcache.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -7,10 +7,20 @@
  &reftitle.install;

  <para>
-  Процесс установки OPcache отличается для разных версий PHP.
-  Смотрите соответствующие разделы ниже.
+  OPcache можно собирать только как разделяемое расширение. Если вы запретили
+  сборку расширений по умолчанию с помощью
+  <option role="configure">--disable-all</option>, то вам будет необходимо компилировать
+  PHP с ключом <option role="configure">--enable-opcache</option> для включения OPcache.
  </para>

+ <para>
+  Единожды скомпилировав, вы можете использовать директиву конфигурации
+  <link linkend="ini.zend-extension">zend_extension</link> для загрузки
+  OPcache в PHP. Это можно сделать с помощью
+  <literal>zend_extension=/full/path/to/opcache.so</literal> для платформ, отличных от Windows,
+  и <literal>zend_extension=C:\path\to\php_opcache.dll</literal> в Windows.
+ </para>
+
  <note>
   <para>
    Если вы хотите использовать OPcache с <link xlink:href="&url.xdebug;">Xdebug</link>,
@@ -18,42 +28,6 @@
   </para>
  </note>

- <sect2 xml:id="opcache.installation.bundled">
-  <title>PHP 5.5.0 и выше</title>
-
-  <para>
-   OPcache можно собирать только как разделяемое расширение. Если вы запретили
-   сборку расширений по умолчанию с помощью
-   <option role="configure">--disable-all</option>, то вам будет необходимо компилировать
-   PHP с ключом <option role="configure">--enable-opcache</option> для включения OPcache.
-  </para>
-
-  <para>
-   Единожды скомпилировав, вы можете использовать директиву конфигурации
-   <link linkend="ini.zend-extension">zend_extension</link> для загрузки
-   OPcache в PHP. Это можно сделать с помощью
-   <literal>zend_extension=/full/path/to/opcache.so</literal> для платформ, отличных от Windows,
-   и <literal>zend_extension=C:\path\to\php_opcache.dll</literal> в Windows.
-  </para>
- </sect2>
-
- <sect2 xml:id="opcache.installation.pecl">
-  <title>PHP 5.2, 5.3 и 5.4</title>
-
-  <para>
-   &pecl.moved;
-  </para>
-
-  <para>
-   &pecl.info;
-   <link xlink:href="&url.pecl.package;ZendOpcache">&url.pecl.package;ZendOpcache</link>.
-  </para>
-
-  <para>
-   &pecl.windows.download;
-  </para>
- </sect2>
-
  <sect2 xml:id="opcache.installation.recommended">
   <title>Рекомендованые настройки php.ini</title>