mitmario.dev

Das Vorhaben

PHP Sandbox 5 Min Lesezeit 2 BeispieleLektion 1 von 8

Ob Front Controller, Sitzung, Datenbank und Token auch zusammen funktionieren, weißt du erst, wenn sie in einer Anwendung gleichzeitig laufen. Einzeln hat jeder Baustein in seiner eigenen Lektion funktioniert. Hinter den nächsten fünf Aufgaben steht deshalb dieselbe Anwendung, und jede baut ein Stück davon.

Was am Ende dasteht

Am Ende steht eine Verwaltung für Lesezeichen da. Die Notizen bleiben in den Abschnitten davor, und ich nehme hier Lesezeichen, weil eine Adresse ihre eigene Falle mitbringt. Die Anwendung ist klein, aber vollständig. Du legst dir ein Konto an, meldest dich an, trägst Adressen ein, änderst und löschst sie wieder und durchsuchst sie. Angemeldet siehst du deine eigenen Lesezeichen und sonst keine. Wer nicht angemeldet ist, sieht gar nichts.

Das klingt nach wenig, und doch steckt darin, was eine Anwendung im Netz mit Daten tut. Sie nimmt Daten an, prüft sie, ordnet sie jemandem zu, speichert sie und gibt sie wieder aus.

Ab der Lektion „Anmeldung“ steht im Reiter Browser eine Seite, auf der du dich wirklich anmeldest, etwas einträgst und wieder löschst.

Die Ablage

Die Ordner der Anwendung
<?php

declare(strict_types=1);

// Die Ablage des Projekts, mit einem Satz zu jedem Eintrag.

$ablage = [
    "konfiguration.php" => "Was sich zwischen deinem Rechner und dem Server unterscheidet.",
    "oeffentlich/" => "Das einzige Verzeichnis, das der Webserver kennt.",
    "oeffentlich/index.php" => "Der Front Controller. Jede Anfrage kommt hier an.",
    "src/" => "Der Code. Von außen nicht erreichbar.",
    "src/funktionen.php" => "Die kleinen Helfer: maskieren, rendern, Routen vergleichen.",
    "src/LesezeichenSpeicher.php" => "Alles, was mit der Datenbank spricht. Und sonst nichts.",
    "src/routen.php" => "Welche Adresse zu welcher Funktion gehört.",
    "src/seiten.php" => "Je Adresse eine Funktion. Sie geben Text zurück, sie geben nichts aus.",
    "ansichten/" => "Die Vorlagen. Hier steht HTML und keine Abfrage.",
    "privat/" => "Die Datenbankdatei. Ebenfalls außerhalb der Dokumentwurzel.",
];

foreach ($ablage as $pfad => $zweck) {
    $tiefe = substr_count(rtrim($pfad, "/"), "/");
    $name = basename($pfad) . (str_ends_with($pfad, "/") ? "/" : "");

    echo str_repeat("    ", $tiefe), str_pad($name, 30 - $tiefe * 4), $zweck, "\n";
}

echo "\nDateien: ", count(array_filter(array_keys($ablage), fn (string $p) => !str_ends_with($p, "/"))), "\n";

Das ist die Struktur aus Lektion 16.7, nur mit anderen Namen darin. Zehn Einträge, und jeder hat seinen Grund:

  • oeffentlich/ ist das einzige Verzeichnis, das der Webserver kennt, und darin liegt eine einzige PHP-Datei. Alles andere kann der Server gar nicht ausliefern, auch wenn jemand die Adresse kennt.
  • src/ ist der Code, eine Datei für die Datenbank, eine für die Seiten, eine für die Routen und eine für die Helfer. Suchst du eine Zeile, weißt du nach dieser Aufteilung, wo du nachsehen musst.
  • ansichten/ ist das HTML. Dort steht keine Abfrage, dorthin kommen nur fertige Werte.
  • privat/ ist die Datenbankdatei. Auch sie liegt außerhalb der Dokumentwurzel, aus dem Grund aus Lektion 15.6. Läge sie im öffentlichen Ordner, könnte jeder sie herunterladen.

Der Weg einer Anfrage

Eine Anfrage von vorne bis hinten
<?php

declare(strict_types=1);

// Ein Front Controller in klein, und er schreibt mit, was er tut. Bei
// jedem Link bleiben die fuenf Stationen dieselben, nur die Werte darin
// aendern sich.

require __DIR__ . "/../src/stationen.php";

$pfad = parse_url($_SERVER["REQUEST_URI"], PHP_URL_PATH) ?: "";

notiere("1. Anfrage angekommen", $_SERVER["REQUEST_METHOD"] . " " . $pfad);

$routen = [
    "/" => "seiteStart",
    "/ueber" => "seiteUeber",
];

notiere("2. Routentabelle gelesen", count($routen) . " Einträge");

if (isset($routen[$pfad])) {
    notiere("3. Route gefunden", $routen[$pfad] . "()");
    $inhalt = $routen[$pfad]();
} else {
    http_response_code(404);
    notiere("3. Keine Route gefunden", "Statuscode 404");
    $inhalt = "<p>Diese Adresse kennt der Front Controller nicht.</p>";
}

notiere("4. Inhalt steht", strlen($inhalt) . " Bytes");
notiere("5. Vorlage drumherum", "und genau einmal ausgeben");

