php-homepage.de - Die deutschsprachige Ressource für PHP und MySQL- Manual

Autoloading

Viele Entwickler, die objektorientierte Anwendungen entwickeln, erzeugen eine eigene PHP Quelldatei für jede Klassendefinition. Eines der größten Ärgernisse ist die Notwendigkeit, eine lange Liste von benötigten Include-Anweisungen am Anfang eines jeden Skripts (eine für jede Klasse).

In PHP 5 ist das nicht länger notwendig. Man kann eine __autoload() Funktion definieren, die automatisch aufgerufen wird, falls man versucht eine noch nicht definierte Klasse oder ein nicht definiertes Interface zu benutzen. Durch den Aufruf dieser Funktion erhält die Scripting Engine einen letzten Versuch, die Klasse zu laden, bevor PHP unter Ausgabe einer Fehlermeldung scheitert.

Tipp

spl_autoload_register() bietet eine flexiblere Alternative zum automatischen Laden von Klassen an. Aus diesem Grund wird von der Verwendung von __autoload() abgeraten und diese Funktion könnte zukünftig als veraltet gekennzeichnet oder gar entfernt werden.

Hinweis:
Vor der Version 5.3.0 waren Exceptions, die in einer __autoload-Funktion geworfen wurden nicht in einem Catch- Block fangbar und führten zu einem fatalen Fehler. Seit 5.3.0+ können Exceptions, die in einer __autoload-Funktion geworfen wurden, unter der folgenden Bedingung in einem Catch-Block gefangen werden. Wenn eine selbst definierte Exception geworfen wird, so muss die Klasse dieser Exception bereits verfügbar sein. Die __autoload- Funktion darf rekursiv verwendet werden, um diese Exceptionklasse zu laden.

Hinweis:
Autoloading ist nicht verfügbar, wenn man PHP im CLI interaktiven Modus betreibt.

Hinweis:
Wird der Klassenname verwendet, z.B. in der Funktion call_user_func(), so ist zu beachten, dass er gefährliche Zeichen wie z.B. ../ enthalten kann. Es wird daher empfohlen keine Benutzereingaben an solche Funktionen weiterzugeben oder zumindest die Eingaben in __autoload() zu prüfen.

Beispiel #1 Autoload Beispiel

Dieses Beispiel versucht die Klassen MyClass1 und MyClass2 aus den entsprechenden Dateien MyClass1.php und MyClass2.php zu laden.


<?php
function __autoload($class_name) {
    include $class_name . '.php';
}

$obj  = new MyClass1();
$obj2 = new MyClass2(); 
?>

Beispiel #2 Weiteres Autoload Beispiel

Dieses Beispiel versucht das Interface ITest zu laden.


<?php

function __autoload($name) {
    var_dump($name);
}

class Foo implements ITest {
}
 
/*
string(5) "ITest"
 
Fatal error: Interface 'ITest' not found in ...
*/
?>

Beispiel #3 Autoloading mit Ausnahmebehandlung für 5.3.0+

In diesem Beispiel wird eine Exception geworfen und ein try/catch-Block demonstriert.


<?php
function __autoload($name) {
    echo "Möchte $name laden.\n";
    throw new Exception("Kann $name nicht laden.");
}

try {
    $obj = new NonLoadableClass();
} catch (Exception $e) {
    echo $e->getMessage(), "\n";
}
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Möchte NonLoadableClass laden.
Kann NonLoadableClass nicht laden.

Beispiel #4 Autoloading mit Ausnahmebehandlung für 5.3.0+ mit fehlender eigener Exception

In diesem Beispiel wird eine Exception geworfen für eine nicht ladbare eigene Exception.


<?php
function __autoload($name) {
    echo "Möchte $name laden.\n";
    throw new MissingException("Kann $name nicht laden.");
}

try {
    $obj = new NonLoadableClass();
} catch (Exception $e) {
    echo $e->getMessage(), "\n";
}
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Möchte NonLoadableClass laden.
Möchte MissingException laden.

Fatal error: Class 'MissingException' not found in testMissingException.php on line 4

Autoloading

Siehe auch