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 <?php … ?> 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.

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

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

Die include()-Anweisung bindet die Datei prueflogin.inc ein.

Datei: prueflogin.inc

Innerhalb der Datei prueflogin.inc wird die Kennwortprüfung vorgenommen.

<?php
if ($_POST["nickname"] == "Mario" && $_POST["kennwort"] == "geheim")
  echo "Zutritt erfolgt";
else
  echo "Zutritt erfolgt nicht";
?>

<tab>

PHP-Dateien einbinden mit include und require

Mit include und require arbeiten

Datei mit include() einbinden