DokumentationHandelInstallationshandbok

[Endast PaaS]{class="badge informative" title="Gäller endast Adobe Commerce i molnprojekt (Adobe-hanterad PaaS-infrastruktur) och lokala projekt."}

Apache

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Erfaren
  • Administratör
  • Utvecklare

Adobe Commerce stöder Apache 2.4.x.

Apache-obligatoriska direktiv

  1. Ange AllowEncodedSlashes i serverkonfigurationen (globalt) eller i den virtuella värdkonfigurationen för att undvika avkodning av kodade snedstreck som kan orsaka problem för URL:er. Om du till exempel hämtar produkter med ett snedstreck i SKU via API:t, vill du inte att det ska konverteras. Exempelblocket är inte fullständigt och andra direktiv krävs.

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

Apache-skrivningar och åtkomst

I det här avsnittet beskrivs hur du aktiverar Apache 2.4-omskrivningar och anger en inställning för den distribuerade konfigurationsfilen, .htaccess.

Adobe Commerce använder serverskrivningar och .htaccess för att tillhandahålla katalognivåinstruktioner för Apache. Följande instruktioner finns även i alla andra avsnitt i det här avsnittet.

Använd det här avsnittet om du vill aktivera Apache 2.4-omskrivningar och ange en inställning för den distribuerade konfigurationsfilen, .htaccess

Adobe Commerce använder serverskrivningar och .htaccess för att tillhandahålla katalognivåinstruktioner för Apache.

NOTE
Om du inte aktiverar de här inställningarna visas vanligtvis inga format i din butik eller administratör.

  1. Aktivera modulen för omskrivning av Apache:

    code language-bash 
    a2enmod rewrite

  2. Om du vill att programmet ska kunna använda den distribuerade konfigurationsfilen .htaccess läser du riktlinjerna i ​ Apache 2.4-dokumentationen.

    note tip
    TIP
    I Apache 2.4 är serverns standardkonfigurationsfil /etc/apache2/sites-available/000-default.conf.

    Du kan till exempel lägga till följande i slutet av 000-default.conf:

    code language-none 
    <Directory "/var/www/html">
    AllowOverride All
</Directory>
    note note
    NOTE
    Ibland kan ytterligare parametrar behövas. Mer information finns i Apache 2.4-dokumentationen.

  3. Om du har ändrat Apache-inställningarna startar du om Apache:

    code language-bash 
    service apache2 restart
    note note
    NOTE
    • Om du uppgraderade från en tidigare Apache-version söker du först efter <Directory "/var/www/html"> eller <Directory "/var/www"> i 000-default.conf.
    • Du måste ändra värdet för AllowOverride i direktivet för den katalog som du vill installera Adobe Commerce-programvaran i. Om du till exempel vill installera i webbserverdokumentet redigerar du direktivet i <Directory /var/www>.
NOTE
Om du inte aktiverar de här inställningarna visas vanligtvis format som inte finns i storefront eller Admin.

Nödvändiga moduler för Apache

Adobe Commerce kräver att följande Apache-moduler är installerade:

Verifiera Apache-versionen

Kontrollera vilken Apache-version du kör genom att ange:

apache2 -v

Resultatet ser ut ungefär så här:

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

Installera eller uppgradera Apache på Ubuntu

I följande avsnitt beskrivs hur du installerar eller uppgraderar Apache:

  • Installera Apache
  • Uppgradera till Apache 2.4 i Ubuntu för att använda PHP 7.4.

Installerar Apache på Ubuntu

Installera standardversionen av Apache:

  1. Installera Apache

    code language-bash 
    apt-get -y install apache2

  2. Verifiera installationen.

    code language-bash 
    apache2 -v

    Resultatet ser ut ungefär så här:

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

  3. Aktivera omskrivningar och .htaccess.

Uppgraderar Apache på Ubuntu

Uppgradera till Apache 2.4:

  1. Lägg till databasen ppa:ondrej som har 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. Installera Apache 2.4:

    code language-bash 
    apt-get install -y apache2
    note note
    NOTE
    Om kommandot "apt-get install" misslyckas på grund av ofullständiga beroenden bör du kontakta en resurs som https://askubuntu.com/.

  3. Verifiera installationen.

    code language-bash 
    apache2 -v

    Meddelanden som liknar följande bör visas:

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

  4. Aktivera omskrivningar och .htaccess.

Installerar Apache på CentOS

Adobe Commerce kräver omskrivning av Apache-servern. Du måste också ange vilken typ av direktiv som kan användas i .htaccess, som programmet använder för att ange regler för omskrivning.

Installation och konfigurering av Apache är i princip en trestegsprocess: installera programmet, aktivera omskrivningar och ange .htaccess direktiv.

Installerar Apache

  1. Installera Apache 2.4 om du inte redan har gjort det.

    code language-bash 
    yum -y install httpd

  2. Verifiera installationen:

    code language-bash 
    httpd -v

    Meddelanden som liknar följande för att bekräfta att installationen lyckades:

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

  3. Fortsätt med nästa avsnitt.

    note note
    NOTE
    Även om Apache 2.4 finns som standard med CentOS, se följande avsnitt för att konfigurera det.

Aktivera omskrivning och .htaccess för CentOS

  1. Öppna filen /etc/httpd/conf/httpd.conf för redigering:

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

  2. Leta reda på det block som börjar med:

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

  3. Ändra värdet för AllowOverride till All.

    Exempel:

    code language-conf 
    <Directory "/var/www/">
  Options Indexes FollowSymLinks MultiViews
  AllowOverride All
  Order allow,deny
  Allow from all
</Directory>
    note note
    NOTE
    Föregående värden för Order kanske inte fungerar i alla fall. Mer information finns i Apache-dokumentationen (2.4).

  4. Spara filen och avsluta textredigeraren.

  5. Starta om Apache om du vill använda Apache-inställningarna.

    code language-bash 
    service apache2 restart
NOTE
Om du inte aktiverar de här inställningarna visas vanligtvis inga format i din butik eller administratör.

Aktivera omskrivning och .htaccess för Ubuntu

  1. Öppna filen /etc/apache2/sites-available/default för redigering:

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

  2. Leta reda på det block som börjar med:

    <Directory "/var/www/html">

  3. Ändra värdet för AllowOverride till All.

    Exempel:

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

  4. Spara filen och avsluta textredigeraren.

  5. Konfigurera Apache att använda modulen mod_rewrite:

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

  6. Starta om Apache för att tillämpa ändringarna:

    code language-bash 
    service apache2 restart

Lösa 403-fel (ej tillåtet)

Om du stöter på 403 Otillåtna fel när du försöker få åtkomst till webbplatsen kan du uppdatera din Apache-konfiguration eller din virtuella värdkonfiguration så att besökarna kan komma åt webbplatsen:

Lösning av 403 Otillåtna fel för Apache 2.4

Använd något av direktiven ​ som krävs om du vill att webbplatsbesökare ska kunna komma åt din webbplats.

Exempel:

<Directory "/var/www/">
  Options Indexes FollowSymLinks MultiViews
  AllowOverride All
  Order allow,deny
  Require all granted
</Directory>
NOTE
Föregående värden för Order kanske inte fungerar i alla fall. Mer information finns i Apache-dokumentationen.
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995