decon.xml Исправил и уточнил формулировки

Author: mmalferov

language/oop5/decon.xml

@@ -18,7 +18,7 @@
   </para>
   <note>
    <simpara>
-    Конструктор родительского класса не вызывает автоматически
+    Конструктор родительского класса не вызывается автоматически
     при определении конструктора в дочернем классе.
     Внутри конструктора дочернего класса потребуется вызвать
     <function>parent::__construct</function>, чтобы запустить конструктор родительского класса.
@@ -72,14 +72,14 @@ $obj = new OtherSubClass();
    при наследовании.
   </para>
   <para>
-   Конструкторы — обыкновенные методы, которые вызываются при инстанциировании объектов,
-   которые содержат эти конструкторы, или объектов дочерних классов без конструктора.
-   Поэтому в конструкторах определяют произвольное количество аргументов,
+   Конструкторы — обыкновенные методы, которые вызываются во время создания объекта
+   класса с конструктором или объекта дочернего класса без конструктора.
+   Поэтому в конструкторах определяют произвольное количество параметров,
    которые разрешено объявлять обязательными, типизированными, со значением по умолчанию.
-   Аргументы конструктора указываются в круглых скобках после имени класса.
+   Параметры конструктора указываются в круглых скобках после имени класса.
   </para>
   <example>
-   <title>Объявление аргументов в конструкторах</title>
+   <title>Объявление параметров в конструкторах</title>
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -96,31 +96,31 @@ class Point
     }
 }
 
-// Передаём оба параметра
+// Передаём оба аргумента
 $p1 = new Point(4, 5);
 
-// Передаём только обязательные параметры. Переменная $y содержит значение по умолчанию 0
+// Передаём только обязательные аргументы. Переменная $y содержит значение по умолчанию 0
 $p2 = new Point(4);
 
-// Вызываем с именованными параметрами (начиная с PHP 8.0):
+// Создаём объект с передачей именованных аргументов, которые поддерживаются начиная с PHP 8.0:
 $p3 = new Point(y: 5, x: 4);
 ]]>
    </programlisting>
   </example>
   <para>
-   Скобки после имени класса необязательны, если у класса нет конструктора,
+   Скобки после названия класса необязательны, если в классе не определили конструктор
    или конструктор класса не содержит обязательных параметров.
   </para>
   <sect3>
    <title>Конструкторы в старом стиле</title>
    <para>
-    До PHP 8.0.0 классы в глобальном пространстве имён будут
-    интерпретировать названный именем класса метод как конструктор старого стиля.
-    Этот синтаксис устарел и будет вызывать ошибку уровня <constant>E_DEPRECATED</constant>,
+    До PHP 8.0.0 классы в глобальном пространстве имён
+    интерпретируют названный именем класса метод как конструктор старого стиля.
+    Этот синтаксис устарел и вызовет ошибку уровня <constant>E_DEPRECATED</constant>,
     но всё равно вызовет этот метод как конструктор.
     PHP вызовет как конструктор метод <link linkend="object.construct">__construct()</link>,
     если в классе определили и метод <link linkend="object.construct">__construct()</link>,
-    и метод с именем класса.
+    и метод с названием класса.
    </para>
    <para>
     У метода, название которого совпадает с именем класса, нет особого значения
@@ -131,7 +131,7 @@ $p3 = new Point(y: 5, x: 4);
    </para>
   </sect3>
   <sect3 xml:id="language.oop5.decon.constructor.promotion">
-   <title>Продвижение свойств в конструкторе</title>
+   <title>Продвижение параметров конструктора до свойств класса</title>
    <para>
     С PHP 8.0.0 параметры конструктора стали поддерживать продвижение
     до свойств объекта. Это распространённая практика — присваивать
@@ -153,24 +153,22 @@ class Point
     </programlisting>
    </example>
    <para>
-    PHP интерпретирует аргумент одновременно и как параметр конструктора,
-    и как свойство объекта, и устанавливает значение аргумента свойству,
-    когда параметр конструктора содержит модификатор. Тогда тело конструктора
-    оставляют пустым или добавляют другие инструкции. Конструктор выполнит
-    дополнительные инструкции после присваивания значений аргументов
+    PHP интерпретирует параметры с модификатором видимости одновременно и как параметр конструктора,
+    и как свойство объекта, и устанавливает значение аргумента свойству.
+    Из-за упреждающего вычисления тело конструктора
+    остаётся пустым, или включает другие инструкции, не связанные с инициализацией свойств.
+    Конструктор выполнит дополнительные инструкции после присваивания значений аргументов
     свойствам.
    </para>
    <para>
-    Не каждый аргумент обязан продвигать параметр конструктора
-    до свойства объекта. Допустимо смешивать продвигаемые
-    и непродвигаемые параметры в произвольном порядке, и давать
-    обыкновенным параметрам конструктора имена, которые совпадают с именами
-    свойств класса. Аргументы, которые продвигают параметры до свойств,
-    не влияют на вызывающий конструктор код.
+    Не каждому параметру конструктора требуется продвижение
+    до свойства объекта. Поддерживается смешивание продвигаемых
+    и стандартных параметров в произвольном порядке. Продвигаемые параметры
+    не изменяют порядок вызова конструктора.
    </para>
    <note>
     <para>
