Konstruktoren und Destruktoren

Konstruktor

__construct(mixed ...$values = ""): void

PHP erlaubt es Entwicklern, Konstruktormethoden für Klassen zu deklarieren. Klassen mit Konstruktormethoden rufen diese für jedes neu erzeugte Objekt auf, sodass Konstruktoren für alle Initialisierungen passend sind, die das Objekt brauchen könnte, bevor es benutzt wird.

Hinweis: Konstruktoren von Elternklassen werden nicht implizit aufgerufen, wenn die Kindklasse einen Konstruktor definiert. Um einen Elternkonstruktor zu benutzen, ist ein Aufruf von parent::__construct() innerhalb des Kindkonstruktors notwendig. Falls das Kind keinen Konstruktor definiert, kann er von der Elternklasse genau wie eine normale Klassenmethode geerbt werden (falls er nicht als privat deklariert wurde).

Beispiel #1 Konstruktoren bei der Vererbung

<?php
class BaseClass {
    function __construct() {
        print "Im BaseClass-Konstruktor\n";
    }
}

class SubClass extends BaseClass {
    function __construct() {
        parent::__construct();
        print "Im SubClass-Konstruktor\n";
    }
}

class OtherSubClass extends BaseClass {
    // erbt den Konstruktor von BaseClass
}

// Im BaseClass-Konstruktor
$obj = new BaseClass();

// Im BaseClass-Konstruktor
// Im SubClass-Konstruktor
$obj = new SubClass();

// Im BaseClass-Konstruktor
$obj = new OtherSubClass();
?>

Im Gegensatz zu anderen Methoden ist __construct() ist ausgenommen von den üblichen Regeln für die Signaturkompatibilität. wenn sie erweitert wird.

Konstruktoren sind gewöhnliche Methoden, die bei der Instanziierung des entsprechenden Objekts aufgerufen werden. Als solche können sie eine beliebige Anzahl von Argumenten definieren, die erforderlich sein können, einen Typ haben können und einen Standardwert haben können. Konstruktorargumente werden aufgerufen, indem die Argumente in Klammern hinter den Klassennamen gesetzt werden.

Beispiel #2 Die Verwendung von Argumenten eines Konstruktors

<?php
class Punkt {
    protected int $x;
    protected int $y;

    public function __construct(int $x, int $y = 0) {
        $this->x = $x;
        $this->y = $y;
    }
}

// Beide Parameter übergeben.
$p1 = new Punkt(4, 5);
// Nur den erforderlichen Parameter übergeben. $y nimmt den Standardwert von 0 an.
$p2 = new Punkt(4);
// Mit benannten Parametern (von PHP 8.0 an):
$p3 = new Punkt(y: 5, x: 4);
?>

Wenn eine Klasse keinen Konstruktor hat oder der Konstruktor keine erforderlichen Argumente hat, können die Klammern weggelassen werden.

Konstruktoren alten Stils

Vor PHP 8.0.0 interpretieren Klassen im globalen Namensraum eine Methode, die den gleichen Namen wie die Klasse trägt, als Konstruktor alten Stils. Diese Syntax ist veraltet, und führt zu einem E_DEPRECATED-Fehler, ruft die Funktion aber trotzdem als Konstruktor auf. Wenn sowohl __construct() als auch eine Methode gleichen Namens definiert sind, wird __construct() aufgerufen.

In Namensraum-Klassen, oder ab PHP 8.0.0 in jeder Klasse, hat eine Methode mit dem Namen der Klasse keine besondere Bedeutung.

Verwenden Sie in neuem Code immer __construct().

Promotion (Beförderung) des Konstruktors

Ab PHP 8.0.0 können Konstruktorparameter auch so befördert werden, dass sie einer Objekteigenschaft entsprechen. Sehr häufig werden Konstruktorparameter einer Eigenschaft im Konstruktor zugewiesen, aber ansonsten nicht bearbeitet. Die Konstruktor-Promotion bietet eine Kurzform für diesen Anwendungsfall. Das obige Beispiel könnte wie folgt umgeschrieben werden:

Beispiel #3 Die Verwendung der Beförderung von Konstruktor-Eigenschaften

<?php
class Punkt {
    public function __construct(protected int $x, protected int $y = 0) {
    }
}

