DokumentationCommerceInstallationsanleitung

Apache

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Experte
  • Admin
  • Entwickler

Adobe Commerce unterstützt Apache 2.4.x.

Apache erforderte Anweisungen

  1. Legen Sie AllowEncodedSlashes in der Serverkonfiguration (global) oder in den Konfigurationen des virtuellen Hosts fest, um zu vermeiden, dass die kodierten Schrägstriche dekodiert werden, die Probleme für URLs verursachen können. Wenn Sie beispielsweise Produkte mit einem Schrägstrich in der SKU über die API abrufen, soll dieser nicht konvertiert werden. Der Beispielblock ist nicht vollständig und andere Anweisungen sind erforderlich.

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

Apache-Neuschreibungen und HTML-Zugriff

In diesem Thema wird beschrieben, wie Sie Apache 2.4-Neuschreibungen aktivieren und eine Einstellung für die verteilte Konfigurationsdatei 1} festlegen..htaccess

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 1} festzulegen..htaccess

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

NOTE
Wenn Sie diese Einstellungen nicht aktivieren, werden in der Regel keine Stile auf der Storefront oder im Admin angezeigt.

  1. Aktivieren Sie das Apache-Rewrite-Modul:

    code language-bash 
    a2enmod rewrite

  2. Informationen dazu, wie Sie die Anwendung in die verteilte Konfigurationsdatei .htaccess einbinden können, finden Sie in den Richtlinien in der Dokumentation zu Apache 2.4 .

    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 Dokumentation zu Apache 2.4 .

  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 den Sie die Adobe Commerce-Software installieren. Um beispielsweise im Basisverzeichnis des Webservers zu installieren, bearbeiten Sie die Anweisung in <Directory /var/www>.
NOTE
Wenn diese Einstellungen nicht aktiviert werden, werden Stile normalerweise nicht auf der Storefront oder im Admin angezeigt.

Apache-erforderliche Module

Für Adobe Commerce müssen die folgenden Apache-Module installiert sein:

Überprüfen der Apache-Version

Geben Sie Folgendes ein, um die derzeit ausgeführte Apache-Version zu überprüfen:

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 rewrites und .htaccess.

Aktualisieren von Apache auf Ubuntu

So aktualisieren Sie auf Apache 2.4:

  1. Fügen Sie das Repository ppa:ondrej hinzu, das über Apache 2.4 verfügt:

    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, die dem Folgenden ähneln, sollten angezeigt werden:

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

  4. Aktivieren Sie rewrites und .htaccess.

Installieren von Apache unter CentOS

Für Adobe Commerce sind Neuschreibungen des Apache-Servers erforderlich. Sie müssen auch den Typ der Direktiven angeben, die in .htaccess verwendet werden können, mit dem die Anwendung Neuschreibungsregeln spezifiziert.

Die Installation und Konfiguration von Apache erfolgt in drei Schritten: Installieren Sie die Software, aktivieren Sie Neuschreibungen und geben Sie .htaccess -Anweisungen an.

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

    In Meldungen, die der folgenden ähneln, wird angezeigt, um zu 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
    Selbst wenn Apache 2.4 standardmäßig mit CentOS bereitgestellt wird, finden Sie Informationen zur Konfiguration im folgenden Abschnitt.

Aktivieren von Neuschreibungen und .htaccess für CentOS

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

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

  2. Suchen Sie den Block, der mit folgenden Begriffen beginnt:

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

  3. Ändern Sie den Wert von AllowOverride in 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 Sie diese Einstellungen nicht aktivieren, werden in der Regel keine Stile auf der Storefront oder im Admin angezeigt.

Aktivieren von Neuschreibungen und .htaccess für Ubuntu

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

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

  2. Suchen Sie den Block, der mit folgenden Begriffen beginnt:

    <Directory "/var/www/html">

  3. Ändern Sie den Wert von AllowOverride in 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 Sie beim Zugriff auf die Site auf 403 Verbotene Fehler stoßen, können Sie Ihre Apache-Konfiguration oder Ihre Konfiguration des virtuellen Hosts aktualisieren, um Besuchern die Website zu ermöglichen:

Beheben von 403 Verbotenen Fehlern für Apache 2.4

Um Website-Besuchern den Zugriff auf Ihre Site zu ermöglichen, verwenden Sie eine der Require instructions .

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