Update final.xml to en

Author: mmalferov

language/oop5/final.xml

@@ -1,12 +1,13 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 5e8652131e898cd3d02cd26eeb26da718a6aaf65 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 16f66c05a4060a7d673ae1c70b656d65009407b0 Maintainer: shein Status: ready -->
 <!-- Reviewed: no -->
 <sect1 xml:id="language.oop5.final" xmlns="http://docbook.org/ns/docbook">
  <title>Ключевое слово final</title>
  <para>
-  Ключевое слово <literal>final</literal>, которое указали перед определением метода или константы,
-  не даёт дочерним классам переопределять этот метод или константу.
-  Ключевое слово не даст расширить класс, если класс определили окончательным.
+  Ключевое слово <literal>final</literal>, которое указали перед определением метода,
+  свойства или константы, не разрешает дочерним классам переопределять
+  метод, свойство или константу.
+  Ключевое слово не разрешит расширить класс, если класс определили окончательным.
  </para>
  <para>
   <example>
@@ -35,7 +36,7 @@ class ChildClass extends BaseClass
        echo "Вызван метод ChildClass::moreTesting()\n";
    }
 }
-// Приводит к фатальной ошибке: Cannot override final method BaseClass::moreTesting()
+// Переопределение финального метода вызовет ошибку Fatal error: Cannot override final method BaseClass::moreTesting()
 
 ?>
 ]]>
@@ -51,30 +52,51 @@ class ChildClass extends BaseClass
 
 final class BaseClass
 {
-   public function test()
-   {
-       echo "Вызван метод BaseClass::test()\n";
-   }
+    public function test()
+    {
+        echo "Вызвали метод BaseClass::test()\n";
+    }
 
-   // Поскольку класс уже окончательный, ключевое слово final избыточно
-   final public function moreTesting()
-   {
-       echo "Вызван метод BaseClass::moreTesting()\n";
-   }
+    // Поскольку класс уже окончательный, ключевое слово final избыточно
+    final public function moreTesting()
+    {
+        echo "Вызвали метод BaseClass::moreTesting()\n";
+    }
 }
 
 class ChildClass extends BaseClass {}
-// Приводит к фатальной ошибке: Class ChildClass may not inherit from final class (BaseClass)
+// Наследование финального класса вызовет ошибку Fatal error: Class ChildClass may not inherit from final class (BaseClass)
 
 ?>
 ]]>
    </programlisting>
   </example>
  </para>
- <para>
-  <example xml:id="language.oop5.final.example.php81">
-   <title>Пример окончательной константы, которые появились в PHP 8.1.0</title>
-   <programlisting role="php">
+ <example>
+  <title>Пример финального свойства, которые появились с PHP 8.4.0</title>
+  <programlisting role="php">
+<![CDATA[
+<?php
+
+class BaseClass
+{
+   final protected string $test;
+}
+
+class ChildClass extends BaseClass
+{
+    public string $test;
+}
+
+// Переопределение финального свойства вызовет ошибку Fatal error: Cannot override final property BaseClass::$test
+
+?>
+]]>
+  </programlisting>
+ </example>
+ <example xml:id="language.oop5.final.example.php81">
+  <title>Пример финальной константы, которые появились с PHP 8.1.0</title>
+  <programlisting role="php">
 <![CDATA[
 <?php
 
@@ -88,20 +110,25 @@ class Bar extends Foo
     public const X = "bar";
 }
 
-// Фатальная ошибка: Bar::X cannot override final constant Foo::X
+// Переопределение финальной константы вызовет ошибку Fatal error: Bar::X cannot override final constant Foo::X
 
 ?>
 ]]>
-    </programlisting>
-  </example>
- </para>
+  </programlisting>
+ </example>
+
  <note>
   <simpara>
-   Свойства нельзя объявлять окончательными: только классы, методы и константы (с PHP 8.1.0)
-   разрешено объявлять окончательными.
+   С PHP 8.0.0 закрытые методы, за исключением <link linkend="language.oop5.decon.constructor">
+    конструкторов
+   </link>, нельзя объявлять финальными.
   </simpara>
+ </note>
+ <note>
   <simpara>
-   С PHP 8.0.0 закрытые методы, кроме конструктора, нельзя объявлять окончательными.
+   Свойства, которые объявили c закрытой областью установки видимости
+   <link linkend="language.oop5.visibility-members-aviz"><literal>private(set)</literal></link>,
+   неявно получают ключевое слово <literal>final</literal>.
   </simpara>
  </note>
 </sect1>