Wenn ein Konstruktorargument einen Modifizierer enthält, interpretiert PHP es sowohl als Objekteigenschaft als auch als Konstruktorargument und weist der Eigenschaft den Wert des Arguments zu. Der Konstruktorkörper kann dann leer sein oder andere Anweisungen enthalten. Alle zusätzlichen Anweisungen werden ausgeführt, nachdem die Argumentwerte den entsprechenden Eigenschaften zugewiesen wurden.

Nicht alle Argumente müssen befördert werden. Beförderte und nicht beförderte Argumente können in beliebiger Reihenfolge zu kombiniert werden. Beförderte Argumente haben keinen Einfluss auf den Code, der den Konstruktor aufruft.

Hinweis:
Eigenschaften werden wahrscheinlich meist mit einem Sichtbarkeitsmodifikator (public, protected oder private) befördert, aber jeder andere einzelne Modifikator (z. B. readonly) hat denselben Effekt.

Hinweis:
Objekteigenschaften dürfen aufgrund der Mehrdeutigkeit, die in die Engine einfließen würde, nicht mit callable typisiert werden. Somit dürfen die angeführten Argumente auch nicht mit callable typisiert werden. Jede andere Typ-Deklaration ist jedoch erlaubt.

Hinweis:
Da beförderte Eigenschaften sowohl zu einer Eigenschaft als auch zu einem Funktionsparameter gemacht werden, gelten alle Namensbeschränkungen sowohl für Eigenschaften als auch für Parameter.

Hinweis:
Attribute, die auf ein befördertes Konstruktorargument gelegt werden, werden sowohl auf die Eigenschaft als auch auf das Argument übertragen. Die Standardwerte für ein befördertes Konstruktorargument werden nur auf das Argument und nicht auf die Eigenschaft übertragen.

New bei der Initialisierung

Ab PHP 8.1.0 können Objekte als Standardwerte für Parameter, als statische Variablen und globale Konstanten sowie in Eigenschaftsparametern verwendet werden. Objekte können nun auch an define() übergeben werden.

Hinweis:
Es ist nicht zulässig, einen dynamischen Klassennamen, einen Klassennamen, der keine Zeichenkette ist, oder eine anonyme Klasse zu verwenden. Es ist auch nicht zulässig, Parameter zu entpacken, und nicht unterstützte Ausdrücke als Parameter zu verwenden.

Beispiel #4 Verwendung von new bei Initialisierungen

<?php

// Alles zulässig:
static $x = new Foo;

const C = new Foo;

function test($param = new Foo) {}

#[AnAttribute(new Foo)]
class Test {
    public function __construct(
        public $prop = new Foo,
    ) {}
}

// Alles nicht zulässig (Kompilierfehler):
function test(
    $a = new (CLASS_NAME_CONSTANT)(), // dynamischer Klassenname
    $b = new class {}, // anonyme Klasse
    $c = new A(...[]), // Entpacken von Parametern
    $d = new B($abc), // nicht unterstützter Ausdruck
) {}
?>

Erzeugung über statische Methoden

PHP unterstützt nur einen einzigen Konstruktor pro Klasse. In einigen Fällen, kann es jedoch wünschenswert sein, dass ein Objekt auf verschiedene Weisen mit unterschiedlichen Eingaben erzeugt werden kann. Der empfohlene Weg, dies zu tun, ist die, Konstruktoren in statische Methoden zu packen.

Beispiel #5 Die Erzeugung über statische Methoden verwenden

<?php
$some_json_string = '{ "id": 1004, "name": "Elephpant" }';
$some_xml_string = "<animal><id>1005</id><name>Elephpant</name></animal>";

class Produkt {

    private ?int $id;
    private ?string $name;

    private function __construct(?int $id = null, ?string $name = null) {
        $this->id = $id;
        $this->name = $name;
    }

    public static function fromBasicData(int $id, string $name): static {
        $neu = new static($id, $name);
        return $neu;
    }

    public static function fromJson(string $json): static {
        $daten = json_decode($json, true);
        return new static($daten['id'], $daten['name']);
    }

    public static function fromXml(string $xml): static {
        $data = simplexml_load_string($xml);
        $neu = new static();
        $neu->id = (int) $daten->id;
        $neu->name = $daten->name;
        return $neu;
    }
}

$p1 = Produkt::fromBasicData(5, 'Widget');
$p2 = Produkt::fromJson($some_json_string);
$p3 = Produkt::fromXml($some_xml_string);

