Wie aktiviere ich ein Apache2-Modul wie mod_rewrite?

1. Voraussetzungen und Vorbereitung
2. Modul aktivieren
3. Apache-Konfiguration anpassen
4. Apache neu starten
5. Überprüfung
6. Zusammenfassung

Um das Apache2-Modul mod_rewrite zu aktivieren, sind einige Schritte erforderlich, die sowohl die Konfiguration des Webservers als auch das System selbst betreffen. Dieses Modul ermöglicht das Umschreiben von URLs und ist essenziell für viele Webanwendungen, die "schöne" URLs oder komplexe Weiterleitungen nutzen.

Voraussetzungen und Vorbereitung

Zunächst sollten Sie sicherstellen, dass Sie Zugriff auf die Kommandozeile des Servers bzw. des Systems haben, auf dem Apache2 läuft. Die folgenden Anweisungen beziehen sich auf ein typisches Linux-basiertes System wie Ubuntu oder Debian. Stellen Sie außerdem sicher, dass Sie die nötigen Berechtigungen für administrative Befehle besitzen (z.B. via sudo).

Modul aktivieren

Um mod_rewrite zu aktivieren, verwenden Sie das Kommando a2enmod rewrite. Dieses Tool a2enmod steht für "Apache 2 enable module" und vereinfacht die Verwaltung der Module, indem es symbolische Links im Verzeichnis /etc/apache2/mods-enabled/ erstellt, die auf die Moduldateien in /etc/apache2/mods-available/ zeigen.

Öffnen Sie dazu ein Terminal und führen Sie den Befehl aus:

sudo a2enmod rewrite

Sie erhalten eine Bestätigung, dass das Modul aktiviert wurde.

Apache-Konfiguration anpassen

Das Modul ist zwar aktiviert, aber standardmäßig ist die Nutzung von mod_rewrite in den Verzeichnis- oder VirtualHost-Konfigurationen oft nicht erlaubt, da die AllowOverride-Direktive auf None gesetzt sein kann.

Öffnen Sie daher die relevante Apache-Konfigurationsdatei, zum Beispiel die Datei für Ihre Webseite in /etc/apache2/sites-available/000-default.conf oder eine andere virtuelle Host-Konfigurationsdatei.

Suchen Sie den Abschnitt <Directory /var/www/> oder den Pfad Ihres Webroots. Dort ändern Sie die Direktive AllowOverride von None auf All, damit .htaccess-Dateien und damit mod_rewrite-Regeln funktionieren:

<Directory /var/www/> Options Indexes FollowSymLinks AllowOverride All Require all granted</Directory>

Speichern Sie die Datei anschließend.

Apache neu starten

Damit die Änderungen wirksam werden, muss der Apache-Webserver neu gestartet oder zumindest neu geladen werden. Nutzen Sie dazu den Befehl:

sudo systemctl restart apache2

Alternativ können Sie auch sudo systemctl reload apache2 verwenden, wenn Sie keinen kompletten Neustart möchten.

Überprüfung

Um sicherzustellen, dass mod_rewrite aktiv ist, können Sie die Liste der geladenen Module mit folgendem Befehl anzeigen lassen:

apache2ctl -M | grep rewrite

Wenn rewrite_module (shared) angezeigt wird, ist das Modul erfolgreich aktiviert.

Zusammenfassung

Die Aktivierung von mod_rewrite erfolgt also durch den Befehl a2enmod rewrite, die Anpassung der AllowOverride-Direktive in der Apache-Konfiguration und den anschließenden Neustart des Apache-Dienstes. Danach steht Ihnen das Modul für URL-Umschreibungen uneingeschränkt zur Verfügung.