Pattern
Final Schlüsselwort
Klassen und Objekte (PHP 5)
PHP Manual

## Magische Methoden

Die Funktionen __construct, __destruct (siehe auch Konstruktoren und Destruktoren), __call, __callStatic, __get, __set, __isset, __unset (siehe auch Überladung), __sleep, __wakeup, __toString, __set_state und __clone sind in PHP Klassen magisch. Man kann keine Funktionen gleichen Namens in einer seiner Klassen haben, wenn man nicht die magische Funktionalität, die sie mit sich bringen, haben will.

Achtung

PHP reserviert alle Funktionsnamen die mit __ beginnen als magsich. Es ist empfohlen keine Funktionsnamen mit __ in PHP zu benutzen, es sei denn man möchte dokumentierte magische Funktionalität verwenden.

### __sleep und __wakeup

serialize() prüft, ob Ihre Klasse eine Funktion mit dem magischen Namen __sleep besitzt. Wenn dem so ist, wird die Funktion vor jeder Serialisierung ausgeführt. Sie kann das Objekt aufräumen und es wird von Ihr erwartet, dass Sie ein Array mit den Namen aller Variablen zurückliefert, die serialisiert werden sollen. Wenn die Methode nichts zurückgibt, so wird `NULL` serialisiert und eine E_NOTICE ausgegeben.

Die beabsichtigte Verwendung von __sleep ist es, nicht gespeicherte Daten zu sichern oder ähnliche Aufräumarbeiten zu erledigen. Die Funktion ist ebenfalls nützlich, wenn Sie sehr große Objekte haben, welche nicht komplett gespeichert werden müssen.

Umgekehrt überprüft unserialize() die Anwesenheit einer Funktion mit dem magsichen Namen __wakeup. Falls anwesend kann diese Funktion alle Resourcen die das Objekt haben könnte wiederherstellen.

Der beabsichtigte Zweck von __wakeup ist es, alle Datenbankverbindungen wiederherzustellen die während der Serialisierung verloren gegangen sein könnten oder auch andere Aufgaben zur erneuten Initialisierung.

Beispiel #1 Sleep und wakeup Beispiel

`<?php
class Connection {
protected $link;
private $server, $username, $password, $db;
public function __construct($server, $username, $password, $db)
{
$this->server = $server;
$this->username = $username;
$this->password = $password;
$this->db = $db;
$this->connect();
}
private function connect()
{
$this->link = mysql_connect($this->server, $this->username, $this->password);
mysql_select_db($this->db, $this->link);
}
public function __sleep()
{
return array('server', 'username', 'password', 'db');
}
public function __wakeup()
{
$this->connect();
}
}
?>`

### __toString

Die __toString Methode erlaubt einer Klasse zu entscheiden wie sie reagieren will, wenn Sie in eine Zeichenkette umgewandelt wird.

Beispiel #2 Einfaches Beispiel

`<?php
// Deklariere eine einfache Klasse
class TestClass
{
public $foo;
public function __construct($foo) {
$this->foo = $foo;
}
public function __toString() {
return $this->foo;
}
}
$class = new TestClass('Hallo');
echo $class;
?>`

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    Hallo

Es muss angemerkt werden, dass die __toString Methode in Versionen vor PHP 5.2.0 nur in direkter Kombination mit echo() oder print() aufgerufen wurde. Beginnend mit PHP 5.2.0 erfolgt dieser Aufruf in jedem Stringkontext (z.B. in printf() mit %s Platzhalter) aber in keinem der anderen Typenkontexte (z.B. mit dem %d Platzhalter). Ebenfalls beginnend mit PHP 5.2.0 bewirkt die Umwandlung eines Objekts ohne __toString Metohde in einen String einen Fehler der Klasse `E_RECOVERABLE_ERROR`.

### __set_state

Dieses statische Methode wird seit PHP 5.1.0 für Klassen aufgerufen, die mittels var_export() exportiert werden.

Der einzige Parameter dieser Methode ist ein Array, welches aus exportierten Eigenschaften der Form array('Eigenschaft' => Wert, ...) besteht.

Beispiel #3 Using __set_state (since PHP 5.1.0)

`<?php
class A
{
public $var1;
public $var2;
public static function __set_state($an_array) // As of PHP 5.1.0
{
$obj = new A;
$obj->var1 = $an_array['var1'];
$obj->var2 = $an_array['var2'];
return $obj;
}
}
$a = new A;
$a->var1 = 5;
$a->var2 = 'foo';
eval('$b = ' . var_export($a, true) . ';'); // $b = A::__set_state(array(
// 'var1' => 5,
// 'var2' => 'foo',
// ));
var_dump($b);
?>`

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    object(A)#2 (2) {
      ["var1"]=>
      int(5)
      ["var2"]=>
      string(3) "foo"
    }

Pattern
Final Schlüsselwort
Klassen und Objekte (PHP 5)
PHP Manual