Upd

git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@346837 c90b9560-bf6c-de11-be94-00142212c4b1
2025-08-20 23:31:15 +00:00 · 2019-02-15 05:03:41 +00:00
parent 0630e23bfc
commit a2851ace7b
12 changed files with 53 additions and 74 deletions
--- a/language-snippets.ent
+++ b/language-snippets.ent
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7604e7eadc43cd081c675f37e640636e96c3d0b3 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 58cde0c5caa70bc184760f24e99976784d64a891 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->

@ -147,6 +147,15 @@ xmlns="http://docbook.org/ns/docbook"><simpara>Данный функционал
 xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция объявлена
 <emphasis>УСТАРЕВШЕЙ</emphasis>, начиная с PHP 7.3.0 и ее использование крайне не рекомендовано.</simpara></warning>'>

+<!ENTITY warn.deprecated.feature-7-4-0 '<warning
+xmlns="http://docbook.org/ns/docbook"><simpara>Данный функционал объявлен
+<emphasis>УСТАРЕВШИМ</emphasis>, начиная с PHP 7.4.0 и его использование крайне не рекомендовано.</simpara></warning>'>
+
+<!ENTITY warn.deprecated.function-7-4-0 '<warning
+xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция объявлена
+<emphasis>УСТАРЕВШИМ</emphasis>, начиная с PHP 7.4.0 и ее использование крайне не рекомендовано.</simpara></warning>'>
+
+
 <!ENTITY removed.php.future 'Эта возможность устарела и <emphasis xmlns="http://docbook.org/ns/docbook">будет</emphasis>
 обязательно <emphasis xmlns="http://docbook.org/ns/docbook">удалена</emphasis> в будущем.'>

--- a/language/oop5/basic.xml
+++ b/language/oop5/basic.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 0fe00e3574f5267948a29692e8daddaaeb275cee Maintainer: irker Status: ready -->
+<!-- EN-Revision: cb1c93099e011d50a56398f569b0440239148435 Maintainer: irker Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->

@ -139,6 +139,14 @@ $this не определена.
   содержащая имя класса, то будет создан новый экземпляр этого класса. Если
   имя находится в пространстве имен, то оно должно быть задано полностью.
  </para>
+  
+   <note>
+    <para>
+     В случае отсутствия аргументов в конструктор класса,
+     круглые скобки после названия класса можно опустить.
+    </para>
+   </note>
+  
  <example>
   <title>Создание экземпляра класса</title>
   <programlisting role="php">
--- a/language/oop5/interfaces.xml
+++ b/language/oop5/interfaces.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f559b71c79f2900e194307968af5fcb2ad33b4cb Maintainer: shein Status: ready -->
+<!-- EN-Revision: 51fc161bc0720a506ca040c8e549bfe197824c11 Maintainer: shein Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <sect1 xml:id="language.oop5.interfaces" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@ -47,8 +47,8 @@
  </note>
  <note>
   <para>    
-    Объявления методов в классе, реализующем интерфейс,
-    должны точно совпадать с объявлениями, используемыми в интерфейсе,
+    Объявления методов в классе, реализующем интерфейс, должны быть совместимы
+    с принципом подстановки Барбары Лисков (Liskov Substitution Principle, LSP),
    в противном случае будет вызвана фатальная ошибка.
   </para>
  </note>
--- a/reference/com/functions/com-load-typelib.xml
+++ b/reference/com/functions/com-load-typelib.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 6f66c3a11dd15b98f77efc06d9246418e7ef43f5 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <!-- $Revision$ -->
 <refentry xml:id='function.com-load-typelib' xmlns="http://docbook.org/ns/docbook">
@ -12,7 +12,7 @@
  <methodsynopsis>
   <type>bool</type><methodname>com_load_typelib</methodname>
   <methodparam><type>string</type><parameter>typelib_name</parameter></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>case_insensitive</parameter><initializer>&true;</initializer></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>case_sensitive</parameter><initializer>&true;</initializer></methodparam>
  </methodsynopsis>
  <para>
   Загружает библиотеку типов и регистрирует ее константы таким образом,
@ -68,11 +68,11 @@
     </listitem>
    </varlistentry>
    <varlistentry>
-     <term><parameter>case_insensitive</parameter></term>
+     <term><parameter>case_sensitive</parameter></term>
     <listitem>
      <para>
-       <parameter>case_insensitive</parameter> ведет себя так же, как параметр с тем 
-       же именем в функции <function>define</function>.
+       <parameter>case_sensitive</parameter> ведет себя противоположно параметру
+       <literal>$case_insensitive</literal> в функции <function>define</function>.
      </para>
     </listitem>
    </varlistentry>