var_dump($p1, $p2, $p3);

Der Konstruktor kann private oder protected gemacht werden, um zu verhindern, dass er von außen aufgerufen wird. Wenn dies der Fall ist, kann nur eine statische Methode die Klasse instanziieren. Da sie in der gleichen Klassendefinition enthalten ist, hat sie Zugriff auf private Methoden, auch wenn sie nicht zur gleichen Objektinstanz gehören. Der private Konstruktor ist optional und kann je nach Anwendungsfall sinnvoll sein oder nicht.

Die drei public static Methoden veranschaulichen dann verschiedene Möglichkeiten das Objekt zu instanziieren.

fromBasicData() nimmt genau die Parameter, die benötigt werden, erzeugt dann das Objekt durch Aufruf des Konstruktors und Rückgabe des Ergebnisses.
fromJson() akzeptiert eine JSON-Zeichenkette und führt selbst eine Vorverarbeitung durch, um sie in das vom Konstruktor gewünschte Format zu konvertieren. Sie gibt dann das neue Objekt zurück.
fromXml() akzeptiert eine XML-Zeichenkette, vorverarbeitet sie und erzeugt dann ein leeres Objekt. Der Konstruktor wird immer noch aufgerufen, aber da alle Parameter optional sind, überspringt sie die Methode. Sie weist dann den Objekteigenschaften direkt Werte zu, bevor sie das Ergebnis zurückgibt.

In allen drei Fällen wird das Schlüsselwort static in den Namen der Klasse übersetzt, in der sich der Code befindet. In diesem Fall: Produkt.

Destruktor

__destruct(): void

PHP verfügt über ein Destruktorkonzept ähnlich dem anderer objektorientierter Programmiersprachen wie C++. Die Destruktormethode wird aufgerufen, sobald es keine weiteren Referenzen auf ein bestimmtes Objekt mehr gibt, oder in beliebiger Reihenfolge am Ende des Skripts.

Beispiel #6 Destruktor-Beispiel

<?php

class MyDestructableClass
{
    function __construct() {
        print "Im Konstruktor\n";
    }

    function __destruct() {
        print "Zerstoere " . __CLASS__ . "\n";
    }
}

$obj = new MyDestructableClass();

Wie Konstruktoren auch, werden Elterndestruktoren nicht implizit durch die Engine aufgerufen. Um einen Elterndestruktor zu benutzen muss man explizit die Funktion parent::__destruct() in der Destruktorimplementierung aufrufen. Ebenso wie Konstruktoren kann eine Kindklasse den Destruktor der Eltern erben, falls sie keinen eigenen implementiert.

Der Destruktor wird aufgerufen, wenn das Skript mittels exit() abgebrochen wird. Wenn exit() innerhalb eines Destruktors aufgerufen wird, verhindert das die Ausführung von jeglichen weiteren Shutdown-Routinen.

Wenn ein Destruktor neue Referenzen auf sein Objekt erzeugt, wird er nicht ein zweites Mal aufgerufen, wenn die Anzahl der Referenzen wieder Null erreicht oder während der Abschaltsequenz.

Seit PHP 8.4.0 werden, wenn die Sammlung zyklischer Referenzen während der Ausführung einer Fiber stattfindet, die Destruktoren von Objekten, die für die Sammlung vorgesehen sind, in einer separaten Fiber namens gc_destructor_fiber ausgeführt. Wenn diese Fiber unterbrochen wird, wird eine neue erstellt, um alle verbleibenden Destruktoren auszuführen. Die vorherige gc_destructor_fiber wird vom Garbage Collector nicht mehr referenziert und kann, wenn sie nicht anderweitig referenziert wird, eingesammelt werden. Objekte, deren Destruktor ausgesetzt ist, werden nicht eingesammelt, bis der Destruktor zurückgibt oder die Fiber selbst eingesammelt wird.

Hinweis:
Der Destruktor wird während der Skript-Abschaltung aufgerufen, weshalb die Header immer bereits gesendet sind. Das aktuelle Verzeichnis während der Beendigungsphase des Skripts kann bei einigen SAPIs (z. B. Apache) ein anderes sein.

Hinweis:
Der Versuch, eine Exception aus einem Destruktor (der am Ende des Skripts aufgerufen wird) heraus zu auszulösen, führt zu einem fatalen Fehler.