DocumentationCommerceGuide d’installation

[On-premise]{class="badge informative" title="S’applique uniquement aux projets sur site Adobe Commerce."}

Installation d’Apache pour les déploiements sur site apache

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

Créé pour :

  • Expérimenté
  • Administration
  • Développeur

Ce guide vous guide tout au long de l’installation d’Apache pour les déploiements sur site d’Adobe Commerce et de la configuration des paramètres Apache requis par Commerce. Il comprend des exigences Apache partagées et des procédures spécifiques au système d’exploitation pour Ubuntu et CentOS. Adobe recommande de suivre les instructions de configuration fournies dans ce guide afin de préserver les fonctionnalités et la sécurité de l’application Commerce.

Adobe prend en charge les versions d’Apache répertoriées dans la configuration requise pour votre version d’Adobe Commerce. Les versions prises en charge varient selon les versions. Apache nécessite également une configuration PHP prise en charge. Pour les exigences PHP associées, voir Paramètres PHP.

Commencez par la section correspondant à votre environnement :

Vérifier les exigences d’Apache

Effectuez ces exigences sur tout serveur Apache hébergeant Adobe Commerce.

Configurer les directives requises

Définissez AllowEncodedSlashes dans la configuration du serveur (globalement) ou dans les configurations de l’hôte virtuel pour éviter de décoder les barres obliques codées qui peuvent entraîner des problèmes pour les URL. Par exemple, lors de la récupération de produits avec une barre oblique dans le SKU via l’API, vous ne souhaitez pas que la barre oblique soit convertie. L’exemple de bloc suivant est incomplet et d’autres directives sont requises.

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

Configuration des réécritures et de .htaccess apache-rewrites-and-htaccess

Utilisez cette section pour activer les réécritures Apache et configurer le fichier .htaccess distribué. Adobe Commerce utilise des réécritures et des .htaccess de serveur pour fournir des instructions au niveau du répertoire pour Apache.

IMPORTANT
Si ces paramètres ne sont pas activés, aucun style ne s’affiche généralement sur votre storefront ou votre administrateur. Cela peut également empêcher Apache d’appliquer les protections de sécurité Adobe Commerce définies dans .htaccess.

  1. Activez le module de réécriture Apache :

    code language-bash 
    a2enmod rewrite

  2. Autorisez l’application à utiliser le fichier de configuration de .htaccess distribué.

    1. Sur Ubuntu, modifiez /etc/apache2/sites-available/000-default.conf. Pour d’autres dispositions Apache ou si des paramètres supplémentaires sont requis, consultez la documentation Apache et la documentation sur le contrôle d’accès Apache.

    2. Ajoutez ou mettez à jour la directive AllowOverride pour le répertoire dans lequel vous envisagez d’installer Adobe Commerce.

    Par exemple, si vous installez Adobe Commerce dans le docroot par défaut, ajoutez le bloc suivant à 000-default.conf :

    code language-conf 
    <Directory "/var/www/html">
  AllowOverride All
</Directory>
    note note
    NOTE
    Si vous avez effectué une mise à niveau à partir d’une version précédente d’Apache, recherchez d’abord un bloc <Directory "/var/www/html"> ou <Directory "/var/www"> existant dans 000-default.conf. Si vous installez Adobe Commerce dans un autre docroot, mettez à jour le bloc de <Directory> correspondant à ce chemin d’accès.

  3. Redémarrez Apache pour appliquer vos modifications :

    code language-bash 
    service apache2 restart

Installation des modules requis

Adobe Commerce nécessite l’installation des modules Apache suivants :

Vérifier qu’Apache est installé

Pour vérifier qu’Apache est installé et afficher la version actuelle, saisissez :

apache2 -v

Le résultat affiche des informations similaires à ce qui suit :

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

Installer ou mettre à niveau Apache sur Ubuntu installing-or-upgrading-apache-on-ubuntu

L’installation et la configuration d’Apache sur Ubuntu est un processus en trois étapes :

  1. Installez le logiciel.
  2. Activez les réécritures.
  3. Spécifiez les directives .htaccess.

Lorsque vous configurez les réécritures du serveur Apache, vous devez spécifier le type de directives pouvant être utilisées dans .htaccess, que l’application utilise pour spécifier les règles de réécriture et les protections de sécurité.

Installer Apache sur Ubuntu

  1. Installez Apache si vous ne l’avez pas déjà fait :

    code language-bash 
    apt-get -y install apache2

  2. Vérifiez l’installation :

    code language-bash 
    apache2 -v

    Des messages similaires au suivant s’affichent pour confirmer que l’installation a réussi :

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

  3. Passez à la section suivante.

    note note
    NOTE
    Même si Apache est fourni par défaut avec Ubuntu, consultez la section suivante pour le configurer.

