PHP Handbuch
Zurück	Kapitel 16. Kontroll-Strukturen	Weiter

require()

Die require() Anweisung bindet die angegebene Datei ein und wertet diese aus.

require() bindet die angegebene Datei ein und führt diese aus. Genaue Informationen wie die Einbindung funktioniert ist in der Dokumentation für include() beschrieben.

require() und include() sind in jeder Hinsicht gleichwertig mit der einen Ausnahme: der Umgang mit Fehlern. include() erzeugt ein Warning während require() in einem Fatal Error endet. Mit anderen Worten: scheuen Sie sich nicht, require() zu benutzen, wenn Sie möchten, dass eine fehlende Datei die Ausführung ihres Skripts beendet. include() verhält sich anders, ihr Skript wird weiterhin ausgeführt. Stellen Sie außerdem sicher, dass Sie einen gültigen include_path gesetzt haben.

Beispiel 16-2. Grundlegende require() Beispiele
<?php require 'prepend.php'; require $somefile; require ('somefile.txt'); ?>

Weitere Beispiele finden Sie in der Dokumentation zu include().

Anmerkung: Für frühere Versionen als PHP 4.0.2 gilt folgendes: require() wird immer versuchen die Zieldatei zu lesen, selbst wenn die Zeile in der die Anweisung steht, nie ausgeführt wird. Eine bedingte Anweisung hat keine Auswirkungen auf require(). Wenn jedoch die Zeile in der require() steht, nie ausgeführt wird, wird auch der Code der Zieldatei nie ausgeführt werden. Ähnliches gilt für Schleifenstrukturen, diese beeinflussen das Verhalten von require() nicht. Obwohl der Code, der in der Zieldatei enthalten ist, zur Schleife gehört, wird require() selbst nur einmal ausgeführt.

Anmerkung: Da dies ein Sprachkonstrukt und keine Funktion ist, deshalb können Sie dieses nicht mit Variablenfunktionen verwenden.

Warnung

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 include(), require_once(), include_once(), eval(), file(), readfile(), virtual() und include_path.