<?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 => 'ja',
  ),
  'this' => 
  array (
    0 => 'language.oop5.inheritance.php',
    1 => 'オブジェクトの継承',
    2 => 'オブジェクトの継承',
  ),
  'up' => 
  array (
    0 => 'language.oop5.php',
    1 => 'クラスとオブジェクト',
  ),
  'prev' => 
  array (
    0 => 'language.oop5.visibility.php',
    1 => 'アクセス権',
  ),
  'next' => 
  array (
    0 => 'language.oop5.paamayim-nekudotayim.php',
    1 => 'スコープ定義演算子 (::)',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ja',
    'path' => 'language/oop5/inheritance.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="language.oop5.inheritance" class="sect1">
  <h2 class="title">オブジェクトの継承</h2>
  <p class="para">
   プログラミング言語の原則としてよくみられるものに継承があります。
   PHP はオブジェクトモデルにおいてこの継承を利用しています。
   多くのクラスとオブジェクトとの連携に継承は関係しています。
  </p>
  <p class="para">
   例えば、クラスを拡張するとき、サブクラスは親クラスから
   public と、protected のメソッドや、プロパティや定数をすべて引き継ぎます。
   (子の)クラスが親のメソッドをオーバーライドしない限り、
   親のメソッドの機能が保持されます。
  </p>
  <p class="para">
   これは、機能を定義して抽象化するのに便利です。
   また、同じようなオブジェクトに機能を追加する際に、
   共通機能を再実装する必要がなくなります。
  </p>
  <p class="para">
   親クラスの private メソッドは、子クラスからアクセスすることができません。
   その結果として、子クラスは通常の継承のルールを無視して
   private メソッドそのものを再実装することができてしまいます。
   しかし、PHP 8.0.0 より前のバージョンでは、
   <code class="literal">final</code> と <code class="literal">static</code>
   に関連する制限が private メソッドに適用されていました。
   PHP 8.0.0 以降では、private メソッドの規則が強制されるのは
   <code class="literal">private final</code>
   として宣言されたコンストラクタのみになりました。
   なぜなら、static として宣言されたファクトリメソッドを使う場合に、
   コンストラクタを無効にする方法として <code class="literal">private final</code>
   が用いられるからです。
  </p>
  <p class="para">
   メソッドやプロパティ、そして定数の
   <a href="language.oop5.visibility.php" class="link">アクセス権</a>
   に関するルールは、子クラスで緩めることが可能です。
   たとえば、
   親クラスで <code class="literal">protected</code> なメソッドは
   子クラスで <code class="literal">public</code> としてマークできます。
   しかし、厳しくすることはできません。
   つまり、親クラスで <code class="literal">public</code> なプロパティを
   子クラスで <code class="literal">private</code> にすることはできません。
   これの例外はコンストラクタです。
   コンストラクタのアクセス権は厳しくすることができます。
   たとえば、親クラスの <code class="literal">public</code> なコンストラクタは、
   子クラスで <code class="literal">private</code> としてマークできます。
  </p>

  <blockquote class="note"><p><strong class="note">注意</strong>: 
   <p class="para">
    オートローディングが有効になっていない限り、
    クラスの定義は実際に使うより前になければなりません。
    別のクラスを継承したクラスの場合は、
    そのクラスより前に親クラスが宣言されていなければなりません。
    この規則が適用されるのは、別のクラスやインターフェイスを継承したクラスです。
   </p>
  </p></blockquote>
  <blockquote class="note"><p><strong class="note">注意</strong>: 
   <p class="para">
    読み取りと書き込みが両方可能なプロパティを、
    <a href="language.oop5.properties.php#language.oop5.properties.readonly-properties" class="link">readonly</a> としてオーバーライドしてはいけません。逆も同じです。
    <div class="informalexample">
     <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #007700">class </span><span style="color: #0000BB">A </span><span style="color: #007700">{<br />    public </span><span style="color: #0000BB">int $prop</span><span style="color: #007700">;<br />}<br />class </span><span style="color: #0000BB">B </span><span style="color: #007700">extends </span><span style="color: #0000BB">A </span><span style="color: #007700">{<br />    </span><span style="color: #FF8000">// 正しくありません: read-write -&gt; readonly<br />    </span><span style="color: #007700">public readonly </span><span style="color: #0000BB">int $prop</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
   </p>
  </p></blockquote>

 <div class="example" id="example-1">
  <p><strong>例1 継承の例</strong></p>
  <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #007700">class </span><span style="color: #0000BB">Foo<br /></span><span style="color: #007700">{<br />    public function </span><span style="color: #0000BB">printItem</span><span style="color: #007700">(</span><span style="color: #0000BB">$string</span><span style="color: #007700">)<br />    {<br />        echo </span><span style="color: #DD0000">'Foo: ' </span><span style="color: #007700">. </span><span style="color: #0000BB">$string </span><span style="color: #007700">. </span><span style="color: #0000BB">PHP_EOL</span><span style="color: #007700">;<br />    }<br />    <br />    public function </span><span style="color: #0000BB">printPHP</span><span style="color: #007700">()<br />    {<br />        echo </span><span style="color: #DD0000">'PHP is great.' </span><span style="color: #007700">. </span><span style="color: #0000BB">PHP_EOL</span><span style="color: #007700">;<br />    }<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 function </span><span style="color: #0000BB">printItem</span><span style="color: #007700">(</span><span style="color: #0000BB">$string</span><span style="color: #007700">)<br />    {<br />        echo </span><span style="color: #DD0000">'Bar: ' </span><span style="color: #007700">. </span><span style="color: #0000BB">$string </span><span style="color: #007700">. </span><span style="color: #0000BB">PHP_EOL</span><span style="color: #007700">;<br />    }<br />}<br /><br /></span><span style="color: #0000BB">$foo </span><span style="color: #007700">= new </span><span style="color: #0000BB">Foo</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">$bar </span><span style="color: #007700">= new </span><span style="color: #0000BB">Bar</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">$foo</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">printItem</span><span style="color: #007700">(</span><span style="color: #DD0000">'baz'</span><span style="color: #007700">); </span><span style="color: #FF8000">// 出力: 'Foo: baz'<br /></span><span style="color: #0000BB">$foo</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">printPHP</span><span style="color: #007700">();       </span><span style="color: #FF8000">// 出力: 'PHP is great' <br /></span><span style="color: #0000BB">$bar</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">printItem</span><span style="color: #007700">(</span><span style="color: #DD0000">'baz'</span><span style="color: #007700">); </span><span style="color: #FF8000">// 出力: 'Bar: baz'<br /></span><span style="color: #0000BB">$bar</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">printPHP</span><span style="color: #007700">();       </span><span style="color: #FF8000">// 出力: 'PHP is great'<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
  </div>

 </div>

  <div class="sect2" id="language.oop5.inheritance.internal-classes">
   <h3 class="title">内部クラスと戻り値の型の互換性</h3>

   <p class="para">
    PHP 8.1 より前のバージョンでは、
    ほとんどの内部クラスやメソッドは戻り値の型を宣言していませんでしたし、
    それらを継承する際にもあらゆる戻り値の型を指定することができていました。
   </p>

   <p class="para">
    PHP 8.1.0 以降では、
    ほとんどの内部メソッドが、戻り値の型を &quot;とりあえず&quot;
    宣言するようになりました。
    この場合、それらを継承したメソッドの戻り値の型は、
    親と互換性があるものにすべきです。
    そうしない場合、推奨されない警告が発生します。
    注意すべきなのは、明示的に戻り値の型を宣言していない場合でも、
    シグネチャが一致していないとみなされ、
    推奨されない警告が発生することです。
   </p>

   <p class="para">
    PHP のバージョン間の互換性を保ちたいがために、
    戻り値の型を宣言できない場合、
    アトリビュート <span class="classname"><a href="class.returntypewillchange.php" class="classname">ReturnTypeWillChange</a></span>
    を追加することで警告を抑止できます。
   </p>

   <div class="example" id="example-2">
    <p><strong>例2 戻り値の型を宣言せずにメソッドをオーバーライドする場合</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">MyDateTime </span><span style="color: #007700">extends </span><span style="color: #0000BB">DateTime<br /></span><span style="color: #007700">{<br />    public function </span><span style="color: #0000BB">modify</span><span style="color: #007700">(</span><span style="color: #0000BB">string $modifier</span><span style="color: #007700">) { return </span><span style="color: #0000BB">false</span><span style="color: #007700">; }<br />}<br /><br /></span><span style="color: #FF8000">// PHP 8.1.0 以降では、"Deprecated: Return type of MyDateTime::modify(string $modifier) should either be compatible with DateTime::modify(string $modifier): DateTime|false, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice"<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>

   <div class="example" id="example-3">
    <p><strong>例3 間違った型を宣言してメソッドをオーバーライドする場合</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">MyDateTime </span><span style="color: #007700">extends </span><span style="color: #0000BB">DateTime<br /></span><span style="color: #007700">{<br />    public function </span><span style="color: #0000BB">modify</span><span style="color: #007700">(</span><span style="color: #0000BB">string $modifier</span><span style="color: #007700">): ?</span><span style="color: #0000BB">DateTime </span><span style="color: #007700">{ return </span><span style="color: #0000BB">null</span><span style="color: #007700">; }<br />}<br /><br /></span><span style="color: #FF8000">// PHP 8.1.0 以降では、"Deprecated: Return type of MyDateTime::modify(string $modifier): ?DateTime should either be compatible with DateTime::modify(string $modifier): DateTime|false, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice"<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>

   <div class="example" id="example-4">
    <p><strong>例4 間違った型を宣言してメソッドをオーバーライドする場合でも、警告を抑制する</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">MyDateTime </span><span style="color: #007700">extends </span><span style="color: #0000BB">DateTime<br /></span><span style="color: #007700">{<br />    </span><span style="color: #FF8000">/**<br />     * @return DateTime|false<br />     */<br />    </span><span style="color: #007700">#[</span><span style="color: #0000BB">\ReturnTypeWillChange</span><span style="color: #007700">]<br />    public function </span><span style="color: #0000BB">modify</span><span style="color: #007700">(</span><span style="color: #0000BB">string $modifier</span><span style="color: #007700">) { return </span><span style="color: #0000BB">false</span><span style="color: #007700">; }<br />}<br /><br /></span><span style="color: #FF8000">// 警告は発生しません。<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>

  </div>

 </div><?php manual_footer($setup); ?>