Laragon: Sub-Domains einrichten

06.02.2025 15:46 von Ronald Boda

In der Praxis kommt es öfter vor, dass in einem Projekt Sub-Domains erforderlich sind. Dies in Laragon abzubilden, um Lokal entwickeln zu können ist kein Hexenwerk. Wir zeigen Euch hier, die notwendigen Schritte.

Wir setzten hier beispielhaft folgende Domain-Konfiguration um:

hauptdomain.local
sub1.hauptdomain.local

Apache Modul freischalten

Zuallererst muss die Apache-Konfiguration angepasst werden. Bearbeite über das Laragon-Menü Apache > httpd.conf die Datei httpd.conf.

Suche hier nach dieser Zeile:

#LoadModule vhost_alias_module modules/mod_vhost_alias.so

Entferne das "#" Zeichen am Beginn der Zeile, um das Modul zu aktivieren.

Domainkonfiguration

Erstelle als nächstes die Konfigurationsdateien für die erforderlichen Sub-Domains. Wechsle dazu in den Ordner laragon\etc\apache2\sites-enabled und erstelle die Datei sub1.hauptdomain.local.conf mit folgendem Inhalt

define ROOT "C:/laragon/www/hauptdomain/public"
define SITE "sub1.hauptdomain.local"

<VirtualHost *:80> 
    DocumentRoot "${ROOT}"
    ServerName ${SITE}
    ServerAlias *.${SITE}
    <Directory "${ROOT}">
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

<VirtualHost *:443>
    DocumentRoot "${ROOT}"
    ServerName ${SITE}
    ServerAlias *.${SITE}
    <Directory "${ROOT}">
        AllowOverride All
        Require all granted
    </Directory>

    SSLEngine on
    SSLCertificateFile      I:/laragon5/etc/ssl/laragon.crt
    SSLCertificateKeyFile   I:/laragon5/etc/ssl/laragon.key
 
</VirtualHost>

Lade den Apache-Server neu.

Hosts-Datei

Öffne nun in Deinem Windows-System die Datei C:\Windows\System32\drivers\etc\hosts mit einem Text-Editor und registriere die Subdomain mit folgendem Eintrag.

127.0.0.1    sub1.hauptdomain.local

Contao Seitenbaum

Nun kannst Du in Contao einen neuen Seitenbaum für die Subdomain anlegen und mit Inhalten befüllen.

Seine Subdomain ist nun unter sub1.hauptdomain.local erreichbar.

Hinweis

Bitte vergiss nicht, nach erfolgter Übersiedelung auf den Webspace den in der Root-Seite der Subdomain unter URL-Einstellungen eingetragenen Domainnamen (sub1.hauptdomain.local) zu aktualisieren!