24. Praktische Übung – Version 13
Version 13 bringt nur wenige Änderungen: Sie sichert den Zugriff auf die Dateien der Anwendung. Neue Funktionen kommen nicht hinzu: Die Aktionen, die JSON-, XML- und HTML-Antworten sowie die Views sind dieselben wie in Version 12. Geändert haben sich die Dateistruktur auf der Festplatte und die Konfiguration des Servers [Apache].
24.1. Das Problem
Im Kurs PHP 7 konnten Sie die URL der Konfigurationsdatei von Version 12 anfordern, und der Browser zeigte sie an. Diese Datei [config.json] enthält jedoch sensible Informationen, etwa die Zugangsdaten der Benutzer, die die Anwendung verwenden dürfen. Sie darf für Benutzer nicht zugänglich sein.
In unserer Version 12 ist diese Datei bereits geschützt: Sie befindet sich im Ordner [Data], dem die Datei [.htaccess] – eingeführt mit Version 8 – den Zugriff verwehrt (Direktive [Require all denied]). Dieser Schutz wird jedoch von Fall zu Fall angewendet: Wir sperren nur, was wir gezielt gesperrt haben, und alles andere wird ausgeliefert. Dabei gibt es noch vieles, was nicht angezeigt werden sollte. So kann der Browser beispielsweise direkt eine View anfordern, ohne den Hauptcontroller zu durchlaufen:
Die View wird ohne Kontext ausgeführt: Die Variablen, die normalerweise von der Klasse [HtmlResponse] bereitgestellt werden, existieren nicht. Da [Laragon] für die Entwicklung konfiguriert ist (PHP-Direktive [display_errors=On] ), werden Fehlermeldungen an den Browser gesendet. Sie verraten die Dateipfade auf dem Server sowie die Namen der verwendeten Funktionen und Klassen – alles nützliche Informationen für jeden, der die Anwendung angreifen möchte. Sekundäre Controller, Antwortklassen und die Klassen der Schichten [business] und [dao] können ebenfalls über eine einfache URL ausgeführt werden. Hier definieren sie lediglich eine Klasse, aber es gibt keine Garantie, dass das immer so bleibt.
Gravierender ist: Der gesamte Ordner [php8-oct-2026] des Kurses liegt im Ordner [www] von [Laragon]. Auch die Konsolenskripte sind über das Web erreichbar, obwohl niemand daran gedacht hat, sie zu schützen:
Jeder kann Benutzernamen und Passwort des Datenbankbenutzers [dbtaxes-2019] lesen. Die Server-Versionen 8 bis 12 verwenden jedoch diese Datei oder ihr Äquivalent.
Der richtige Ansatz ist der umgekehrte: Zunächst wird standardmäßig alles gesperrt, dann wird nur das ausdrücklich freigegeben, was von außen erreichbar sein muss. Für unsere Anwendung müssen nur drei Dateien zugänglich sein:
- [main.php], der Hauptcontroller, der alle Anfragen entgegennimmt;
- [index.php], der Einstiegspunkt der HTML-Anwendung, der auf [main.php] weiterleitet;
- das Bild [logo.jpg], das der Browser per HTTP-Anfrage abruft, wenn er das Banner der View anzeigt.
24.2. Die neue Verzeichnisstruktur
Wir kopieren den Ordner [scripts-web/tax/version-12] in [scripts-web/tax/version-13] und organisieren dann seine Dateien neu:
- nach [public], den einzigen Ordner, der über das Web zugänglich sein wird. Er enthält die beiden Skripte [index.php, main.php] und, im Ordner [Resources], das Bild [logo.jpg]. Der Name [public] ist der, den aktuelle PHP-Frameworks (Symfony, Laravel) für dieselbe Rolle verwenden;
- nach [Config], die Konfigurationsdateien: [config.json] (früher [Data/config.json]) und [database.json], die Datenbankkonfiguration, die in Version 8 aus dem Ordner [Data] übernommen wurde. Die Datei [vhost-tax-v13.conf] wird am Ende des Kapitels vorgestellt;
- nach [Logs], die Logdatei, die sich im Ordner [Data] befand;
- und nach [Model], die Klassen der Schichten [business] und [dao] des Servers. Bisher wurden sie aus den Ordnern der Versionen 8 und 9 geladen. Sie wurden nun in den Ordner der Version 13 kopiert, zusammen mit den Elementen [TaxException, TaxAdminData, Database] (Version 5) und den Hilfsklassen [Logger, SendAdminMail] (Version 9), [XmlUtilities] (Version 11) und [Utilities] (Version 5). Der Ordner [version-13] enthält somit die gesamte Anwendung: Er ist der einzige Ordner, der auf einen Produktionsserver kopiert würde, ohne auf Ordner anderer Versionen angewiesen zu sein;
- der Ordner [Tests] aus Version 12, der die Testseiten für die Views enthielt, wird nicht übernommen: Diese Seiten wären über das Web ohnehin nicht mehr erreichbar.
Die Namen dieser Dateien ändern sich nicht, ebenso wenig ihr Inhalt, mit drei Ausnahmen, die wir gleich besprechen. Nur die Composer-Bibliothek [vendor] bleibt an ihrem ursprünglichen Ort, im Stammverzeichnis des Ordners [php8-oct-2026].
24.3. Codeänderungen
24.3.1. Die Konfigurationsdatei
Die Datei [Config/config.json] sieht dann wie folgt aus:
- Zeile 2: Die Datenbank-Konfigurationsdatei befindet sich nun im Ordner [Config] der Anwendung;
- Zeilen 3–33: Alle Anwendungsdateien liegen in den Ordnern der Version 13. Die Pfade sind relativ zum Stammordner der Anwendung, dem Ordner [version-13];
- Zeile 49: Die Logdatei befindet sich im Ordner [Logs].
24.3.2. Der Hauptcontroller [public/main.php]
Der Hauptcontroller wurde in den Ordner [public] verschoben. Nur zwei Zeilen haben sich geändert:
- Zeile 18: Die Konstante [ROOT_DIRECTORY] verweist weiterhin auf den Stammordner der Anwendung, relativ zu dem die Pfade in der Datei [config.json] definiert sind. Da sich das Skript nun im Ordner [public] befindet, ist dieser Stammordner der übergeordnete Ordner von [__DIR__]. Sie können nicht [dirname(__DIR__)] schreiben: Der Wert einer mit [const] deklarierten Konstante muss ein konstanter Ausdruck sein, und ein Funktionsaufruf ist keiner. Die Verkettung von [__DIR__] (einer Konstante) und einem String ist ein konstanter Ausdruck;
- Zeile 20: der neue Pfad zur Konfigurationsdatei;
- Zeile 23: Diese Zeile ändert sich nicht: Der Pfad zum Composer-Loader ist relativ zum Stammverzeichnis der Anwendung, das immer [scripts-web/tax/version-13] ist.
Das Skript [public/index.php] ist das aus Version 12. Seine Weiterleitung auf die URL mit relativem Pfad über [main.php?action=init-session&type=html] bleibt korrekt, da sich [index.php] und [main.php] im selben Ordner befinden.
24.3.3. Das Banner der Views
Die Views bleiben im Ordner [Views], außerhalb des Ordners [public]: Sie werden von der Klasse [HtmlResponse] über einen Festplattenpfad eingebunden ([__DIR__ . "/../Views/$view"]) und nicht vom Browser angefordert. Nur das Fragment [v-banner.php] ändert sich, weil das Logo verschoben wurde:
- Zeile 9: Die URL des Logos ist relativ zur URL der angezeigten Seite, die immer die des Hauptcontrollers ist, [.../version-13/public/main.php]. Der Browser fordert daher die URL [.../version-13/public/Resources/logo.jpg] an.
24.4. Die Datei [.htaccess] der Anwendung
Mit [Laragon] ist das Dokumentenstammverzeichnis des Servers [Apache] (Direktive [DocumentRoot]) der Ordner [www]. Daher ist alles unterhalb von [www] über eine URL erreichbar, insbesondere der gesamte Ordner [version-13]. Um den Zugriff auf alles zu beschränken, was nicht im Ordner [public] liegt, verwenden wir eine einzige Datei [.htaccess] im Stammordner der Anwendung, im Ordner [version-13]. Beachten Sie, dass die Direktiven einer Datei [.htaccess] für den Ordner gelten, der sie enthält, und für alle seine Unterordner. [Laragon] konfiguriert [Apache] so, dass diese Dateien gelesen werden (Direktive [AllowOverride All]):
Kommentare
- Zeile 5: Wenn eine URL einen Ordner angibt, der kein Standarddokument ([index.php], [index.html]) besitzt, kann [Apache] die Liste der Dateien im Ordner anzeigen. Die Direktive [Options -Indexes] verhindert das;
- Zeile 8: Wir verwenden das Modul [mod_rewrite] von [Apache], das Modul zum Umschreiben von URLs, das in [Laragon] standardmäßig aktiviert ist. Eine Regel [RewriteRule] hat die Form [RewriteRule pattern substitution [options]]. In einer Datei [.htaccess] wird das Muster – ein regulärer Ausdruck – mit dem Pfad der angeforderten URL verglichen, und zwar relativ zum Verzeichnis der Datei [.htaccess]. Für die URL [http://localhost/php8-oct-2026/scripts-web/tax/version-13/Config/config.json] lautet dieser Pfad [Config/config.json];
- Zeilen 11–12: Die erste Regel verarbeitet die URL des Anwendungsordners [.../version-13/], dessen relativer Pfad leer ist (Muster: [^$]). Sie leitet den Browser (Option [R=302]) auf den Ordner [public] um und beendet die Verarbeitung der Regeln (Option [L], für „last“). Die Substitution muss ein vollständiger URL-Pfad sein: Er wird aus der Variablen [REQUEST_URI] von [Apache] gewonnen, dem Pfad der angeforderten URL [/php8-oct-2026/scripts-web/tax/version-13/]. Die der Regel vorangehende Bedingung [RewriteCond] vergleicht diese Variable mit dem regulären Ausdruck [^(.*)/$]: Der Teil in Klammern – der Pfad ohne den abschließenden Schrägstrich – steht dann in der Regel unter dem Namen [%1] zur Verfügung. So hängt die Datei [.htaccess] nicht vom Speicherort der Anwendung im Ordner [www] ab;
- Zeile 14: Die zweite Regel gilt für jede URL, deren relativer Pfad nicht mit [public/] beginnt und nicht genau [public] lautet: Das bedeutet das [!] vor dem Muster. Die Substitution [-] bedeutet „keine Substitution“, und die Option [F] (für „forbidden“) veranlasst [Apache], mit dem Code [403 Forbidden] zu antworten. Die URL [.../version-13/public] ohne abschließenden Schrägstrich muss erlaubt bleiben: [Apache] (Modul [mod_dir]) antwortet darauf mit einer Weiterleitung auf [.../version-13/public/].
Diese Datei blockiert auch den Zugriff auf sich selbst: Sie befindet sich nicht im Ordner [public]. Da der Pfad einer URL von [Apache] normalisiert wird, bevor die Regeln angewendet werden, wird auch eine URL wie [.../version-13/public/../Config/config.json] abgelehnt.
Der Kurs PHP 7 legte in jedem der zu schützenden Ordner eine Datei [.htaccess] mit den beiden Zeilen [order deny,allow] und [deny from all] ab. Das ist die Syntax von [Apache] 2.2. [Apache] 2.4 akzeptiert sie nur noch über das Kompatibilitätsmodul [mod_access_compat], dessen Abschaffung geplant ist. Die Syntax für [Apache] 2.4 lautet [Require all denied], die wir seit Version 8 verwenden.
Wenn Sie das Modul [mod_rewrite] nicht verwenden möchten, gibt es eine mögliche Alternative mit zwei Dateien [.htaccess] und der Syntax [Require]:
- im Ordner [version-13] eine Datei namens [.htaccess] mit nur der Zeile [Require all denied]: Alles ist verboten;
- im Ordner [public] eine Datei namens [.htaccess] mit nur der Zeile [Require all granted]: Die Zugriffseinstellungen eines Unterordners überschreiben die des übergeordneten Ordners, und der gesamte Inhalt von [public] ist erlaubt.
Diese Variante funktioniert ebenfalls, aber der Zugriff auf die URL [.../version-13/] wird dann verweigert, statt auf den Ordner [public] weitergeleitet zu werden.
24.4.1. [curl]-Tests
Anwendungsdateien außerhalb des Ordners [public] werden abgelehnt:
Der Code [403 Forbidden] entspricht der zweiten Regel. Beachten Sie, dass die View [view-tax-calculation.php] nicht einmal ausgeführt wurde. Die Dateien im Ordner [public] werden ausgeliefert:
- Zeilen 1–11: Der Hauptcontroller antwortet normal: Die JSON-Sitzung wird gestartet;
- Zeilen 13–20: Das Logo wird ausgeliefert (Typ [image/jpeg]).
Schließlich wird die URL der Anwendung auf den Ordner [public] umgeleitet, dessen Skript [index.php] seinerseits auf den Hauptcontroller weiterleitet:
- Zeile 4: die Weiterleitung der ersten Regel in der Datei [.htaccess];
- Zeile 11: die Weiterleitung durch das Skript [public/index.php].
In einem Browser lautet die URL, die die HTML-Anwendung startet, nun [http://localhost/php8-oct-2026/scripts-web/tax/version-13/]. Nach den beiden Weiterleitungen erscheint die Authentifizierungsseite samt Logo:

Die Anwendung funktioniert genauso wie die in Version 12. Hier ist der Bildschirm der Steuerberechnung nach einer Simulation:

Die URL, die die Clients für JSON und XML anfordern, hat sich geändert: Der Hauptcontroller ist nun [.../version-13/public/main.php]. Um den JSON-Client aus Version 12 mit dem Server der Version 13 zu verwenden, ändern Sie einfach den Schlüssel [urlServer] in seiner Konfigurationsdatei.
24.5. In der Produktion: Das Dokumentenstammverzeichnis ist der Ordner [public]
Die Datei [.htaccess] ist eine Lösung, die auf [Laragon] zugeschnitten ist, wo ein einziger Ordner, [www], mehrere Anwendungen enthält. Auf einem Produktionsserver ist das Vorgehen anders: Der Ordner [public] wird zum Dokumentenstammverzeichnis der Website gemacht. Der Rest der Anwendung liegt dann außerhalb der Verzeichnisstruktur der Website: Keine URL kann darauf zugreifen, und es sind keine Regeln nötig. Diese Organisation wird von den PHP-Frameworks empfohlen.
Mit [Apache] definieren Sie dazu einen virtuellen Host, d. h. eine zusätzliche Website, die vom selben Server [Apache] bereitgestellt wird. Die Datei [Config/vhost-tax-v13.conf] liefert ein Beispiel:
- Zeile 4: [Apache] lauscht auch auf Port 8013. Ein virtueller Host lässt sich von anderen durch seinen Port unterscheiden, wie hier gezeigt, oder durch seinen Namen ([tax.test], zum Beispiel). Die Verwendung des Ports erspart es, einen neuen Hostnamen zu deklarieren;
- Zeilen 5–14: Die Konfiguration des virtuellen Hosts, der auf Anfragen an Port 8013 antwortet;
- Zeile 7: Das Dokumentenstammverzeichnis dieser Website ist der Ordner [public] der Version 13. Die URL [http://localhost:8013/main.php] bezeichnet daher die Datei [public/main.php];
- Zeilen 8–13: Zugriffsrechte für den Ordner [public]. [AllowOverride None] teilt [Apache] mit, dass er nicht nach Dateien [.htaccess] suchen muss: Die gesamte Konfiguration steht hier, was auch schneller ist.
Legen Sie in [Laragon] eine solche Datei – mit angepassten Pfaden zum Installationsordner von [Laragon] – im Ordner [<laragon>/etc/apache2/sites-enabled] ab und starten Sie dann [Apache] im Fenster von [Laragon] neu (klicken Sie auf die Schaltfläche [Stop], dann auf die Schaltfläche [Start All] ). Sie erhalten dann:
- Zeilen 1–6: Die URL der Website wird vom Skript [public/index.php] bedient;
- Zeilen 8–9: Der Hauptcontroller antwortet normal;
- Zeilen 11–18: Das Logo wird ausgeliefert;
- Zeilen 20–23: Die Konfigurationsdatei wird nicht mehr abgelehnt; für den Webserver existiert sie schlicht nicht: Die Antwort lautet [404 Not Found]. Die Datei [.htaccess] im Ordner [version-13] wird nicht gelesen, da sie außerhalb des Dokumentenstammverzeichnisses liegt.
In beiden Fällen – ob mit [Laragon] und der Datei [.htaccess] oder mit einem virtuellen Host, dessen Wurzel der Ordner [public] ist – bleibt der Anwendungscode derselbe. Das ist der Vorteil der neuen Verzeichnisstruktur: Öffentliche Inhalte sind in einem einzigen Ordner gebündelt, und alles andere ist standardmäßig geschützt.