Skip to content

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:

> curl -i http://localhost/php8-oct-2026/scripts-web/tax/version-12/Views/view-tax-calculation.php
HTTP/1.1 200 OK
Server: Apache/2.4.58
X-Powered-By: PHP/8.5.11
Vary: Accept-Encoding
Content-Length: 1017
Content-Type: text/html; charset=UTF-8

<br />
<b>Warning</b>:  Undefined variable $request in <b>.../php8-oct-2026/scripts-web/tax/version-12/Views/view-tax-calculation.php</b> on line <b>9</b><br />
<br />
<b>Warning</b>:  Undefined variable $content in <b>.../php8-oct-2026/scripts-web/tax/version-12/Views/view-tax-calculation.php</b> on line <b>9</b><br />
<br />
<b>Fatal error</b>:  Uncaught TypeError: getModelForThisView(): Argument #1 ($request) must be of type Symfony\Component\HttpFoundation\Request, null given, called in .../php8-oct-2026/scripts-web/tax/version-12/Views/view-tax-calculation.php on line 9 and defined in .../php8-oct-2026/scripts-web/tax/version-12/Views/view-tax-calculation.php:11
Stack trace:
#0 .../php8-oct-2026/scripts-web/tax/version-12/Views/view-tax-calculation.php(9): getModelForThisView(NULL, NULL)
#1 {main}
  thrown in <b>.../php8-oct-2026/scripts-web/tax/version-12/Views/view-tax-calculation.php</b> on line <b>11</b><br />

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:

> curl -i http://localhost/php8-oct-2026/scripts-console/tax/version-05/Data/database.json
HTTP/1.1 200 OK
Server: Apache/2.4.58
Last-Modified: Thu, 01 Oct 2026 15:46:08 GMT
ETag: "39f-65cc950791217"
Accept-Ranges: bytes
Content-Length: 927
Content-Type: application/json

{
    "dsn": "mysql:host=localhost;dbname=dbtaxes-2019;charset=utf8mb4",
    "id": "admtaxes",
    "pwd": "pwdtaxes",
    "tableBrackets": "tbbrackets",
    "colId": "id",
    "colLimits": "limits",
    "colCoeffR": "coeffr",
    "colCoeffN": "coeffn",
    "tableConstants": "tbconstants",
    "colHalfShareQfCeiling": "halfShareQfCeiling",
    "colSingleIncomeCeilingForReduction": "singleIncomeCeilingForReduction",
    "colCoupleIncomeCeilingForReduction": "coupleIncomeCeilingForReduction",
    "colHalfShareReductionValue": "halfShareReductionValue",
    "colSingleDiscountCeiling": "singleDiscountCeiling",
    "colCoupleDiscountCeiling": "coupleDiscountCeiling",
    "colSingleTaxCeilingForDiscount": "singleTaxCeilingForDiscount",
    "colCoupleTaxCeilingForDiscount": "coupleTaxCeilingForDiscount",
    "colTenPercentAllowanceMax": "tenPercentAllowanceMax",
    "colTenPercentAllowanceMin": "tenPercentAllowanceMin"
}

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:

scripts-web/tax/version-13
├── .htaccess
├── Config
│   ├── config.json
│   ├── database.json
│   └── vhost-tax-v13.conf
├── Controllers
│   └── (the secondary controllers of version 12)
├── Entities
│   ├── Action.php
│   ├── ControllerResult.php
│   ├── Database.php
│   ├── ResponseType.php
│   ├── Simulation.php
│   ├── TaxAdminData.php
│   └── TaxException.php
├── Logs
│   └── logs.txt
├── Model
│   ├── InterfaceServerBusiness.php
│   ├── InterfaceServerDao.php
│   ├── ServerBusiness.php
│   ├── ServerDao.php
│   └── ServerDaoWithSession.php
├── Responses
│   └── (the response classes of version 12)
├── Utilities
│   ├── Logger.php
│   ├── SendAdminMail.php
│   ├── Utilities.php
│   └── XmlUtilities.php
├── Views
│   └── (the views of version 12, without the logo)
└── public
    ├── Resources
    │   └── logo.jpg
    ├── index.php
    └── main.php
  • 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:

