php-doc-en/language/oop5/inheritance.xml
2021-04-01 23:21:32 +02:00

108 lines
3.3 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<sect1 xml:id="language.oop5.inheritance" xmlns="http://docbook.org/ns/docbook">
<title>Object Inheritance</title>
<para>
Inheritance is a well-established programming principle, and PHP makes use
of this principle in its object model. This principle will affect the way
many classes and objects relate to one another.
</para>
<para>
For example, when extending a class, the subclass inherits all of the
public and protected methods, properties and constants from the parent class.
Unless a class overrides
those methods, they will retain their original functionality.
</para>
<para>
This is useful for defining and abstracting functionality, and permits the
implementation of additional functionality in similar objects without the
need to reimplement all of the shared functionality.
</para>
<para>
Private methods of a parent class are not accessible to a child class. As a result,
child classes may reimplement a private method themselves without regard for normal
inheritance rules. Prior to PHP 8.0.0, however, <literal>final</literal> and <literal>static</literal>
restrictions were applied to private methods. As of PHP 8.0.0, the only private method
restriction that is enforced is <literal>private final</literal> constructors, as that
is a common way to "disable" the constructor when using static factory methods instead.
</para>
<para>
The <link linkend="language.oop5.visibility">visibility</link>
of methods, properties and constants can be relaxed, e.g. a
<literal>protected</literal> method can be marked as
<literal>public</literal>, but they cannot be restricted, e.g.
marking a <literal>public</literal> property as <literal>private</literal>.
</para>
<note>
<para>
Unless autoloading is used, the classes must be defined before they are
used. If a class extends another, then the parent class must be declared
before the child class structure. This rule applies to classes that inherit
other classes and interfaces.
</para>
</note>
<sect2 xml:id="language.oop5.inheritance.examples">
<example xml:id="language.oop5.inheritance.examples.ex1">
<title>Inheritance Example</title>
<programlisting role="php">
<![CDATA[
<?php
class Foo
{
public function printItem($string)
{
echo 'Foo: ' . $string . PHP_EOL;
}
public function printPHP()
{
echo 'PHP is great.' . PHP_EOL;
}
}
class Bar extends Foo
{
public function printItem($string)
{
echo 'Bar: ' . $string . PHP_EOL;
}
}
$foo = new Foo();
$bar = new Bar();
$foo->printItem('baz'); // Output: 'Foo: baz'
$foo->printPHP(); // Output: 'PHP is great'
$bar->printItem('baz'); // Output: 'Bar: baz'
$bar->printPHP(); // Output: 'PHP is great'
?>
]]>
</programlisting>
</example>
</sect2>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->