require_once()
Die require_once() Anweisung bindet eine Datei ein und wertet 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-Sourcecode enthalten ist.
Hinweis: require_once() steht ab PHP 4.01pl2 zur Verfügung.
Hinweis: 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.
Example#1 require_once() unterscheidet nicht zwischen Groß-/Kleinschreibung unter Windows
<?php
require_once("a.php"); // bindet a.php ein
require_once("A.php"); // bindet a.php auf Windows nochmal ein!
?>
PHP Versionen kleiner 4.3.0 für Windows, 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().