DokumentationCommerceInstallationsanleitung

Apache

Last update: Thu Apr 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Experienced
  • Admin
  • Developer

Adobe Commerce unterstützt Apache 2.4.x.

Apache erforderte Anweisungen

  1. Satz AllowEncodedSlashes in der Server-Konfiguration (global) oder in den virtuellen Host-Konfigurationen, um zu vermeiden, die kodierten Schrägstriche zu dekodieren, 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 verteilte Konfigurationsdatei, .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, .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. Damit die Anwendung die verteilte .htaccess Konfigurationsdatei finden Sie die Richtlinien in der Dokumentation zu Apache 2.4.

    note tip
    TIP
    In Apache 2.4 lautet 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:

    code language-terminal 
    <Directory "/var/www/html">
    AllowOverride All
</Directory>
    note note
    NOTE
    Manchmal sind zusätzliche Parameter erforderlich. Weitere Informationen finden Sie unter 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 nach <Directory "/var/www/html"> oder <Directory "/var/www"> in 000-default.conf.
    • Sie müssen den Wert von AllowOverride in der Anweisung für den Ordner, in dem Sie die Adobe Commerce-Software installieren möchten. 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-terminal 
    Server version: Apache/2.4.18 (Ubuntu)
Server built: 2020-04-15T18:00:57

  3. Aktivieren schreibt und .htaccess.

Aktualisieren von Apache auf Ubuntu

So aktualisieren Sie auf Apache 2.4:

  1. Fügen Sie die ppa:ondrej Repository mit Apache 2.4:

    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-terminal 
    Server version: Apache/2.4.10 (Ubuntu)
Server built: Jul 22 2020 22:46:25

  4. Aktivieren schreibt 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, die die Anwendung verwendet, um Neuschreibungsregeln anzugeben.

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

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-terminal 
    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 /etc/httpd/conf/httpd.conf Datei 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 nach 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 kann nicht in allen Fällen funktionieren. 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 /etc/apache2/sites-available/default Datei 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 nach 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 -Modul:

    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 einen der Richtlinien erforderlich.

Beispiel:

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