DokumentationCommerceInstallationsanleitung

Apache

Last update: Mon Dec 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Experte
  • Admin
  • Entwickler

Adobe Commerce unterstützt Apache 2.4.x.

Erforderliche Anweisungen für Apache

  1. Legen Sie AllowEncodedSlashes in der Server-Konfiguration (global) oder in den virtuellen Host-Konfigurationen fest, um zu vermeiden, dass die kodierten Schrägstriche dekodiert werden, die zu Problemen bei URLs führen können. Wenn Sie beispielsweise Produkte mit einem Schrägstrich in der SKU über die API abrufen, möchten Sie dies nicht konvertiert haben. Der Musterblock ist nicht vollständig und andere Anweisungen sind erforderlich.

    code language-conf 
    <VirtualHost *:443>
  # Allow encoded slashes
  AllowEncodedSlashes NoDecode
</VirtualHost>

Apache-Neuschreibungen und HTTAccess

In diesem Thema wird beschrieben, wie Sie Apache 2.4-Neuschreibungen aktivieren und eine Einstellung für die .htaccess🔗 " Konfigurationsdatei“ angeben.

Adobe Commerce verwendet Server-Neuschreibungen und -.htaccess, um Anweisungen auf Ordnerebene für Apache bereitzustellen. Die folgenden Anweisungen sind auch in allen anderen Abschnitten dieses Themas enthalten.

Verwenden Sie diesen Abschnitt, um Apache 2.4-Neuschreibungen zu aktivieren und eine Einstellung für die verteilte Konfigurationsdatei .htaccess

Adobe Commerce verwendet Server-Neuschreibungen und -.htaccess, um Anweisungen auf Ordnerebene für Apache bereitzustellen.

NOTE
Wenn diese Einstellungen nicht aktiviert werden, werden in der Regel keine Stile in Ihrer Storefront oder in Ihrem Administrator angezeigt.

  1. Aktivieren Sie das Apache Rewrite-Modul:

    code language-bash 
    a2enmod rewrite

  2. Informationen dazu, wie Sie der Anwendung die Verwendung der Konfigurationsdatei für verteilte .htaccess ermöglichen, finden Sie in den Richtlinien in der Apache 2.4-Dokumentation.

    note tip
    TIP
    In Apache 2.4 ist die standardmäßige Site-Konfigurationsdatei des Servers /etc/apache2/sites-available/000-default.conf.

    Sie können beispielsweise Folgendes am Ende von 000-default.conf hinzufügen:

    code language-none 
    <Directory "/var/www/html">
    AllowOverride All
</Directory>
    note note
    NOTE
    Manchmal sind zusätzliche Parameter erforderlich. Weitere Informationen finden Sie in der Apache 2.4-Dokumentation.

  3. Wenn Sie die Apache-Einstellungen geändert haben, starten Sie Apache neu:

    code language-bash 
    service apache2 restart
    note note
    NOTE
    • Wenn Sie von einer früheren Apache-Version aktualisiert haben, suchen Sie zunächst in 000-default.conf nach <Directory "/var/www/html"> oder <Directory "/var/www">.
    • Sie müssen den Wert von AllowOverride in der Anweisung für den Ordner ändern, in dem Sie die Adobe Commerce-Software installieren möchten. Um beispielsweise die Installation im Stammverzeichnis des Webservers vorzunehmen, bearbeiten Sie die -Direktive in <Directory /var/www>.
NOTE
Wenn diese Einstellungen nicht aktiviert werden, werden Stile normalerweise nicht in der Storefront oder in der Admin-Benutzeroberfläche angezeigt.

Für Apache erforderliche Module

Adobe Commerce erfordert die Installation der folgenden Apache-Module:

Überprüfen der Apache-Version

Um die Apache-Version zu überprüfen, die Sie derzeit ausführen, geben Sie Folgendes ein:

apache2 -v

Das Ergebnis sieht in etwa wie folgt aus:

Server version: Apache/2.4.04 (Ubuntu)
Server built: Jul 22 2020 14:35:32

Installieren oder Aktualisieren von Apache auf Ubuntu

In den folgenden Abschnitten wird beschrieben, wie Sie Apache installieren oder aktualisieren:

  • Installieren von Apache
  • Aktualisieren Sie auf Apache 2.4 auf Ubuntu, um PHP 7.4 zu verwenden.

Installieren von Apache auf Ubuntu

So installieren Sie die Standardversion von Apache:

  1. Installieren von Apache

    code language-bash 
    apt-get -y install apache2

  2. Überprüfen Sie die Installation.

    code language-bash 
    apache2 -v

    Das Ergebnis sieht in etwa wie folgt aus:

    code language-none 
    Server version: Apache/2.4.18 (Ubuntu)
Server built: 2020-04-15T18:00:57

  3. Aktivieren Sie Umschreibungen und .htaccess.

Aktualisieren von Apache auf Ubuntu

