Abschnitt 10 · Lektion 6
Vorlagen einbinden
Oben und unten sehen deine Seiten alle gleich aus. Dieselbe Dokumenttyp-Angabe, derselbe Kopfbereich, dieselbe Navigationsleiste, derselbe Fußbereich, und nur das in der Mitte ist jedes Mal anders. Steht diese Hülle in jeder Datei, muss jede Änderung an ihr auch in jede Datei.
Wie es aussieht, wenn man es nicht tut
<?php
declare(strict_types=1);
// Achtung: In dieser Datei fehlt der dritte Menuepunkt. Jemand hat
// Kontakt spaeter dazugebaut und diese Seite uebersehen.
echo "<!doctype html>\n";
echo "<html lang=\"de\">\n";
echo "<head><meta charset=\"utf-8\"><title>Impressum</title></head>\n";
echo "<body>\n";
echo '<nav><a href="/">Start</a> | <a href="/impressum.php">Impressum</a></nav>' . "\n";
echo "<h1>Impressum</h1>\n";
echo "<p>Hofladen GmbH, Dorfstraße 1.</p>\n";
echo "<footer><p>Hofladen, 2026</p></footer>\n";
echo "</body></html>\n"; <?php
declare(strict_types=1);
echo "<!doctype html>\n";
echo "<html lang=\"de\">\n";
echo "<head><meta charset=\"utf-8\"><title>Kontakt</title></head>\n";
echo "<body>\n";
echo '<nav><a href="/">Start</a> | <a href="/impressum.php">Impressum</a> | <a href="/kontakt.php">Kontakt</a></nav>' . "\n";
echo "<h1>Kontakt</h1>\n";
echo "<p>Telefon 0123 456789.</p>\n";
echo "<footer><p>Hofladen, 2026</p></footer>\n";
echo "</body></html>\n"; <?php
declare(strict_types=1);
echo "<!doctype html>\n";
echo "<html lang=\"de\">\n";
echo "<head><meta charset=\"utf-8\"><title>Startseite</title></head>\n";
echo "<body>\n";
echo '<nav><a href="/">Start</a> | <a href="/impressum.php">Impressum</a> | <a href="/kontakt.php">Kontakt</a></nav>' . "\n";
echo "<h1>Startseite</h1>\n";
echo "<p>Frisches aus dem Hofladen.</p>\n";
echo "<footer><p>Hofladen, 2026</p></footer>\n";
echo "</body></html>\n"; In drei Dateien steht dieselbe Hülle dreimal. Klickst du dich im Browser durch alle drei, fällt es an der Navigationsleiste auf.
Auf dem Impressum fehlt der Menüpunkt Kontakt. Jemand hat die Kontaktseite später dazugebaut und nur zwei von drei Dateien angepasst. Sobald dasselbe an mehreren Stellen steht, geht früher oder später eine davon verloren. Bei drei Dateien merkst du es beim Durchklicken, bei fünfzehn merkt es ein Besucher.
include holt eine Datei herein
<!doctype html>
<html lang="de">
<head><meta charset="utf-8"><title><?= $titel ?></title></head>
<body>
<nav><a href="/">Start</a> | <a href="/impressum.php">Impressum</a> | <a href="/kontakt.php">Kontakt</a></nav> <footer><p>Hofladen, <?= date("Y") ?></p></footer>
</body>
</html> <?php
declare(strict_types=1);
$titel = "Impressum";
require "teile/kopf.php";
?>
<h1>Impressum</h1>
<p>Hofladen GmbH, Dorfstraße 1.</p>
<?php require "teile/fuss.php"; ?> <?php
declare(strict_types=1);
$titel = "Kontakt";
require "teile/kopf.php";
?>
<h1>Kontakt</h1>
<p>Telefon 0123 456789.</p>
<?php require "teile/fuss.php"; ?> <?php
declare(strict_types=1);
$titel = "Startseite";
require "teile/kopf.php";
?>
<h1>Startseite</h1>
<p>Frisches aus dem Hofladen. Die Hülle um diesen Absatz steht jetzt nur noch an einer Stelle.</p>
<?php require "teile/fuss.php"; ?> include "datei.php" nimmt den Inhalt der genannten Datei und führt ihn an dieser Stelle aus, als
stünde er dort. Gibt die Datei etwas aus, landet es in deiner Antwort. Definiert sie eine Funktion,
kannst du sie danach aufrufen.
require tut dasselbe. In den Beispielen steht schon diese Form, denn für Kopf und Fuß ist sie die
richtige. Worin sich die beiden unterscheiden, steht am Ende dieser Lektion.
Damit liegt die Hülle nur noch einmal herum. In teile/kopf.php steht alles bis zur
Navigationsleiste, in teile/fuss.php alles ab dem Fußbereich, und die eigentlichen Seiten
enthalten nur noch das, was sie voneinander unterscheidet. Kommt jetzt ein Menüpunkt dazu, änderst
du eine Stelle, und alle Seiten haben ihn.
Die drei Seiten sind gleich gebaut. Erst kommt ein PHP-Block, dann die eingebundene Hülle, dann der Inhalt als ganz normales Markup und am Ende der Fuß.
Die Dateien liegen dabei in einem Unterordner teile/, damit sie nicht zwischen den Seiten
herumliegen. Diesen Aufbau siehst du in Abschnitt 16 wieder, dann mit src/ für alles, was nicht
öffentlich sein soll.
Die eingebundene Datei sieht deine Variablen
Eine mit include geholte Datei landet im selben Gültigkeitsbereich wie die Zeile, die sie
einbindet. Sie sieht also alle Variablen, die dort schon gesetzt sind. Und was sie selbst setzt, ist
danach auch draußen da.
Im Beispiel nutzt kopf.php das aus. Es schreibt $titel in den Seitentitel, und gefüllt wird die
Variable von der Seite, die einbindet. Deshalb steht in jeder der drei Dateien vor dem require
eine Zeile $titel = ....
Bequem ist das, weil man nichts übergeben muss. Heikel ist es aus demselben Grund. Fehlt die Zeile,
meldet PHP Undefined variable $titel. Die Meldung steht dort, wo der Titel stehen sollte, im
Reiter Browser also als Seitentitel. Andersherum kann eine eingebundene Datei still eine Variable
setzen, die du weiter unten auch benutzt, und dann ist dein Wert überschrieben, ohne dass es
irgendwo steht. Solche Fehler sucht man lange, denn die Ursache liegt in einer Datei, die man beim
Lesen gar nicht aufgeschlagen hat. Eine saubere Lösung mit einer richtigen Übergabe kommt in Lektion
16.2.
require bricht ab, include macht weiter
<?php
declare(strict_types=1);
// Die Datei teile/preisliste.php gibt es nicht. Absicht: Hier soll
// der Unterschied zwischen den beiden Schluesselwoertern zu sehen
// sein, und zwar im Terminal auf beiden Kanaelen.
echo "Vor dem include\n";
include "teile/preisliste.php";
echo "Nach dem include: das Programm läuft weiter.\n";
require "teile/preisliste.php";
echo "Diese Zeile kommt nie an.\n"; Beide holen dieselbe Datei herein. Der Unterschied zeigt sich erst, wenn es sie nicht gibt. Dieses eine Beispiel läuft wieder als Skript im Terminal, wie in den Abschnitten davor. Auf einer Seite stünden beide Meldungen mitten im Text. Auf zwei getrennten Kanälen siehst du den Unterschied zwischen „weiter“ und „Schluss“ besser.
include meldet zwei Warnungen auf dem Fehlerkanal und läuft weiter. Im Beispiel steht die Zeile
danach also noch in der Ausgabe. require meldet ebenfalls, bricht dann aber mit einem Fatal error
ab, und die letzte Zeile kommt nie an. Auf einem Server würdest du davon nur die halbe Seite sehen,
denn ein Fatal error beendet die Anfrage und nicht den Server.
require nimmt man für alles, ohne das die Seite keinen Sinn ergibt, also für Kopf, Fuß,
Konfiguration und Klassen. include passt nur zu Beiwerk, das auch fehlen darf. Ein fehlender
Kopfbereich ergibt eine kaputte halbe Seite, und die ist schlimmer als eine ehrliche Fehlermeldung.
Daneben gibt es require_once, das dieselbe Datei nur beim ersten Mal einbindet. Für Kopf und Fuß
braucht es das nicht.
In der Aufgabe liegt die Hülle schon in zwei Dateien unter teile/, und die Seite soll sie von dort
holen.
Zum Mitnehmen
Kopf und Fuß stehen mit require in eigenen Dateien, und die eingebundene Datei sieht die Variablen der Seite, die sie einbindet. Fehlt die Datei, bricht require mit einem Fatal error ab, include warnt nur und macht weiter.
Jetzt du
Basis Konto, kostenlosZu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.
Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.
In diesem Kurs läuft dein Code auf einem Server. Dafür hat das Basis Konto 1 Stunde im Monat, mehr Zeit gibt es mit dem Premium Konto.
Was in dieser Lektion steckt
-
Artikel mit 3 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe, dein Code läuft auf einem Server
Öffnet sich mit dem Basis Konto.