====== 1.12.4) PHP-Dateien einbinden mit include und require ====== Manchmal ist es sinnvoll, wenn Sie selbst definierte Funktionen in eine separate PHP-Datei auslagern, um sie in mehreren Skripten nutzen zu können. Mithilfe der ''include''- bzw. ''require''-Anweisung können Sie Dateien, z.B. Funktionen, die Sie benötigen, in Ihr PHP-Programm einbinden. ===== Mit include und require arbeiten ===== Die ''include()''- bzw. die ''require()''-Anweisung binden eine bestimmte Datei, deren Pfad als Argument übergeben wird, in den aktuellen Programmcode ein. **Unterschiede zwischen include und require** Der Unterschied zwischen den beiden Anweisungen zeigt sich, wenn eine Datei fehlerhaft eingebunden wurde: * Wenn beispielsweise die angegebene Datei nicht vorhanden ist, erzeugt ''include()'' eine Warnung. Das Skript wird weiter ausgeführt. * Der Befehl ''require()'' beendet bei einer fehlenden Datei das Skript sofort mit einer Fehlermeldung. **Syntax und Bedeutung der include()- und require()-Anweisungen** * Die include- und require-Befehle erwarten als Parameter die einzubindende Datei. Befindet sich die Datei nicht im selben Ordner, muss der Pfad angegeben werden. * Beinhaltet die eingebundene Datei keinen PHP-Code, wird der Inhalt unverändert an den Browser weitergegeben und somit am Bildschirm dargestellt. * Ist in der Konfigurationsdatei ''php.ini'' im Bereich ''fopen wrappers'' die Option ''allow_url_fopen = on'' gesetzt, so können Sie auch einen URL als Parameter angeben. * Eingebundene Dateien, die eine Funktion mit Rückgabewert enthalten, werden ebenso behandelt wie Funktionen mit Rückgabewert. So kann z. B. der Rückgabewert in einer Variablen gespeichert werden mit: $variable = include(Datei) . Innerhalb der eingebundenen Dateien muss der PHP-Code von gültigen PHP-Tags '''' umschlossen sein. Befindet sich kein PHP-Code in den Dateien, können die Tags weggelassen werden. Um Skripte, die später in einen PHP-Code eingebunden werden sollen, zu kennzeichnen, ist es empfehlenswert, die Dateierweiterung ''.inc.php'' zu vergeben. Die Bezeichnung ''.inc.php'' steht hierbei für die Abkürzung von include. ===== Datei mit include() einbinden ===== **Beispiel:** include.php Zur Veranschaulichung der Arbeitsweise der include()-Anweisung erstellen Sie ein Loginverfahren. Die Prüfung, ob der eingegebene Nickname und das Kennwort korrekt sind, wird in die Datei ''prueflogin.inc'' codiert. Vom Loginformular ''formular_login.html'' wird die Datei ''include.php'' aufgerufen. **Datei: include.php**




  Loginergebnis über include 
 Nun wird ein PHP-Skript eingebunden:";
  echo "Die Rückgabe der Datei ergibt:
";
  include ("prueflogin.inc");
  echo "Hier können weitere Anweisungen der Datei include.php ausgeführt
  werden.";
 ?>

Die ''include()''-Anweisung bindet die Datei ''prueflogin.inc'' ein. **Datei: prueflogin.inc** Innerhalb der Datei prueflogin.inc wird die Kennwortprüfung vorgenommen.

{{:inf:inf7b_201011:php:php5-s63.jpg?400|Auszeige der Beispieldatei "include.inc.php"}}