<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/language.oop5.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'language.oop5.final.php',
    1 => 'Final 关键字',
    2 => 'Final 关键字',
  ),
  'up' => 
  array (
    0 => 'language.oop5.php',
    1 => '类与对象',
  ),
  'prev' => 
  array (
    0 => 'language.oop5.magic.php',
    1 => '魔术方法',
  ),
  'next' => 
  array (
    0 => 'language.oop5.cloning.php',
    1 => '对象复制',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'language/oop5/final.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="language.oop5.final" class="sect1">
  <h2 class="title">Final 关键字</h2>
  <p class="para">
   final 关键字通过在定义方法、属性和常量之前加上 <code class="literal">final</code> 来防止被子类覆盖。
   如果一个类被声明为 final，则不能被继承。
  </p>
  
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>示例 #1 Final 方法示例</strong></p>
     <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">BaseClass </span><span style="color: #007700">{<br />   public function </span><span style="color: #0000BB">test</span><span style="color: #007700">() {<br />       echo </span><span style="color: #DD0000">"BaseClass::test() called\n"</span><span style="color: #007700">;<br />   }<br />   <br />   final public function </span><span style="color: #0000BB">moreTesting</span><span style="color: #007700">() {<br />       echo </span><span style="color: #DD0000">"BaseClass::moreTesting() called\n"</span><span style="color: #007700">;<br />   }<br />}<br /><br />class </span><span style="color: #0000BB">ChildClass </span><span style="color: #007700">extends </span><span style="color: #0000BB">BaseClass </span><span style="color: #007700">{<br />   public function </span><span style="color: #0000BB">moreTesting</span><span style="color: #007700">() {<br />       echo </span><span style="color: #DD0000">"ChildClass::moreTesting() called\n"</span><span style="color: #007700">;<br />   }<br />}<br /></span><span style="color: #FF8000">// 产生 Fatal error: Cannot override final method BaseClass::moreTesting()<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>
  <p class="para">
   <div class="example" id="example-2">
    <p><strong>示例 #2 Final 类示例</strong></p>
    <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">final class </span><span style="color: #0000BB">BaseClass </span><span style="color: #007700">{<br />   public function </span><span style="color: #0000BB">test</span><span style="color: #007700">() {<br />       echo </span><span style="color: #DD0000">"BaseClass::test() called\n"</span><span style="color: #007700">;<br />   }<br />   <br />   </span><span style="color: #FF8000">// 由于类已经是 final，所以 final 关键字是多余的<br />   </span><span style="color: #007700">final public function </span><span style="color: #0000BB">moreTesting</span><span style="color: #007700">() {<br />       echo </span><span style="color: #DD0000">"BaseClass::moreTesting() called\n"</span><span style="color: #007700">;<br />   }<br />}<br /><br />class </span><span style="color: #0000BB">ChildClass </span><span style="color: #007700">extends </span><span style="color: #0000BB">BaseClass </span><span style="color: #007700">{<br />}<br /></span><span style="color: #FF8000">// 产生 Fatal error: Class ChildClass may not inherit from final class (BaseClass)<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>

 <div class="example" id="example-3">
  <p><strong>示例 #3 PHP 8.4.0 起可用的 final 属性示例</strong></p>
  <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">BaseClass </span><span style="color: #007700">{<br />   final protected </span><span style="color: #0000BB">string $test</span><span style="color: #007700">;<br />}<br /><br />class </span><span style="color: #0000BB">ChildClass </span><span style="color: #007700">extends </span><span style="color: #0000BB">BaseClass </span><span style="color: #007700">{<br />    public </span><span style="color: #0000BB">string $test</span><span style="color: #007700">;<br />}<br /></span><span style="color: #FF8000">// Results in Fatal error: Cannot override final property BaseClass::$test<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
  </div>

 </div>
 <div class="example" id="language.oop5.final.example.php81">
  <p><strong>示例 #4 PHP 8.1.0 起可用的 final 常量示例</strong></p>
  <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">Foo<br /></span><span style="color: #007700">{<br />    final public const </span><span style="color: #0000BB">X </span><span style="color: #007700">= </span><span style="color: #DD0000">"foo"</span><span style="color: #007700">;<br />}<br /><br />class </span><span style="color: #0000BB">Bar </span><span style="color: #007700">extends </span><span style="color: #0000BB">Foo<br /></span><span style="color: #007700">{<br />    public const </span><span style="color: #0000BB">X </span><span style="color: #007700">= </span><span style="color: #DD0000">"bar"</span><span style="color: #007700">;<br />}<br /><br /></span><span style="color: #FF8000">// Fatal error: Bar::X cannot override final constant Foo::X<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
  </div>

 </div>

  <blockquote class="note"><p><strong class="note">注意</strong>: 
   <span class="simpara">
    从 PHP 8.0.0 起，除了<a href="language.oop5.decon.php#language.oop5.decon.constructor" class="link">构造函数</a>之外，私有方法也不能声明为 final 。
   </span>
   <span class="simpara">
    声明为 <a href="language.oop5.visibility.php#language.oop5.visibility-members-aviz" class="link"><code class="literal">private(set)</code></a> 的属性是隐式的 <code class="literal">final</code>。
   </span>
  </p></blockquote>
 </div><?php manual_footer($setup); ?>