-     Указать <link linkend="language.oop5.visibility">модификатор области видимости</link> —
+     <link linkend="language.oop5.visibility">Модификатор области видимости</link> —
      <literal>public</literal>, <literal>protected</literal> или <literal>private</literal> —
      наиболее вероятный способ применить продвинутую установку свойств,
      но любой другой модификатор, например <literal>readonly</literal>, даст такой же эффект.
@@ -179,29 +177,29 @@ class Point
    <note>
     <para>
      Нельзя указывать свойствам объекта тип <type>callable</type>.
-     Это связано с неоднозначностью, которую они представляют для движка PHP.
+     Это связано с неоднозначностью, которую представляют вызываемые значения для движка PHP.
      Поэтому и для параметров конструктора, которые устанавливают классу свойства,
-     также нельзя указывать тип <type>callable</type>. Любые другие
-     <link linkend="language.types.declarations">декларации типов</link> допустимы.
+     тоже нельзя указывать тип <type>callable</type>. Но остальные
+     <link linkend="language.types.declarations">декларации типов</link> поддерживаются.
     </para>
    </note>
    <note>
     <para>
-     PHP применяет ограничения на именование параметров конструктора
+     PHP накладывает ограничения на именование параметров конструктора
      как к свойствам класса, так и к параметрам функции,
      поскольку при разборе кода PHP преобразовывает синтаксический сахар
-     продвинутых свойств в декларирование свойств класса
+     объявления свойств в конструкторе в декларирование свойств класса
      с теми же модификаторами видимости и типом данных, которые указали
-     в продвинутом параметре, и присваивает значение
+     в продвигаемом до свойств объекта параметре, и присваивает значение
      аргумента и параметру функции, и свойству класса.
     </para>
    </note>
    <note>
     <para>
-     <link linkend="language.attributes">Атрибуты</link>, которые установили
-     для аргумента в продвинутом конструкторе, будут реплицированы как на аргумент,
-     так и на свойство класса. Значение по умолчанию для аргумента в продвинутом
-     конструкторе распространяется только на аргумент, а не свойство.
+     На этапе определения конструктора <link linkend="language.attributes">атрибуты</link>
+     продвигаемого до свойства параметра реплицируются как на параметр конструктора,
+     так и на свойство класса, но значение по умолчанию PHP установит только параметру,
+     но не свойству.
     </para>
    </note>
   </sect3>
@@ -393,31 +391,31 @@ $obj = new MyDestructableClass();
    в деструкторе предотвратит запуск остальных процедур завершения работы.
   </para>
   <para>
-   Если деструктор создаёт новые ссылки на свой объект, он не будет вызван во второй раз,
-   когда счётчик ссылок снова достигнет нуля или во время последовательности выключения.
+   Деструктор, который создаёт новые ссылки на свой объект, не вызовется второй раз,
+   когда счётчик ссылок снова достигнет нуля или при завершении работы программы.
   </para>
   <para>
-   Начиная с PHP 8.4.0, когда <link linkend="features.gc.collecting-cycles">сбор циклических ссылок</link>
-   происходит во время выполнения <link linkend="language.fibers">файбера</link>,
-   деструкторы объектов, запланированных для сбора, выполняются в отдельном файбере,
-   называемом <literal>gc_destructor_fiber</literal>.
-   Если файбер приостановлен, будет создан новый для выполнения всех оставшихся деструкторов.
-   Предыдущий <literal>gc_destructor_fiber</literal> больше не будет
-   упоминаться сборщиком мусора и может быть собран, если на него нет других ссылок.
-   Объекты, деструктор которых приостановлен, не будут собираться до тех пор,
-   пока деструктор не вернётся или пока не будет собран сам файбер.
+   Начиная с PHP 8.4.0 при запуске <link linkend="features.gc.collecting-cycles">сборки циклических ссылок</link>
+   внутри <link linkend="language.fibers">файбера</link>
+   деструкторы объектов-кандидатов на уничтожение выполняются в отдельном файбере,
+   который называется <literal>gc_destructor_fiber</literal>.
+   Сборщик создаст новый файбер сборки мусора для выполнения оставшихся деструкторов,
+   если текущий файбер сборщика приостановили внутри деструктора уничтожаемого объекта.
+   Сборщик мусора перестанет ссылаться на предыдущий файбер <literal>gc_destructor_fiber</literal>,
+   который станет доступен для сборки, если на него не останется других ссылок.
+   Уничтожение объектов с приостановленным деструктором откладывается
+   до завершения выполнения деструктора или уничтожения самого файбера.
   </para>
   <note>
    <para>
-    При завершении работы скрипта PHP отправляет HTTP-заголовки перед обработкой деструкторов.
-    На этапе завершения работы скрипта рабочая директория, как её определяет PHP, иногда
-    не совпадает с рабочей директорией, которую возвращают отдельные SAPI-интерфейсы
-    (например, в Apache).
+    Движок отправляет HTTP-заголовки ещё до начала этапа завершения работы скрипта, на котором вызываются деструкторы.
+    Относительные пути в деструкторах разрешаются в неожиданные абсолютные пути,
+    когда SAPI наподобие веб-сервера Apache изменяют текущий рабочий каталог на этапе завершения работы скрипта.
    </para>
   </note>
   <note>
    <para>
-    Попытка выбросить исключение из деструктора, который вызвали во время
+    Попытка выбросить исключение из деструктора, который вызвали на этапе
     завершения работы скрипта, вызовет фатальную ошибку.
    </para>
   </note>