{
    "databaseFilename": "Config/database.json",
    "dependencies": [
        "Entities/TaxException.php",
        "Entities/TaxAdminData.php",
        "Entities/Database.php",
        "Utilities/Utilities.php",
        "Model/InterfaceServerDao.php",
        "Model/ServerDao.php",
        "Model/ServerDaoWithSession.php",
        "Model/InterfaceServerBusiness.php",
        "Model/ServerBusiness.php",
        "Utilities/Logger.php",
        "Utilities/SendAdminMail.php",
        "Utilities/XmlUtilities.php",
        "Entities/Simulation.php",
        "Entities/ControllerResult.php",
        "Entities/Action.php",
        "Entities/ResponseType.php",
        "Responses/InterfaceResponse.php",
        "Responses/ParentResponse.php",
        "Responses/JsonResponse.php",
        "Responses/XmlResponse.php",
        "Responses/HtmlResponse.php",
        "Controllers/InterfaceController.php",
        "Controllers/InitSessionController.php",
        "Controllers/AuthenticateUserController.php",
        "Controllers/CalculateTaxController.php",
        "Controllers/ListSimulationsController.php",
        "Controllers/DeleteSimulationController.php",
        "Controllers/EndSessionController.php",
        "Controllers/DisplayTaxCalculationController.php"
    ],
    "users": [
        {
            "login": "admin",
            "passwd": "admin"
        }
    ],
    "adminMail": {
        "smtp-server": "localhost",
        "smtp-port": 1025,
        "from": "guest@localhost",
        "to": "guest@localhost",
        "subject": "tax calculation server crash",
        "tls": false,
        "attachments": []
    },
    "logsFilename": "Logs/logs.txt",
    "redis": {
        "scheme": "tcp",
        "host": "127.0.0.1",
        "port": 6379
    },
    "views": {
        "view-authentication.php": [700, 221, 400],
        "view-tax-calculation.php": [200, 300, 341, 350, 800],
        "view-simulations-list.php": [500, 600]
    },
    "view-errors": "view-errors.php"
}
  • 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:

// PHP-Fehler werden nicht an den Client gesendet (sie gehen in das Log des Webservers)
ini_set("display_errors", "0");

// der Wurzelordner der Anwendung, übergeordnet zum Ordner [public]: die Pfade der Konfigurationsdatei sind relativ zu diesem Ordner
const ROOT_DIRECTORY = __DIR__ . "/..";
// Pfad der Konfigurationsdatei
const CONFIG_FILENAME = ROOT_DIRECTORY . "/Config/config.json";

// Autoloader von Composer (Symfony, Predis)
require_once ROOT_DIRECTORY . "/../../../vendor/autoload.php";
  • 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:

<?php
// Fragment: das obere Banner aller Views
// Modell: [$model->logo] (optional) - die URL des Logos, relativ zur URL der angezeigten Seite [public/main.php]
?>
<!-- Banner: ein hellgrauer Rahmen mit abgerundeten Ecken -->
<div class="p-4 my-4 bg-body-tertiary rounded-3">
    <div class="row align-items-center">
        <div class="col-md-4">
            <img src="<?= htmlspecialchars($model->logo ?? "Resources/logo.jpg") ?>" alt="Cherry tree in bloom">
        </div>
        <div class="col-md-8">
            <h1>Calculate your tax</h1>
        </div>
    </div>
</div>
  • 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]):

# Version 13: nur der Ordner [public] der Anwendung ist über das Web erreichbar
# (Apache 2.4 - das Modul [mod_rewrite] muss aktiv sein, was bei Laragon der Fall ist)

# keine Auflistung des Inhalts der Ordner
Options -Indexes

# URL-Rewriting: die Muster werden mit dem URL-Pfad relativ zum Ordner [version-13] verglichen
RewriteEngine On
# die URL des Ordners der Anwendung [.../version-13/] wird auf den Ordner [public] umgeleitet
# %1: der Pfad der angeforderten URL ohne das abschließende /, erfasst durch die Bedingung [RewriteCond]
RewriteCond %{REQUEST_URI} ^(.*)/$
RewriteRule ^$ %1/public/ [R=302,L]
# jede andere URL, die weder den Ordner [public] noch eine seiner Dateien bezeichnet, wird abgelehnt (403 Forbidden)
RewriteRule !^public(/|$) - [F]

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:

