Documentatie Commerce Installatiehandleiding

[In de bedrijfsruimten]{class="badge informative" title="Alleen van toepassing op Adobe Commerce-projecten ter plaatse."}

Apache installeren voor implementaties op locatie apache

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

Onderwerpen:
Configuratie

Gemaakt voor:

Ervaren
Beheerder
Ontwikkelaar

Deze handleiding begeleidt u bij het installeren van Apache voor Adobe Commerce-implementaties op locatie en bij het configureren van de Apache-instellingen die Commerce nodig heeft. Dit omvat gedeelde Apache-vereisten en specifieke procedures voor het besturingssysteem voor Ubuntu en CentOS. Adobe raadt u aan de configuratie-instructies in deze handleiding op te volgen om zowel de functionaliteit als de beveiliging van de Commerce-toepassing te behouden.

Adobe steunt de versies Apache die in de systeemvereisten voor uw versie van Adobe Commerce worden vermeld. Ondersteunde versies verschillen per release. Voor Apache is ook een ondersteunde PHP-configuratie vereist. Voor verwante PHP vereisten, zie PHP montages .

Begin met de sectie die uw milieu aanpast:

Als Apache reeds geïnstalleerd is, begin met de vereisten van Apache van het Overzicht .
Als u Apache op Ubuntu moet installeren of bevorderen, ga installeren of bevorderen Apache op Ubuntu .
Als u Apache op CentOS moet installeren, ga installeren Apache op CentOS .

Apache-vereisten bekijken

Voltooi deze vereisten op elke Apache-server waarop Adobe Commerce wordt gehost.

Verplichte instructies configureren

Stel AllowEncodedSlashes in de serverconfiguratie (globaal) of in de virtuele hostconfiguraties in om te voorkomen dat de gecodeerde schuine strepen worden gedecodeerd die problemen voor URL's kunnen veroorzaken. Wanneer u bijvoorbeeld via de API producten met een schuine streep ophaalt in de SKU, wilt u niet dat de schuine streep wordt omgezet. Het volgende voorbeeldblok is niet volledig en andere richtlijnen zijn vereist.

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

Herschrijvingen en .htaccess configureren apache-rewrites-and-htaccess

Gebruik deze sectie om Apache toe te laten herschrijft en vormt het verdeelde .htaccess dossier . Adobe Commerce gebruikt herschrijvingen op de server en .htaccess voor instructies op directoryniveau voor Apache.

IMPORTANT

Als u deze instellingen niet inschakelt, worden er gewoonlijk geen stijlen weergegeven op uw winkel of in Admin. Hierdoor kan ook worden voorkomen dat Apache de in .htaccess gedefinieerde Adobe Commerce-beveiligingsinstellingen toepast.

Schakel de module voor het herschrijven van Apache in:

code language-bash
`a2enmod rewrite`

Laat de toepassing toe om het verdeelde .htaccess configuratiedossier te gebruiken.

Bewerk /etc/apache2/sites-available/000-default.conf in Ubuntu. Voor andere lay-outs Apache of als de extra parameters worden vereist, zie de documentatie van Apache en de documentatie van de de toegangscontrole van Apache .
Voeg de aanwijzing AllowOverride toe of werk deze bij voor de map waarin u Adobe Commerce wilt installeren.

Als u bijvoorbeeld Adobe Commerce in de standaard docroot installeert, voegt u het volgende blok toe aan 000-default.conf :

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

note note
NOTE
Als u een upgrade uitvoert vanaf een eerdere Apache-versie, zoekt u eerst naar een bestaand `<Directory "/var/www/html">` - of `<Directory "/var/www">` -blok in `000-default.conf` . Als u Adobe Commerce in een andere `docroot` installeert, werkt u het overeenkomende `<Directory>` -blok voor dat pad bij.

Start Apache opnieuw om uw wijzigingen toe te passen:

code language-bash
`service apache2 restart`

Vereiste modules installeren

Adobe Commerce vereist de installatie van de volgende Apache-modules:

Controleren of Apache is geïnstalleerd

Voer de volgende gegevens in om te controleren of Apache is geïnstalleerd en de huidige versie te bekijken:

apache2 -v

Het resultaat geeft ongeveer de volgende informatie weer:

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

Als Apache niet geïnstalleerd is, zie:
- Apache installeren of upgraden op Ubuntu
- Apache installeren op CentOS

Apache installeren of upgraden op Ubuntu installing-or-upgrading-apache-on-ubuntu

Apache installeren en configureren op Ubuntu is een proces in drie stappen:

De software installeren.
Herschrijven inschakelen.
Geef .htaccess instructies op.

Wanneer u Apache-serverherschrijvingen configureert, moet u het type instructies opgeven dat in .htaccess kan worden gebruikt. De toepassing gebruikt deze om herschrijfregels en beveiliging op te geven.

Apache installeren op Ubuntu

Installeer Apache als u dat nog niet hebt gedaan:

code language-bash
`apt-get -y install apache2`

Controleer de installatie:

code language-bash
`apache2 -v`

Berichten die lijken op de volgende weergave om te bevestigen dat de installatie is gelukt:

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

Ga verder met de volgende sectie.

note note
NOTE
Zelfs als Apache door gebrek met Ubuntu wordt verstrekt, zie de volgende sectie om het te vormen.

Upgrade van Apache op Ubuntu

Als Apache al is geïnstalleerd en u een eerdere versie dan 2.4 gebruikt, voert u een upgrade uit naar Apache 2.4 of naar de meest recente versie die wordt ondersteund door de Adobe Commerce-versie die u hebt geïmplementeerd. Zie systeemvereisten .

Pakketgegevens bijwerken:

code language-bash
`apt-get -y update`

Voeg desgewenst een opslagplaats toe die een ondersteunde Apache-versie voor uw omgeving biedt.

Apache installeren of upgraden:

code language-bash
`apt-get install -y apache2`

note note
NOTE
Als de opdracht `apt-get install` mislukt als gevolg van onvervulde afhankelijkheden, raadpleegt u de documentatie bij het besturingssysteem of de ondersteuningsbronnen voor de distributie.

Controleer de installatie:

code language-bash
`apache2 -v`

Bevestig dat de geïnstalleerde versie de versie aanpast die voor uw versie van Adobe Commerce in systeemvereisten wordt gesteund.
Laat toe herschrijft en .htaccess voor Ubuntu .

Herschrijven en .htaccess voor Ubuntu inschakelen

Open het /etc/apache2/sites-available/000-default.conf -bestand voor bewerking:

code language-bash
`vim /etc/apache2/sites-available/000-default.conf`

Zoek het blok dat begint met:

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

Wijzig de waarde van AllowOverride in All .

Bijvoorbeeld:

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

Sla het bestand op en sluit de teksteditor af.

Configureer Apache voor gebruik van de module mod_rewrite :

code language-bash
`cd /etc/apache2/mods-enabled`

code language-bash
`ln -s ../mods-available/rewrite.load`

Start Apache opnieuw om de wijzigingen toe te passen:

code language-bash
`service apache2 restart`

IMPORTANT

Apache installeren op CentOS installing-apache-on-centos

Apache installeren en configureren op CentOS bestaat uit drie stappen:

De software installeren
Herschrijven inschakelen
Geef .htaccess instructies op.