DokumentationCommerceInstallationshandbok

[Lokalt]{class="badge informative" title="Gäller endast Adobe Commerce lokala projekt."}

Installera Apache för lokala distributioner apache

Last update: Wed Apr 01 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Erfaren
  • Administratör
  • Utvecklare

I den här guiden får du hjälp med att installera Apache för Adobe Commerce lokala distributioner och konfigurera Apache-inställningarna som Commerce kräver. Den innehåller delade Apache-krav och operativsystemsspecifika procedurer för Ubuntu och CentOS. Adobe rekommenderar att du följer konfigurationsinstruktionerna i den här handboken för att bevara både funktionaliteten och säkerheten i Commerce-programmet.

Adobe stöder Apache-versionerna som listas i systemkraven för din Adobe Commerce-version. Versioner som stöds varierar beroende på version. Apache kräver också en PHP-konfiguration som stöds. Relaterade PHP-krav finns i PHP-inställningar.

Börja med det avsnitt som passar din miljö:

Granska Apache-krav

Uppfyll dessa krav på alla Apache-servrar som har Adobe Commerce som värd.

Konfigurera obligatoriska direktiv

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 snedstrecket ska konverteras. Följande exempelblock är inte fullständigt och andra direktiv krävs.

<VirtualHost *:443>
  # Allow encoded slashes
  AllowEncodedSlashes NoDecode
</VirtualHost>

Konfigurera återskrivningar och .htaccess apache-rewrites-and-htaccess

Använd det här avsnittet om du vill aktivera Apache-omskrivning och konfigurera den distribuerade .htaccess filen ​. Adobe Commerce använder serverskrivningar och .htaccess för att tillhandahålla katalognivåinstruktioner för Apache.

IMPORTANT
Om du inte aktiverar de här inställningarna visas vanligtvis inga format i din butik eller administratör. Det kan också hindra Apache från att tillämpa Adobe Commerce-säkerhetsskydd som definieras i .htaccess.

  1. Aktivera modulen för omskrivning av Apache:

    code language-bash 
    a2enmod rewrite

  2. Aktivera programmet att använda den distribuerade konfigurationsfilen .htaccess.

    1. Redigera /etc/apache2/sites-available/000-default.conf på Ubuntu. Information om andra Apache-layouter eller om ytterligare parametrar krävs finns i dokumentationen för Apache och i dokumentationen för Apache-åtkomstkontroll.

    2. Lägg till eller uppdatera direktivet AllowOverride för den katalog där du tänker installera Adobe Commerce.

    Om du till exempel installerar Adobe Commerce i standardinställningen docroot lägger du till följande block i 000-default.conf:

    code language-conf 
    <Directory "/var/www/html">
  AllowOverride All
</Directory>
    note note
    NOTE
    Om du uppgraderade från en tidigare Apache-version söker du först efter ett befintligt <Directory "/var/www/html">- eller <Directory "/var/www">-block i 000-default.conf. Om du installerar Adobe Commerce i en annan docroot ska du uppdatera det matchande <Directory>-blocket för den sökvägen.

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

    code language-bash 
    service apache2 restart

Installera nödvändiga moduler

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

Kontrollera att Apache är installerat

Kontrollera att Apache är installerat och visa den aktuella versionen genom att ange:

apache2 -v

Resultatet visar information som liknar följande:

Server version: Apache/<installed-version>
Server built: <build-date>

Installera eller uppgradera Apache på Ubuntu installing-or-upgrading-apache-on-ubuntu

Installation och konfigurering av Apache i Ubuntu är en process i tre steg:

  1. Installera programvaran.
  2. Aktivera omskrivningar.
  3. Ange .htaccess direktiv.

När du konfigurerar omskrivningar av Apache-servern måste du ange vilken typ av direktiv som kan användas i .htaccess, som programmet använder för att ange omskrivningsregler och säkerhetsskydd.

Installera Apache på Ubuntu

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

    code language-bash 
    apt-get -y install apache2

  2. Verifiera installationen:

    code language-bash 
    apache2 -v

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

    code language-text 
    Server version: Apache/<installed-version>
Server built: <build-date>

  3. Fortsätt med nästa avsnitt.

    note note
    NOTE
    Även om Apache tillhandahålls som standard med Ubuntu, se följande avsnitt för att konfigurera det.

Uppgradera Apache på Ubuntu

Om Apache redan är installerat och du använder en version som är tidigare än 2.4 uppgraderar du till Apache 2.4 eller till den senaste versionen som stöds av den Adobe Commerce-version som du har distribuerat. Se systemkrav.

  1. Uppdatera paketinformation:

    code language-bash 
    apt-get -y update

  2. Lägg till en databas som innehåller en Apache-version som stöds för din miljö, om det behövs.

  3. Installera eller uppgradera Apache:

    code language-bash 
    apt-get install -y apache2
    note note
    NOTE
    Om kommandot apt-get install inte fungerar på grund av att beroenden inte uppfylls, bör du läsa dokumentationen till operativsystemspaketet eller distributionssupportresurserna.

  4. Verifiera installationen:

    code language-bash 
    apache2 -v

  5. Kontrollera att den installerade versionen matchar den version som stöds för din Adobe Commerce-version i systemkraven.

  6. Aktivera omskrivningar och .htaccess för Ubuntu.

Aktivera omskrivning och .htaccess för Ubuntu

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

    code language-bash 
    vim /etc/apache2/sites-available/000-default.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/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
IMPORTANT
Om du inte aktiverar de här inställningarna visas vanligtvis inga format i din butik eller administratör. Det kan också hindra Apache från att tillämpa Adobe Commerce-säkerhetsskydd som definieras i .htaccess.

Installera Apache på CentOS installing-apache-on-centos

Installation och konfigurering av Apache i CentOS är en process i tre steg:

  1. Installera programvaran
  2. Aktivera omskrivning
  3. Ange .htaccess direktiv.

När du konfigurerar omskrivningar av Apache-servern måste du ange vilken typ av direktiv som kan användas i .htaccess, som programmet använder för att ange omskrivningsregler och säkerhetsskydd.

Installerar Apache

  1. Installera Apache 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-text 
    Server version: Apache/<installed-version>
Server built: <build-date>

  3. Fortsätt med nästa avsnitt.

    note note
    NOTE
    Även om Apache tillhandahålls som standard med CentOS läser du 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.

  4. Spara filen och avsluta textredigeraren.

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

    code language-bash 
    systemctl restart httpd
IMPORTANT
Om du inte aktiverar de här inställningarna visas vanligtvis inga format i din butik eller administratör. Det kan också hindra Apache från att tillämpa Adobe Commerce-säkerhetsskydd som definieras i .htaccess.

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ös 403 Otillåtna fel för Apache

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