So aktualisieren Sie auf Apache 2.4:

  1. Fügen Sie das ppa:ondrej-Repository hinzu, das Apache 2.4 enthält:

    code language-bash 
    apt-get -y update
    code language-bash 
    apt-add-repository ppa:ondrej/apache2
    code language-bash 
    apt-get -y update

  2. Installieren Sie Apache 2.4:

    code language-bash 
    apt-get install -y apache2
    note note
    NOTE
    Wenn der Befehl „apt-get install“ aufgrund von nicht erfüllten Abhängigkeiten fehlschlägt, konsultieren Sie eine Ressource wie https://askubuntu.com/.

  3. Überprüfen Sie die Installation.

    code language-bash 
    apache2 -v

    Meldungen ähnlich den folgenden sollten angezeigt werden:

    code language-none 
    Server version: Apache/2.4.10 (Ubuntu)
Server built: Jul 22 2020 22:46:25

  4. Aktivieren Sie Umschreibungen und .htaccess.

Installieren von Apache unter CentOS

Adobe Commerce erfordert Neuschreibungen des Apache-Servers. Sie müssen auch den Typ der Anweisungen angeben, die in .htaccess verwendet werden können. Die Anwendung verwendet diese Anweisungen, um Neuschreibungsregeln anzugeben.

Die Installation und Konfiguration von Apache ist im Grunde ein dreistufiger Prozess: die Software installieren, Rewrites aktivieren und .htaccess Anweisungen spezifizieren.

Installieren von Apache

  1. Installieren Sie Apache 2.4, falls noch nicht geschehen.

    code language-bash 
    yum -y install httpd

  2. Überprüfen Sie die Installation:

    code language-bash 
    httpd -v

    Es werden Meldungen ähnlich der folgenden angezeigt, die bestätigen, dass die Installation erfolgreich war:

    code language-none 
    Server version: Apache/2.4.40 (Unix)
Server built: Oct 16 2020 14:48:21

  3. Fahren Sie mit dem nächsten Abschnitt fort.

    note note
    NOTE
    Auch wenn Apache 2.4 standardmäßig mit CentOS bereitgestellt wird, lesen Sie den folgenden Abschnitt, um es zu konfigurieren.

Rewrites und .htaccess für CentOS aktivieren

  1. Öffnen Sie /etc/httpd/conf/httpd.conf Datei zur Bearbeitung:

    code language-bash 
    vim /etc/httpd/conf/httpd.conf`

  2. Suchen Sie den Block, der mit beginnt:

    code language-conf 
    <Directory "/var/www/html">

  3. Ändern Sie den Wert von AllowOverride auf All.

    Beispiel:

    code language-conf 
    <Directory "/var/www/">
  Options Indexes FollowSymLinks MultiViews
  AllowOverride All
  Order allow,deny
  Allow from all
</Directory>
    note note
    NOTE
    Die vorherigen Werte für Order funktionieren möglicherweise nicht in allen Fällen. Weitere Informationen finden Sie in der Apache-Dokumentation 2.4.

  4. Speichern Sie die Datei und beenden Sie den Texteditor.

  5. Um Apache-Einstellungen anzuwenden, starten Sie Apache neu.

    code language-bash 
    service apache2 restart
NOTE
Wenn diese Einstellungen nicht aktiviert werden, werden in der Regel keine Stile in Ihrer Storefront oder in Ihrem Administrator angezeigt.

Rewrites und .htaccess für Ubuntu aktivieren

  1. Öffnen Sie /etc/apache2/sites-available/default Datei zur Bearbeitung:

    code language-bash 
    vim /etc/apache2/sites-available/default

  2. Suchen Sie den Block, der mit beginnt:

    <Directory "/var/www/html">

  3. Ändern Sie den Wert von AllowOverride auf All.

    Beispiel:

    code language-conf 
    <Directory "/var/www/html">
  Options Indexes FollowSymLinks MultiViews
  AllowOverride All
  Order allow,deny
  Allow from all
</Directory>

  4. Speichern Sie die Datei und beenden Sie den Texteditor.

  5. Konfigurieren Sie Apache für die Verwendung des mod_rewrite Moduls:

    code language-bash 
    cd /etc/apache2/mods-enabled
    code language-bash 
    ln -s ../mods-available/rewrite.load

  6. Starten Sie Apache neu, um Änderungen anzuwenden:

    code language-bash 
    service apache2 restart

Beheben von 403-Fehlern (verboten)

Wenn beim Versuch, auf die Website zuzugreifen, 403 Fehler des Typs „Verboten“ auftreten, können Sie Ihre Apache-Konfiguration oder die Konfiguration Ihres virtuellen Hosts aktualisieren, um Besuchern die Website zu ermöglichen:

Beheben von 403-Fehlern (Verboten) für Apache 2.4

Damit Website-Besuchende auf Ihre Website zugreifen können, verwenden Sie eine der Require-Anweisungen.

Beispiel:

<Directory "/var/www/">
  Options Indexes FollowSymLinks MultiViews
  AllowOverride All
  Order allow,deny
  Require all granted
</Directory>
NOTE
Die vorherigen Werte für Order funktionieren möglicherweise nicht in allen Fällen. Weitere Informationen finden Sie in der Apache-Dokumentation.
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995