Abschnitt 16 · Lektion 1
Logik und Ansicht trennen
Irgendwann macht eine Datei zu viel auf einmal. Man merkt es immer auf dieselbe Weise. Du suchst
eine Zahl, und du suchst sie zwischen zwei div.
Kopf und Fuß in eigene Dateien zu legen, kam schon in Lektion 10.6 vor. Danach war fünf Abschnitte lang keine Rede mehr davon, und das war Absicht. In einer Lektion über Cookies soll es um Cookies gehen. Jede zusätzliche Datei wäre dort nur eine Stelle mehr, an der du den Stoff suchen müsstest. Jetzt ist die Aufteilung selbst das Thema. Neues kommt kaum dazu. Es wird umgebaut, und die Seite im Reiter Browser sieht hinterher genauso aus wie vorher.
Woran man es merkt
<?php
declare(strict_types=1);
// Eine Seite, wie sie ganz von selbst entsteht: Gerechnet wird da, wo
// gerade Platz ist. Die Zeile, in der die Summe gebildet wird, steht
// mitten im Markup, zwischen zwei div.
?>
<!doctype html>
<html lang="de">
<head><meta charset="utf-8"><title>Kasse</title>
<style>body{font-family:system-ui,sans-serif;max-width:34rem;margin:2rem auto}
.karte{border:1px solid #ccc;border-radius:6px;padding:1rem}</style></head>
<body>
<h1>Offene Posten</h1>
<div class="karte">
<div class="zeile">
<?php
$db = new PDO("sqlite::memory:", null, null, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);
$db->exec("CREATE TABLE posten (kunde TEXT, betrag INTEGER, bezahlt INTEGER)");
$db->exec("INSERT INTO posten VALUES ('Mia', 1250, 0), ('Ben', 800, 1), ('Ida', 4990, 0)");
$zeilen = $db->query("SELECT kunde, betrag, bezahlt FROM posten")->fetchAll();
$summe = 0;
foreach ($zeilen as $zeile) {
if ($zeile["bezahlt"] === 0) {
$summe += $zeile["betrag"];
}
}
echo "Summe: <strong>" . number_format($summe / 100, 2, ",", ".") . " Euro</strong>\n";
?>
</div>
</div>
</body>
</html> An der Seite im ersten Beispiel ist erst mal nichts falsch. Sie zeigt an, was sie soll. Nur steht
die Datenbankabfrage mitten im Markup und die Schleife für die Summe gleich daneben. Willst du die
Rechnung ändern, liest du dich erst durch zwei div und ein style.
Solange die Datei zwanzig Zeilen hat, ist das kein Problem. Bei zweihundert schon, und dann fangen die typischen Fehler an. Man ändert die Ausgabe, und die Rechnung stimmt nicht mehr. Man will dieselbe Summe auf einer zweiten Seite zeigen und muss den Block kopieren. Man gibt die Datei an jemanden weiter, der nur das Aussehen ändern soll, und der stolpert über PDO.
Die Trennung in drei Schritte
<!doctype html>
<html lang="de">
<head><meta charset="utf-8"><title>Kasse</title>
<style>body{font-family:system-ui,sans-serif;max-width:34rem;margin:2rem auto}
.karte{border:1px solid #ccc;border-radius:6px;padding:1rem}</style></head>
<body>
<h1>Offene Posten</h1>
<div class="karte">
<div class="zeile">
Summe: <strong><?= $summeAlsText ?> Euro</strong>
</div>
</div>
</body>
</html> <?php
declare(strict_types=1);
// Dieselbe Seite, dieselbe Ausgabe, nur in drei Schritten. Von oben
// nach unten wird erst geholt, dann gerechnet, dann ausgegeben, und
// die Ausgabe steht nicht mehr hier.
// 1. Holen
$db = new PDO("sqlite::memory:", null, null, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);
$db->exec("CREATE TABLE posten (kunde TEXT, betrag INTEGER, bezahlt INTEGER)");
$db->exec("INSERT INTO posten VALUES ('Mia', 1250, 0), ('Ben', 800, 1), ('Ida', 4990, 0)");
$zeilen = $db->query("SELECT kunde, betrag, bezahlt FROM posten")->fetchAll();
// 2. Rechnen
$summe = 0;
foreach ($zeilen as $zeile) {
if ($zeile["bezahlt"] === 0) {
$summe += $zeile["betrag"];
}
}
$summeAlsText = number_format($summe / 100, 2, ",", ".");
// 3. Ausgeben
require __DIR__ . "/ansichten/kasse.php"; Im zweiten Beispiel steht dieselbe Seite noch einmal, mit derselben Ausgabe. Nur ist sie jetzt in drei Schritte geteilt, und die kommen immer in derselben Reihenfolge.
Zuerst wird geholt. Alles, was von außen kommt, steht ganz oben, egal ob aus der Datenbank, aus
$_GET oder aus einer Datei. Danach weißt du, womit die Seite arbeitet.
Dann wird gerechnet. Summen, Filter und Sortierungen gehören hierher, also alles, was aus den
Rohdaten das macht, was später auf der Seite stehen soll. Am Ende liegen fertige Werte bereit, im
Beispiel $summeAlsText.
Ausgegeben wird zuletzt, und zwar in einer anderen Datei. Den Teil einer Anwendung, der nur ausgibt,
nennt man die Ansicht (englisch view), daher der Ordner ansichten/. Jede Datei darin ist eine
Vorlage (englisch template). Die Vorlage ansichten/kasse.php bekommt die fertigen Werte und setzt
sie ein. Mehr tut sie nicht.
Stimmt die Zahl nicht, liegt der Fehler im mittleren Schritt. Sitzt etwas an der falschen Stelle, liegt er in der Vorlage. Und braucht eine zweite Seite dieselbe Vorlage, bindet sie dieselbe Datei einfach noch einmal ein.
Wenn die Vorlage zu früh kommt
<!doctype html>
<html lang="de">
<head><meta charset="utf-8"><title>Kasse</title>
<style>body{font-family:system-ui,sans-serif;max-width:34rem;margin:2rem auto}
.karte{border:1px solid #ccc;border-radius:6px;padding:1rem}</style></head>
<body>
<h1>Offene Posten</h1>
<div class="karte">
<div class="zeile">
Summe: <strong><?= $summeAlsText ?> Euro</strong>
</div>
</div>
</body>
</html> <?php
declare(strict_types=1);
// Dieselben drei Schritte, nur steht das Einbinden zu weit oben. Die
// Vorlage laeuft, bevor es die Summe als Text gibt, und PHP meldet das
// auf der Seite.
// 1. Holen
$db = new PDO("sqlite::memory:", null, null, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);
$db->exec("CREATE TABLE posten (kunde TEXT, betrag INTEGER, bezahlt INTEGER)");
$db->exec("INSERT INTO posten VALUES ('Mia', 1250, 0), ('Ben', 800, 1), ('Ida', 4990, 0)");
$zeilen = $db->query("SELECT kunde, betrag, bezahlt FROM posten")->fetchAll();
// 3. Ausgeben, aber zu frueh
require __DIR__ . "/ansichten/kasse.php";
// 2. Rechnen
$summe = 0;
foreach ($zeilen as $zeile) {
if ($zeile["bezahlt"] === 0) {
$summe += $zeile["betrag"];
}
}
$summeAlsText = number_format($summe / 100, 2, ",", "."); Im dritten Beispiel steht das require vor dem Rechnen. Die Vorlage läuft also, bevor es
$summeAlsText überhaupt gibt. Auf der Seite steht Summe:, dann statt der Zahl die Warnung
Undefined variable $summeAlsText mit der Vorlage als Datei und der Zeile 10, und dahinter Euro.
Gerechnet wird danach trotzdem noch. Nur ist die Seite da längst fertig.
Was in einer Vorlage nichts zu suchen hat
Eine Vorlage gibt aus und fragt nichts nach. Steht doch eine Abfrage darin, kannst du sie nicht mehr mit anderen Daten füllen, und du siehst auch nicht mehr auf einen Blick, wie viele Abfragen die Seite eigentlich macht. Der Klassiker ist eine Schleife, die pro Zeile noch einmal in die Datenbank geht. Bei zehn Zeilen fällt das nicht auf. Bei tausend sehr.
Alles, was nur entscheidet, wie etwas dasteht, gehört dagegen hinein. Also eine Schleife über die
fertigen Daten, ein if für die leere Liste und das Maskieren mit e().
Die Kurzsyntax
<ul>
<?php foreach ($namen as $name) { ?>
<li><?= e($name) ?></li>
<?php } ?>
</ul> <ul>
<?php foreach ($namen as $name): ?>
<li><?= e($name) ?></li>
<?php endforeach; ?>
</ul> <?php
declare(strict_types=1);
// Zweimal dieselbe Liste, zweimal dasselbe Ergebnis. Der Unterschied
// liegt nur darin, wie die Schleife geschlossen wird, und beide
// Vorlagen liegen in ansichten/. In einem Stapel Markup findet man
// endforeach schneller wieder als eine einzelne Klammer.
function e(?string $wert): string
{
return htmlspecialchars($wert ?? "", ENT_QUOTES, "UTF-8");
}
$namen = ["Milch", "Brot", "Zahnpasta"];
?>
<!doctype html>
<html lang="de">
<head><meta charset="utf-8"><title>Zwei Schreibweisen</title>
<style>body{font-family:system-ui,sans-serif;max-width:34rem;margin:2rem auto}</style></head>
<body>
<h2>Mit geschweiften Klammern</h2>
<?php require __DIR__ . "/ansichten/mit-klammern.php"; ?>
<h2>Mit endforeach</h2>
<?php require __DIR__ . "/ansichten/mit-endforeach.php"; ?>
</body>
</html> In einer Vorlage wechseln sich PHP und Markup ständig ab, und da nerven geschweifte Klammern. Die
schließende steht irgendwo weiter unten allein in ihrer Zeile, zwischen zwanzig Zeilen HTML, und man
sieht ihr nicht an, was sie schließt. Für Vorlagen gibt es deshalb eine zweite Schreibweise. Aus
foreach (...) { wird foreach (...):, und statt der schließenden Klammer steht endforeach;. Für
if heißt es endif;, für while endwhile; und für for endfor;.
Beide Vorlagen im Beispiel erzeugen exakt dieselbe Ausgabe. In einem gewöhnlichen Skript nehme ich
weiter die Klammern, in einer Vorlage endforeach.
In den Vorlagen steht außerdem <?= und nicht <?php echo. Das ist die Kurzform aus Lektion 1.3.
In einer Vorlage ist sie die Regel, denn dort wird in fast jeder Zeile ein Wert eingesetzt.
In der Aufgabe ziehst du den Ausgabeteil der Notizliste aus index.php in eine Vorlage um. Die
Datei dafür liegt schon bereit.
Zum Mitnehmen
Eine Vorlage gibt nur aus, was oben schon geholt und gerechnet ist. Kommt sie zu früh an die Reihe, fehlen ihr die Werte. Eine Datenbankabfrage hat in ihr nichts verloren, und statt einer einsamen schließenden Klammer liest sich dort endforeach besser.
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 4 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe, dein Code läuft auf einem Server
Öffnet sich mit dem Basis Konto.