echo rendere($inhalt);

Im zweiten Beispiel steht die Anwendung im Kleinen. Zwei Seiten, keine Datenbank, aber dieselben fünf Stationen wie im fertigen Projekt, und jede davon steht in einer Tabelle auf der Seite. Klickst du im Reiter Browser auf die Links, kommen dieselben fünf Stationen mit anderen Werten.

Die Anfrage kommt an, der Front Controller liest die Routentabelle und sucht die passende Zeile, die gefundene Funktion baut den Inhalt, und ganz am Ende wird einmal ausgegeben. Die dritte Adresse gibt es nicht. Dort steht an Station drei „Keine Route gefunden“ und der Statuscode 404, den der Front Controller selbst setzt.

Diese Reihenfolge bleibt in allen fünf Aufgaben gleich. Es wachsen nur die Routentabelle und die Zahl der Funktionen dahinter. Eine neue Seite ist damit eine Zeile in src/routen.php, eine Funktion in src/seiten.php und, wenn sie eigenes HTML hat, eine Vorlage in ansichten/. Eine neue Abfrage ist eine Methode in src/LesezeichenSpeicher.php.

Was bewusst fehlt

Einiges kann die Anwendung mit Absicht nicht:

  • Passwort vergessen gibt es nicht, denn dafür bräuchte es E-Mail, und die lässt sich in einer Sandbox ohne Netz nicht zeigen.
  • Rechte gibt es nur an den eigenen Daten. Rollen, einen Verwalter oder geteilte Listen hat die Anwendung nicht, ein Lesezeichen gehört dir, oder es gehört dir nicht.
  • Seiten zu je zehn Einträgen, eine Sortierung nach Klick und Ordner fehlen auch. Jedes davon ist eine Übung wert, bringt aber nichts Neues bei, und zwei davon stehen in der Lektion „Bau dir was“ als Auftrag an der fertigen Anwendung.
  • Eine Fehlerseite für den Betrieb fehlt. Der Front Controller hat weder den Ausgabepuffer noch den Handler aus Abschnitt 16, und der Server dieses Kurses zeigt Fehler auf der Seite an. Solange du baust, steht ein Fehler so mit seiner Meldung da, statt hinter einer nichtssagenden 500 zu verschwinden. Auf einem Server im Netz gehört display_errors auf Off, wie es php.ini-production vorgibt, und dann gehören Puffer und Handler hinein.
  • Wie die Anwendung auf einen Server im Netz kommt, samt Git, HTTPS und Datensicherung, zeigt dieser Kurs nicht.

Wie die fünf Aufgaben laufen

Jede Aufgabe ist ein Arbeitsauftrag an derselben Anwendung, und jede steht für sich. Du bekommst die Anwendung in dem Zustand, den der Auftrag braucht, und baust ein Stück daran. Herüberretten musst du nichts aus einer früheren Lektion. Du kannst die fünf also auch in einer anderen Reihenfolge machen oder eine auslassen. Die Reihenfolge unten ist die, in der die Anwendung wächst, und deshalb liest sie sich so am besten.

In der nächsten Lektion entsteht die Datenbasis, also zwei Tabellen und die Klasse, die sie bedient. Das ist die einzige Aufgabe, die noch auf der Kommandozeile spielt. Danach kommt die Anmeldung, und ab da läuft die Anwendung im Reiter Browser. Dann folgen Anlegen und Anzeigen, Bearbeiten und Löschen samt der Frage, wem ein Eintrag eigentlich gehört, und als letzte Aufgabe die Suche. Zum Schluss steht die Anwendung in einer Lektion ohne Aufgabe noch einmal als Ganzes da, mit Vorschlägen, was sich an ihr weiterbauen lässt.

Im Editor liegen dabei nur die Datei, in der du arbeitest, und eine zum Nachsehen. Der Rest liegt im Dateibaum Dateien, also Konfiguration, Helfer, Routentabelle, Vorlagen und Front Controller. Sie laufen alle mit, und jede lässt sich aufmachen und lesen. Dort steht die Lösung der Lektionen davor in einer von mehreren möglichen Formen. Hast du eine Lücke anders gefüllt, ist sie deshalb nicht falsch.

Ab der Anmeldung steht am Ende jedes Aufgabentexts, was sich im Reiter Browser neu ausprobieren lässt. Extra starten musst du dafür nichts. Nach einem Klick auf Prüfen läuft die Anwendung in der Sandbox weiter und zieht bei jeder Änderung nach, genau wie nach einem Klick auf Sandbox starten. Tust du fünf Minuten lang nichts, endet die laufende Sandbox. Eine Minute vorher wird das angesagt, und mit Sandbox starten holst du sie zurück.

Zum Mitnehmen

Jede Anfrage läuft durch dieselben fünf Stationen, vom Front Controller bis zur einen Ausgabe. Die fünf Aufgaben ändern daran nichts, sie füllen Lücken in den Seitenfunktionen und in der Speicherklasse dahinter.

Jetzt du

Basis Konto, kostenlos

Im Editor änderst du die Beispiele dieser Lektion und lässt sie gleich laufen. So merkst du am schnellsten, ob es sitzt.

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 2 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.