Abschnitt 10 · Lektion 2
Die erste Seite
Im Terminal sieht ein Skript nur, wer es startet. Eine Seite soll dagegen jeder sehen, der ihre Adresse aufruft, und zwar mit dem Stand dieses Augenblicks. Dafür braucht es einen Webserver. Er lässt bei jeder Anfrage dein Skript laufen und verschickt dessen Ausgabe als Antwort. Was dabei herauskommt, siehst du ab jetzt im Reiter Browser.
Der eingebaute Webserver
PHP bringt seinen eigenen kleinen Webserver mit. Er wird für dich gestartet, sobald eine Lektion
einen braucht. Mit Sandbox starten oder dem Prüfen-Button steht der Befehl dafür im Terminal,
php -d display_errors=1 -S 127.0.0.1:3000 -t .. Das -S mit der Adresse dahinter macht aus php
einen Server. Das -d davor schaltet die Fehlermeldungen auf die Seite, dazu mehr in der
übernächsten Lektion.
-t . legt die Dokumentwurzel (englisch document root) fest, also den Ordner, in dem der Server
nach Dateien sucht. Alles darin ist von außen erreichbar, alles darüber nicht. Auf einem gemieteten
Hosting-Paket heißt dieser Ordner oft htdocs oder public_html. Die Idee ist dieselbe. Es gibt
einen Bereich, den der Server ausliefert, und alles andere bleibt privat. Ab Abschnitt 15 machst du
dir das zunutze.
Dieser eingebaute Server ist zum Entwickeln da und nicht für den Betrieb, denn er bearbeitet nur
eine Anfrage nach der anderen. Für einen Kurs und für deinen eigenen Rechner reicht das. Für eine
öffentliche Seite nimmt man Apache oder nginx, und am Code ändert sich dafür nichts, nur an der
Einstellung des Servers ein wenig. Auf deinem eigenen Rechner startest du denselben Server mit
demselben Befehl, getippt in dem Ordner, in dem die Dateien liegen. Die Seite steht dann im Browser
unter http://127.0.0.1:3000, und Strg+C im Terminal beendet den Server wieder.
Die Seite entsteht in dem Moment, in dem jemand fragt
<?php
declare(strict_types=1);
// Diese Datei ist keine HTML-Datei. Sie wird bei jedem Aufruf
// ausgefuehrt, und was sie ausgibt, geht als Antwort an den Browser.
$zeit = date("H:i:s");
$sachen = ["Kaffee", "Brot", "Äpfel"];
echo "<!doctype html>\n";
echo "<html lang=\"de\">\n";
echo "<head><meta charset=\"utf-8\"><title>Hofladen</title></head>\n";
echo "<body>\n";
echo "<h1>Hofladen</h1>\n";
echo "<p>Zusammengebaut um $zeit. Lade neu, dann steht hier eine andere Uhrzeit.</p>\n";
echo "<ul>\n";
foreach ($sachen as $sache) {
echo " <li>$sache</li>\n";
}
echo "</ul>\n";
echo "</body>\n";
echo "</html>\n"; Klickst du auf Seite neu laden, fragt der Browser den Server noch einmal, und die Uhrzeit auf der
Seite ändert sich. Dein Skript ist ein zweites Mal gelaufen, und date() hat einen neuen Wert
geliefert.
date() gibt den aktuellen Zeitpunkt in der gewünschten Form zurück. Welche Form, steht als
Buchstaben im Argument. H:i:s ist Stunde, Minute und Sekunde, Y das Jahr, N der Wochentag als
Zahl. Es gibt rund vierzig solche Buchstaben. Die schlägt man nach, statt sie zu lernen.
Eine HTML-Datei liegt fertig da und bleibt gleich, egal wie oft du sie lädst. Diese Seite gab es eine Sekunde vor deinem Aufruf noch nicht.
Im Terminal stehen dabei nur noch der Befehl, der den Server gestartet hat, und was der Server selbst zu melden hat. Deine Ausgabe geht jetzt in die Antwort, und die liest der Browser.
Zwei Wege, HTML auszugeben
<?php
declare(strict_types=1);
$zeit = date("H:i:s");
$sachen = ["Kaffee", "Brot", "Äpfel"];
// Der schliessende PHP-Tag schaltet PHP aus. Alles danach geht
// unveraendert hinaus, bis ein oeffnender PHP-Tag wieder einschaltet.
?>
<!doctype html>
<html lang="de">
<head>
<meta charset="utf-8">
<title>Hofladen</title>
</head>
<body>
<h1>Hofladen</h1>
<p>Zusammengebaut um <?= $zeit ?>. Dieselbe Seite, andere Schreibweise.</p>
<ul>
<?php foreach ($sachen as $sache) { ?>
<li><?= $sache ?></li>
<?php } ?>
</ul>
</body>
</html> Heraus kommt dieselbe Seite wie eben, nur anders geschrieben. Hier steckt nicht jede Zeile Markup in
einem echo. PHP wird mit dem schließenden PHP-Tag ausgeschaltet, und dann steht das Markup einfach
da. Die Kurzform aus Lektion 1.3 schaltet es für die einzelnen Werte kurz wieder ein.
Für längeres Markup gewinnt diese Form fast immer. Die Anführungszeichen im Markup musst du nicht
mehr maskieren, und der Editor färbt das HTML als HTML. Vor allem siehst du die Struktur der Seite,
statt sie dir aus lauter echo-Zeilen zusammenzudenken.
echo nehme ich für einzelne Zeilen, für etwas, das mitten in einer Rechnung entsteht, oder wenn
ich sowieso schon in einer Schleife stecke.
Die Schleife sieht erst mal komisch aus, denn ihr Rumpf steht zwischen zwei PHP-Blöcken. Die geschweiften Klammern gehören trotzdem zusammen, und PHP zählt sie über die PHP-Tags hinweg. Anders als ein HTML-Tag umschließt ein PHP-Tag nämlich nichts. Er schaltet PHP nur ein und aus.
Fehlt der schließende PHP-Tag vor dem Markup, ist PHP an dieser Stelle noch im Code, und als Code
ergibt <!doctype html> keinen Sinn. Statt der Seite steht dann im Reiter Browser ein Parse error,
syntax error, unexpected token "<", expecting end of file. Die Meldung kommt, bevor eine einzige
Zeile läuft. Deshalb steht sonst nichts auf der Seite.
Welche Datei beantwortet welche Adresse
<?php
declare(strict_types=1);
echo "<!doctype html>\n";
echo "<html lang=\"de\">\n";
echo "<head><meta charset=\"utf-8\"><title>Preise</title></head>\n";
echo "<body>\n";
echo "<h1>Preise</h1>\n";
echo "<p>Diese Antwort kommt aus preise.php.</p>\n";
echo "<p>Angefragt wurde: " . htmlspecialchars($_SERVER["REQUEST_URI"]) . "</p>\n";
echo "<p><a href=\"/\">Zurück zur Startseite</a></p>\n";
echo "</body>\n";
echo "</html>\n"; <?php
declare(strict_types=1);
echo "<!doctype html>\n";
echo "<html lang=\"de\">\n";
echo "<head><meta charset=\"utf-8\"><title>Hofladen</title></head>\n";
echo "<body>\n";
echo "<h1>Startseite</h1>\n";
echo "<p>Diese Antwort kommt aus index.php.</p>\n";
// Der Pfad kommt von aussen. htmlspecialchars macht Zeichen wie <
// darin unschaedlich, warum das noetig ist, zeigt die naechste Lektion.
echo "<p>Angefragt wurde: " . htmlspecialchars($_SERVER["REQUEST_URI"]) . "</p>\n";
echo "<p><a href=\"/preise.php\">Zu den Preisen</a></p>\n";
echo "<p><a href=\"/gibtsnicht\">Und hier liegt gar keine Datei</a></p>\n";
echo "</body>\n";
echo "</html>\n"; Der Pfad / nimmt die index.php, der Pfad /preise.php die Datei dieses Namens. Eine Adresse ist
hier ein Dateiname. Willst du eine Seite dazu, legst du eine Datei an, so wie auf klassischem
Hosting.
Der zweite Link auf der Startseite zeigt auf /gibtsnicht. Dort liegt keine Datei, und trotzdem
kommt eine Seite, denn der Server nimmt in diesem Fall wieder die index.php. Was angefragt wurde,
steht in $_SERVER["REQUEST_URI"], und die Seite gibt es aus.
Im Reiter Netzwerk steht nach jedem Klick die Anfrage, die er ausgelöst hat, mit Methode, Pfad und
Statuscode. Bei allen dreien ist es eine 200, auch bei /gibtsnicht. Für den Server war das kein
Fehler, denn er hat eine Datei gefunden, die antwortet. Dass es die Seite eigentlich nicht gibt,
weiß nur dein Programm. Wie es das mitteilt, kommt in der Lektion über Statuscodes.
Beim eingebauten Server landet also jeder Pfad ohne passende Datei auf der index.php, und der
echte Pfad bleibt lesbar. Mit PHP 8.3 oder älter auf deinem eigenen Rechner gilt das nur für Pfade
ohne Punkt im letzten Teil. Ein fehlendes /alt.php bekommt dort eine 404 vom Server selbst. Apache
und nginx brauchen dafür ein paar Zeilen Einstellung. Noch in diesem Abschnitt baust du daraus
mehrere Seiten aus einer einzigen Datei, und in Abschnitt 16 nimmt diese eine Datei jede Anfrage der
ganzen Anwendung an.
Was der Reiter Browser kann und was nicht
Er folgt Links, lädt Adressen aus der Adresszeile, lädt neu und geht zurück und vor wie jeder Browser. Ab Abschnitt 11 kommen Formulare dazu, ab 12 eine Anmeldung.
Nach dem Prüfen läuft der Server weiter. Jede Änderung im Editor kommt nach kurzer Zeit dort an. Tust du fünf Minuten lang nichts, endet die Sandbox, und mit Sandbox starten ist sie wieder da. Beim Prüfen startet der Server frisch. Was dein Code beim letzten Mal an Dateien angelegt hat, ist dann weg.
In der Aufgabe baust du eine Seite, die jeden Tag etwas anderes sagt.
Zum Mitnehmen
Der eingebaute Server von PHP gibt jede Anfrage an die passende Datei in der Dokumentwurzel und sonst an die index.php. Die Seite entsteht bei jedem Aufruf neu, und fehlt vor dem Markup der schließende PHP-Tag, steht statt ihr ein Parse error da.
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.