Mettre à niveau Apache sur Ubuntu

Si Apache est déjà installé et que vous utilisez une version antérieure à 2.4, effectuez une mise à niveau vers Apache 2.4 ou vers la dernière version prise en charge par la version d’Adobe Commerce que vous avez déployée. Voir ​ Configuration requise ​.

  1. Mettre à jour les informations sur le package :

    code language-bash 
    apt-get -y update

  2. Ajoutez un référentiel qui fournit une version Apache prise en charge pour votre environnement, si nécessaire.

  3. Installez ou mettez à niveau Apache :

    code language-bash 
    apt-get install -y apache2
    note note
    NOTE
    Si la commande apt-get install échoue en raison de dépendances non satisfaites, consultez la documentation du package de votre système d’exploitation ou les ressources d’assistance pour la distribution.

  4. Vérifiez l’installation :

    code language-bash 
    apache2 -v

  5. Vérifiez que la version installée correspond à la version prise en charge pour votre version d’Adobe Commerce dans configuration requise.

  6. Activez réécritures et .htaccess pour Ubuntu.

Activer les réécritures et .htaccess pour Ubuntu

  1. Ouvrez le fichier /etc/apache2/sites-available/000-default.conf pour le modifier :

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

  2. Localisez le bloc commençant par :

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

  3. Remplacez la valeur de AllowOverride par All.

    Par exemple :

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

  4. Enregistrez le fichier et quittez l’éditeur de texte.

  5. Configurez Apache pour utiliser le module mod_rewrite :

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

  6. Redémarrez Apache pour appliquer les modifications :

    code language-bash 
    service apache2 restart
IMPORTANT
Si ces paramètres ne sont pas activés, aucun style ne s’affiche généralement sur votre storefront ou votre administrateur. Cela peut également empêcher Apache d’appliquer les protections de sécurité Adobe Commerce définies dans .htaccess.

Installation d’Apache sous CentOS installing-apache-on-centos

L’installation et la configuration d’Apache sur CentOS est un processus en trois étapes :

  1. Installation du logiciel
  2. Activer les réécritures
  3. Spécifiez les directives .htaccess.

Lorsque vous configurez les réécritures du serveur Apache, vous devez spécifier le type de directives pouvant être utilisées dans .htaccess, que l’application utilise pour spécifier les règles de réécriture et les protections de sécurité.

Installation d’Apache

  1. Installez Apache si vous ne l’avez pas déjà fait.

    code language-bash 
    yum -y install httpd

  2. Vérifiez l’installation :

    code language-bash 
    httpd -v

    Des messages similaires au suivant s’affichent pour confirmer que l’installation a réussi :

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

  3. Passez à la section suivante.

    note note
    NOTE
    Même si Apache est fourni par défaut avec CentOS, consultez la section suivante pour le configurer.

Activer les réécritures et l’accès .html pour CentOS

  1. Ouvrez le fichier /etc/httpd/conf/httpd.conf pour le modifier :

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

  2. Localisez le bloc commençant par :

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

  3. Remplacez la valeur de AllowOverride par All.

    Par exemple :

    code language-conf 
    <Directory "/var/www/">
  Options Indexes FollowSymLinks MultiViews
  AllowOverride All
  Order allow,deny
  Allow from all
</Directory>
    note note
    NOTE
    Les valeurs précédentes pour Order peuvent ne pas fonctionner dans tous les cas. Pour plus d’informations, consultez la documentation Apache.

  4. Enregistrez le fichier et quittez l’éditeur de texte.

  5. Pour appliquer les paramètres Apache, redémarrez Apache.

    code language-bash 
    systemctl restart httpd
IMPORTANT
Si ces paramètres ne sont pas activés, aucun style ne s’affiche généralement sur votre storefront ou votre administrateur. Cela peut également empêcher Apache d’appliquer les protections de sécurité Adobe Commerce définies dans .htaccess.

Résolution des erreurs 403 (Interdit)

Si vous rencontrez des erreurs 403 Interdit lors de l’accès au site, vous pouvez mettre à jour votre configuration Apache ou votre configuration d’hôte virtuel pour permettre aux visiteurs et visiteuses d’accéder au site :

Résolution des erreurs 403 Interdit pour Apache

Pour permettre aux visiteurs et visiteuses du site Web d’accéder à votre site, utilisez l’une des Directives requises.

Par exemple :

<Directory "/var/www/">
  Options Indexes FollowSymLinks MultiViews
  AllowOverride All
  Order allow,deny
  Require all granted
</Directory>
NOTE
Les valeurs précédentes pour Order peuvent ne pas fonctionner dans tous les cas. Pour plus d’informations, consultez la documentation Apache.
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995