require_once()

Die require_once()-Anweisung bindet eine Datei ein und führt diese zur Laufzeit des Skripts aus. Das Verhalten ist ähnlich der require()-Anweisung mit dem einzigen Unterschied, dass einmal eingebundener Code aus einer Datei nicht nocht einmal eingebunden wird. Lesen Sie die Dokumentation zu require() um mehr Informationen über die Arbeitsweise dieser Anweisung zu erhalten.

require_once() sollten Sie in den Fällen benutzen, wenn die gleiche Datei in einem bestimmten Bereich mehrmals eingebunden und interpretiert werden soll und Sie sicher stellen wollen, dass diese Datei nur exakt einmal eingebunden wird, um Probleme mit Wiederholungen bei Funktions-Definitionen und Wertzuweisungen zu Variablen zu vermeiden, usw.

Weitere Beispiele zu require_once() und include_once() können Sie dem PEAR-Code entnehmen, welcher im aktuellsten PHP-Source-Code enthalten ist.

Anmerkung: require_once() steht ab PHP 4.01pl2 zur Verfügung.

Anmerkung: Beachten Sie, dass auf auf einem Betriebssystem, das nicht zwischen Groß- und Kleinschreibung unterschiedet (wie z.B. Windows) das Verhalten von require_once() und include_once() nicht unbedingt ihren Erwartungen entspricht.
Beispiel 12-8. require_once() und Groß-/Kleinschreibung
require_once("a.php"); // bindet a.php ein
require_once("A.php"); // bindet a.php auf Windows nochmal ein!

Warnung

Windows PHP Versionen, kleiner als PHP 4.3, erlauben den Zugriff auf Remote-Dateien mit dieser Funktion nicht, selbst wenn allow_url_fopen aktiviert ist.

Siehe auch: require(), include(), include_once(), get_required_files(), get_included_files(), readfile() und virtual().