Apache
Adobe Commerce ondersteunt Apache 2.4.x.
Vereiste richtlijnen Apache
-
Stel
AllowEncodedSlashes
in de serverconfiguratie (globaal) of in de virtuele hostconfiguraties in om te voorkomen dat de gecodeerde schuine strepen worden gedecodeerd die problemen kunnen veroorzaken voor URL's. Wanneer u bijvoorbeeld via de API producten met een schuine streep ophaalt in de SKU, wilt u dat die niet converteren. Het voorbeeldblok is niet compleet en andere richtlijnen zijn vereist.code language-conf <VirtualHost *:443> # Allow encoded slashes AllowEncodedSlashes NoDecode </VirtualHost>
Apache herschrijft en opent
Dit onderwerp bespreekt hoe te om Apache 2.4 toe te laten herschrijft en specificeert het plaatsen voor het verdeelde configuratiedossier, .htaccess
.
Adobe Commerce gebruikt herschrijvingen op de server en .htaccess
voor instructies op directoryniveau voor Apache. De volgende instructies zijn ook inbegrepen in alle andere secties in dit onderwerp.
Gebruik deze sectie om Apache 2.4 toe te laten herschrijft en specificeert het plaatsen voor het verdeelde configuratiedossier, .htaccess
Adobe Commerce gebruikt herschrijvingen op de server en .htaccess
voor instructies op directoryniveau voor Apache.
-
Schakel de module voor het herschrijven van Apache in:
code language-bash a2enmod rewrite
-
Om de toepassing toe te laten om het verdeelde
.htaccess
configuratiedossier te gebruiken, zie de richtlijnen in Apache 2.4 documentatie.note tip TIP In Apache 2.4 is het standaardsiteconfiguratiebestand van de server /etc/apache2/sites-available/000-default.conf
.U kunt bijvoorbeeld het volgende toevoegen aan het einde van
000-default.conf
:code language-none <Directory "/var/www/html"> AllowOverride All </Directory>
note note NOTE Soms zijn aanvullende parameters vereist. Voor meer informatie, zie Apache 2.4 documentatie. -
Als u Apache-instellingen hebt gewijzigd, start u Apache opnieuw:
code language-bash service apache2 restart
note note NOTE - Als u een upgrade uitvoert vanaf een eerdere Apache-versie, zoekt u eerst naar
<Directory "/var/www/html">
of<Directory "/var/www">
in000-default.conf
. - U moet de waarde van
AllowOverride
wijzigen in de instructie voor de map waarin u de Adobe Commerce-software wilt installeren. Als u bijvoorbeeld wilt installeren in de webserverhoofdmap, bewerkt u de instructie in<Directory /var/www>
.
- Als u een upgrade uitvoert vanaf een eerdere Apache-versie, zoekt u eerst naar
Vereiste modules voor Apache
Adobe Commerce vereist de installatie van de volgende Apache-modules:
De Apache-versie verifiëren
Voer de volgende gegevens in om te controleren welke Apache-versie u momenteel gebruikt:
apache2 -v
Het resultaat lijkt op het volgende:
Server version: Apache/2.4.04 (Ubuntu)
Server built: Jul 22 2020 14:35:32
-
Als Apache niet geïnstalleerd is, zie:
Apache installeren of upgraden op Ubuntu
In de volgende secties wordt besproken hoe u Apache kunt installeren of upgraden:
- Apache installeren
- Upgrade naar Apache 2.4 op Ubuntu om PHP 7.4 te gebruiken.
Apache installeren op Ubuntu
De standaardversie van Apache installeren:
-
Apache installeren
code language-bash apt-get -y install apache2
-
Controleer de installatie.
code language-bash apache2 -v
Het resultaat lijkt op het volgende:
code language-none Server version: Apache/2.4.18 (Ubuntu) Server built: 2020-04-15T18:00:57
-
Schakel herschrijft en
.htaccess
in.
Apache bijwerken op Ubuntu
Ga als volgt te werk om bij te werken naar Apache 2.4:
-
Voeg de
ppa:ondrej
-opslagplaats toe, die Apache 2.4 heeft:code language-bash apt-get -y update
code language-bash apt-add-repository ppa:ondrej/apache2
code language-bash apt-get -y update
-
Installeer Apache 2.4:
code language-bash apt-get install -y apache2
note note NOTE Als "apt-get installeert"bevel wegens onontmoet gebiedsdelen ontbreekt, raadpleeg een middel zoals https://askubuntu.com/. -
Controleer de installatie.
code language-bash apache2 -v
Berichten die op het volgende lijken, moeten worden weergegeven:
code language-none Server version: Apache/2.4.10 (Ubuntu) Server built: Jul 22 2020 22:46:25
-
Schakel herschrijft en
.htaccess
in.
Apache installeren op CentOS
Adobe Commerce vereist herschrijven van Apache-server. U moet ook het type instructies opgeven dat in .htaccess
kan worden gebruikt. De toepassing gebruikt deze om herschrijfregels op te geven.
Het installeren en configureren van Apache is in feite een proces in drie stappen: de software installeren, herschrijven inschakelen en .htaccess
instructies opgeven.
Apache installeren
-
Installeer Apache 2.4 als u dat nog niet hebt gedaan.
code language-bash yum -y install httpd
-
Controleer de installatie:
code language-bash httpd -v
Berichten die lijken op de volgende weergave om te bevestigen dat de installatie is gelukt:
code language-none Server version: Apache/2.4.40 (Unix) Server built: Oct 16 2020 14:48:21
-
Ga verder met de volgende sectie.
note note NOTE Zelfs als Apache 2.4 standaard wordt voorzien van CentOS, zie de volgende sectie om het te vormen.
Herschrijven en .htaccess inschakelen voor CentOS
-
Open
/etc/httpd/conf/httpd.conf
-bestand voor bewerking:code language-bash vim /etc/httpd/conf/httpd.conf`
-
Zoek het blok dat begint met:
code language-conf <Directory "/var/www/html">
-
Wijzig de waarde van
AllowOverride
inAll
.Bijvoorbeeld:
code language-conf <Directory "/var/www/"> Options Indexes FollowSymLinks MultiViews AllowOverride All Order allow,deny Allow from all </Directory>
note note NOTE De voorafgaande waarden voor Order
werken mogelijk niet in alle gevallen. Voor meer informatie, zie de documentatie Apache ( 2.4). -
Sla het bestand op en sluit de teksteditor af.
-
Start Apache opnieuw om Apache-instellingen toe te passen.
code language-bash service apache2 restart
Herschrijven en .htaccess voor Ubuntu inschakelen
-
Open
/etc/apache2/sites-available/default
-bestand voor bewerking:code language-bash vim /etc/apache2/sites-available/default
-
Zoek het blok dat begint met:
<Directory "/var/www/html">
-
Wijzig de waarde van
AllowOverride
inAll
.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
403 (Verboden) fouten oplossen
Als u 403 Verboden fouten tegenkomt bij het openen van de site, kunt u uw Apache-configuratie of uw virtuele hostconfiguratie bijwerken om bezoekers in te schakelen voor de site:
403 Verboden fouten voor Apache 2.4 oplossen
Om websitebezoekers toe te laten om tot uw plaats toegang te hebben, gebruik één van vereisen richtlijnen.
Bijvoorbeeld:
<Directory "/var/www/">
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
Require all granted
</Directory>
Order
werken mogelijk niet in alle gevallen. Voor meer informatie, zie de documentatie Apache.