--- a/reference/dom/domnode.xml
+++ b/reference/dom/domnode.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: db3bfdd46e24a0711b55d5725ac560b82288fce2 Maintainer: aur Status: ready -->
+<!-- EN-Revision: 8151a0863b9579ff683f58912699543bdf5f9bd2 Maintainer: aur Status: ready -->
 <!-- Reviewed: yes Maintainer: rjhdby -->
 <!-- $Revision$ -->
 <phpdoc:classref xmlns:phpdoc="http://php.net/ns/phpdoc" xml:id="class.domnode" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
@ -222,7 +222,7 @@
    <varlistentry xml:id="domnode.props.ownerdocument">
     <term><varname>ownerDocument</varname></term>
     <listitem>
-      <para>Объект <classname>DOMDocument</classname>, связанный с этим узлом.</para>
+      <para>Объект <classname>DOMDocument</classname>, связанный с этим узлом, либо &null;, если узел является <classname>DOMDOcument</classname>.</para>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="domnode.props.namespaceuri">
--- a/reference/filesystem/constants.xml
+++ b/reference/filesystem/constants.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 071cf3fdaddb8e6bd8f4db4e5e45735f2846d450 Maintainer: shein Status: ready -->
+<!-- EN-Revision: c2d5a4459e700e8495ec0ec5e9f98db17f2b87f1 Maintainer: shein Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <appendix xml:id="filesystem.constants" xmlns="http://docbook.org/ns/docbook">
@ -212,7 +212,7 @@
   <listitem>
    <simpara>
     Ищет <parameter>filename</parameter> в
-     <link linkend="ini.include-path">include_path</link> (начиная с PHP 5).
+     <link linkend="ini.include-path">include_path</link>.
    </simpara>
   </listitem>
  </varlistentry>
@ -244,7 +244,7 @@
   </term>
   <listitem>
    <simpara>
-     Вырезаются концы строк (EOL) (начиная с PHP 5).
+     Вырезаются концы строк (EOL).
    </simpara>
   </listitem>
  </varlistentry>
@ -255,7 +255,7 @@
   </term>
   <listitem>
    <simpara>
-     Пропускаются пустые строки (начиная с PHP 5).
+     Пропускаются пустые строки.
    </simpara>
   </listitem>
  </varlistentry>
--- a/reference/ldap/functions/ldap-mod-del.xml
+++ b/reference/ldap/functions/ldap-mod-del.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: bd8f8383a35547d9b19cbe75c05240e6a1ce6142 Maintainer: mch Status: ready -->
+<!-- EN-Revision: 82b76ae4925548555a9be228e58232b12a69eedc Maintainer: mch Status: ready -->
 <!-- Reviewed: yes Maintainer: lex -->
 <!-- $Revision$ -->

@ -63,6 +63,13 @@
  </para>
 </refsect1>
 
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.success;
+  </para>
+ </refsect1>
+ 
 <refsect1 role="changelog">
  &reftitle.changelog;
  <para>
@ -87,13 +94,6 @@
  </para>
 </refsect1>
 
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-   &return.success;
-  </para>
- </refsect1>
- 
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
--- a/reference/reflection/reflectiongenerator/gettrace.xml
+++ b/reference/reflection/reflectiongenerator/gettrace.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: e8d98d6a566aa57ab1926126ee2b2a333ee758e7 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 481248b3a19c4115e3e1dc41e554bef330a97fa9 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes Maintainer: lex -->
 <!-- $Revision$ -->
 <refentry xml:id="reflectiongenerator.gettrace" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@ -27,7 +27,7 @@
     <term><parameter>options</parameter></term>
     <listitem>
      <para>
-       Значение <parameter>options</parameter> может быть одним из следующих:
+       Значение <parameter>options</parameter> может быть одним из следующих флагов:
      </para>
      <para>
       <table>
--- a/reference/reflection/reflectionparameter/gettype.xml
+++ b/reference/reflection/reflectionparameter/gettype.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: e8d98d6a566aa57ab1926126ee2b2a333ee758e7 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 828daf218f5b424c35d513b1e7205cae2f098dc1 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes Maintainer: lex -->
 <!-- $Revision$ -->
 <refentry xml:id="reflectionparameter.gettype" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@ -11,7 +11,7 @@
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
-   <modifier>public</modifier> <type>ReflectionType</type><methodname>ReflectionParameter::getType</methodname>
+<modifier>public</modifier> <type>ReflectionNamedType</type><methodname>ReflectionParameter::getType</methodname>
   <void />
  </methodsynopsis>
  <para>
