PHP
Referenzliste
include
Kontroll-Mechanismen
Befehl:
include()
Beschreibung:
Der include-Befehl hat zur Folge, dass vom PHP-Parsing-Modus in den HTML-Modus geschaltet und die angegebene Datei eingelesen und ausgewertet wird. Ist innerhalb der zu inkludierenden Datei PHP-Code, so muss dieser in gültigen PHP-Start- (<?PHP) und End-Tags (?>) eingebunden werden.
Bitte achten Sie darauf,dass Sie die gerade ausgeführte Datei nicht durch den include-Befehl erneut aufrufen, da es sonst zu einer Endlosschleife kommen kann.
Bitte achten Sie darauf,dass Sie die gerade ausgeführte Datei nicht durch den include-Befehl erneut aufrufen, da es sonst zu einer Endlosschleife kommen kann.
Aktiv in Version:
(PHP 4, PHP 5, PHP 7)
Tips:
Tips:
Dateien werden unter dem angegebenen Pfad gesucht, oder, wenn keiner gegeben ist, im include_path. Wenn die Datei auch im include_path nicht gefunden werden kann, sucht include noch in dem Verzeichnis der aufrufenden Datei und dem aktuellen Arbeitsverzeichnis. Wenn keine Datei gefunden wurde, erzeugt include eine Warnung, im Gegensatz dazu erzeugt require in diesem Fall einen Fatal Error.
Wenn ein Pfad angegeben ist — ob absolut (beginnend mit einem Laufwerksbuchstaben oder \ auf Windows oder / auf Unix/Linux) oder relativ (beginnend mit . oder ..), wird der include_path ignoriert. Wenn der Dateiname beispielsweise mit ../ beginnt, sucht der Parser im übergeordneten Verzeichnis des aktuellen Arbeitsverzeichnisses nach der Datei.
Achtung:
Sicherheits-Warnung:
Die entfernte Datei mag vom entfernten Server (je nach Konfiguration) geparst werden oder nicht, aber sie muss weiterhin ein gültiges PHP-Skript ausgeben, weil die Ausgabe auf dem lokalen Server als PHP ausgeführt wird. Wenn die Ausgabe des vom entfernten Server nur ausgegeben werden soll, ist readfile() die bessere Wahl. Andernfalls muss sehr gut acht gegeben werden, dass das entfernte Skript sicher gültigen und erwünschten Code ausgibt!
Warnung:
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.
include()
Eingabe:
Dies ist die Datei die �test.php� heisst.
Der Befehl welcher auf die �test.php� zugreift.
<?PHP echo 'Das ist nur ein Test'; ?>
Der Befehl welcher auf die �test.php� zugreift.
<?PHP include ( 'test.php' ); ?>
Ausgabe:
Das ist nur ein Test
include() - Beispiel 2:
Eingabe:
<?PHP /* Dieses Beispiel setzt voraus, dass www.example.com konfiguriert ist, * * .php-Dateien als PHP-Skripte zu interpretieren und .txt-Dateien * * nicht. Des Weiteren meint 'Funktioniert' hier, dass die Variablen * * $foo und $bar innerhalb der eingebundenen Datei verfügbar sind. */ // Funktioniert nicht; file.txt wird von www.example.com nicht als PHP interpretiert include 'http://www.example.com/file.txt?foo=1&bar=2'; // Funktioniert nicht; hier wird nach einer Datei mit dem Namen // 'file.php?foo=1&bar=2' im lokalen Dateisystem gesucht. include 'file.php?foo=1&bar=2'; // Funktioniert include 'http://www.example.com/file.php?foo=1&bar=2'; $foo = 1; $bar = 2; include 'file.txt'; // Funktioniert include 'file.php'; // Funktioniert ?>
Kontroll-Mechanismen