mitmario.dev

Logik und Ansicht trennen

PHP Sandbox 4 Min Lesezeit 4 BeispieleLektion 1 von 8

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

Eine Zahl zwischen zwei divs
<?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

Erst holen, dann rechnen, dann ausgeben
<?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

Die Vorlage kommt zu früh
<?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

Zwei Schreibweisen, dieselbe Ausgabe
<?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, 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 4 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.

  • Aufgabe, dein Code läuft auf einem Server

    Öffnet sich mit dem Basis Konto.