@ -27,7 +27,7 @@
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
-   Возвращает объект <classname>ReflectionType</classname>, если тип параметра задан,
+   Возвращает объект <classname>ReflectionNamedType</classname>, если тип параметра задан,
   &null;, в противном случае.
  </para>
 </refsect1>
@ -67,7 +67,7 @@ null
  <para>
   <simplelist>
    <member><methodname>ReflectionParameter::hasType</methodname></member>
-    <member><methodname>ReflectionType::__toString</methodname></member>
+    <member><methodname>ReflectionNamedType::__toString</methodname></member>
   </simplelist>
  </para>
 </refsect1>
--- a/reference/runkit/functions/runkit-method-add.xml
+++ b/reference/runkit/functions/runkit-method-add.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 5a389c052c1ef97601b17f6dfa7f6d3f9d97a156 Maintainer: mch Status: ready -->
+<!-- EN-Revision: 0f39ff7d2bf4f5cf1037883dc58f33df251f3f73 Maintainer: mch Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <refentry xml:id="function.runkit-method-add" xmlns="http://docbook.org/ns/docbook">
@ -82,12 +82,6 @@
       <constant>RUNKIT_ACC_PRIVATE</constant> опционально в комбинации через побитовое ИЛИ с
       <constant>RUNKIT_ACC_STATIC</constant> (начиная с версии 1.0.1)
      </para>
-      <note>
-       <para>
-        Этот параметр используется только в PHP 5, потому что в предыдущих
-        версиях все методы являлись публичными.
-       </para>
-      </note>
     </listitem>
    </varlistentry>
    <varlistentry>
--- a/reference/strings/functions/echo.xml
+++ b/reference/strings/functions/echo.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 3d974bf87ef32d933ca1d40828711a8da4b594f1 Maintainer: shein Status: ready -->
+<!-- EN-Revision: ad34011f878d2914d1482e66b510c8a96873d2dd Maintainer: shein Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.echo">
@ -85,51 +85,19 @@
 <?php
 echo "Привет мир!";

-echo "Это займет
-несколько строк. Переводы строки тоже
-выводятся";
-
-echo "Это займет\nнесколько строк. Переводы строки тоже\nвыводятся";
-
-echo "Экранирование символов делается \"Так\".";
-
-// с echo можно использовать переменные ...
-$foo = "foobar";
-$bar = "barbaz";
-
-echo "foo - это $foo"; // foo - это foobar
-
-// ... и массивы
-$baz = array("value" => "foo");
-
-echo "это {$baz['value']} !"; // это foo !
-
-// При использовании одиночных кавычек выводится имя переменной, а не значение
-echo 'foo - это $foo'; // foo - это $foo
-
-// Если вы не используете другие символы, можно вывести просто значения переменных
-echo $foo;          // foobar
-echo $foo,$bar;     // foobarbarbaz
-
 // Вместо конкатенации можно предать список аргументов, которые будут объединены
 // в одну строку и обработаны как один аргумент
 echo 'Эта ', 'строка ', 'была ', 'создана ', 'несколькими параметрами.', chr(10);
 echo 'Эта ' . 'строка ' . 'была ' . 'создана ' . 'с помощью конкатенации.' . "\n";

-echo <<<END
-Здесь используется синтаксис "here document" для вывода
-нескольких строк с подстановкой переменных $variable.
-Заметьте, что закрывающий идентификатор должен
-располагаться в отдельной строке. никаких пробелов!
-END;
-
 // Следующая строка неверна, так как echo не является функцией
 ($some_var) ? echo 'true' : echo 'false';

-// Но это можно записать по другому
+// Но это можно записать по-другому
 ($some_var) ? print 'true' : print 'false'; // print также является конструкцией языка,
                                            // но ведет себя как функция, поэтому она
                                            // может быть использована в этом контексте.
+
 echo $some_var ? 'true': 'false'; // echo вынесен за пределы выражения
 ?>
 ]]>
--- a/reference/strings/functions/sprintf.xml
+++ b/reference/strings/functions/sprintf.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 962214a5ccef8b5be8d20b80a621ad4f27b4f883 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 448a9cab142bb6fe2f32ab0cdb0669fcca454f35 Maintainer: shein Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.sprintf">
@ -134,7 +134,7 @@
           </member>
           <member>
            <literal>G</literal> - выбирает самую краткую запись из <literal>%E</literal> и
-            <literal>%f</literal>.
+            <literal>%F</literal>.
           </member>
           <member>
            <literal>o</literal> - аргумент трактуется как целое и выводится