mitmario.dev

Vorlagen einbinden

PHP Sandbox 4 Min Lesezeit 3 BeispieleLektion 6 von 7

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

Dieselbe Hülle, dreimal getippt
<?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

Einmal schreiben, dreimal eingebunden
<?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

include warnt, require bricht ab
<?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, kostenlos

Zu 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.