> curl -I http://localhost/php8-oct-2026/scripts-web/tax/version-13/Config/config.json
HTTP/1.1 403 Forbidden
Server: Apache/2.4.58
Content-Type: text/html; charset=iso-8859-1

> curl -I http://localhost/php8-oct-2026/scripts-web/tax/version-13/Views/view-tax-calculation.php
HTTP/1.1 403 Forbidden
Server: Apache/2.4.58
Content-Type: text/html; charset=iso-8859-1

> curl -I http://localhost/php8-oct-2026/scripts-web/tax/version-13/Logs/logs.txt
HTTP/1.1 403 Forbidden
Server: Apache/2.4.58
Content-Type: text/html; charset=iso-8859-1

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:

> curl -i "http://localhost/php8-oct-2026/scripts-web/tax/version-13/public/main.php?action=init-session&type=json"
HTTP/1.0 200 OK
Server: Apache/2.4.58
X-Powered-By: PHP/8.5.11
Cache-Control: max-age=0, private, must-revalidate
Set-Cookie: PHPSESSID=cf229e8b3c335cdf3e9e94f7919e8f9f; path=/
Cache-Control: no-cache, private
Connection: close
Content-Type: application/json; charset=utf-8

{"action":"init-session","status":700,"response":"session started with type [json]"}

> curl -I http://localhost/php8-oct-2026/scripts-web/tax/version-13/public/Resources/logo.jpg
HTTP/1.1 200 OK
Server: Apache/2.4.58
Last-Modified: Thu, 01 Oct 2026 16:39:23 GMT
ETag: "1410-65cca0eef010c"
Accept-Ranges: bytes
Content-Length: 5136
Content-Type: image/jpeg
  • 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:

> curl -I http://localhost/php8-oct-2026/scripts-web/tax/version-13/
HTTP/1.1 302 Found
Server: Apache/2.4.58
Location: http://localhost/php8-oct-2026/scripts-web/tax/version-13/public/
Content-Type: text/html; charset=iso-8859-1

> curl -I http://localhost/php8-oct-2026/scripts-web/tax/version-13/public/
HTTP/1.1 302 Found
Server: Apache/2.4.58
X-Powered-By: PHP/8.5.11
Location: main.php?action=init-session&type=html
Content-Type: text/html; charset=UTF-8
  • 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:

Image

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

Image

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:

# ein virtueller Apache-Host, dessen Document Root der Ordner [public] von Version 13 ist
# im Ordner [<laragon>/etc/apache2/sites-enabled] abzulegen (Pfade anpassen)
# die Anwendung ist dann unter der URL [http://localhost:8013/] erreichbar
Listen 8013
<VirtualHost *:8013>
    # das Document Root: nur der Inhalt von [public] ist über das Web erreichbar
    DocumentRoot "C:/laragon/www/php8-oct-2026/scripts-web/tax/version-13/public"
    <Directory "C:/laragon/www/php8-oct-2026/scripts-web/tax/version-13/public">
        # keine zu lesende [.htaccess]-Datei: die Konfiguration steht hier
        AllowOverride None
        Options -Indexes
        Require all granted
    </Directory>
</VirtualHost>
  • 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:

> curl -I http://localhost:8013/
HTTP/1.1 302 Found
Server: Apache/2.4.58
X-Powered-By: PHP/8.5.11
Location: main.php?action=init-session&type=html
Content-Type: text/html; charset=UTF-8

> curl "http://localhost:8013/main.php?action=init-session&type=json"
{"action":"init-session","status":700,"response":"session started with type [json]"}

> curl -I http://localhost:8013/Resources/logo.jpg
HTTP/1.1 200 OK
Server: Apache/2.4.58
Last-Modified: Thu, 01 Oct 2026 16:39:23 GMT
ETag: "1410-65cca0eef010c"
Accept-Ranges: bytes
Content-Length: 5136
Content-Type: image/jpeg

> curl -I http://localhost:8013/Config/config.json
HTTP/1.1 404 Not Found
Server: Apache/2.4.58
Content-Type: text/html; charset=iso-8859-1
  • 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.