PaaS uniquement

Apache

Dernière mise à jour : 5 mai 2025
  • Rubriques :

Créé pour :

  • Expérimenté
  • Administration
  • Développeur

Adobe Commerce prend en charge Apache 2.4.x.

Directives requises Apache

  1. 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 cela soit converti. L’exemple de bloc n’est pas complet et d’autres directives sont requises.

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

Apache réécrit et htaccess

Cette rubrique explique comment activer les réécritures Apache 2.4 et spécifier un paramètre pour le .htaccess🔗 fichier de configuration distribué).

Adobe Commerce utilise des réécritures et des .htaccess de serveur pour fournir des instructions au niveau du répertoire pour Apache. Les instructions suivantes sont également incluses dans toutes les autres sections de cette rubrique.

Utilisez cette section pour activer les réécritures Apache 2.4 et spécifier un paramètre pour le fichier de configuration distribué, .htaccess

Adobe Commerce utilise des réécritures et des .htaccess de serveur pour fournir des instructions au niveau du répertoire pour Apache.

REMARQUE
Si ces paramètres ne sont pas activés, aucun style ne s’affiche généralement sur votre storefront ou votre administrateur.

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

    a2enmod rewrite

  2. Pour permettre à l’application d’utiliser le fichier de configuration de .htaccess distribué, consultez les instructions de la documentation d’Apache 2.4.

    CONSEIL
    Dans Apache 2.4, le fichier de configuration de site par défaut du serveur est /etc/apache2/sites-available/000-default.conf.

    Par exemple, vous pouvez ajouter ce qui suit à la fin de 000-default.conf :

    <Directory "/var/www/html">
    AllowOverride All
</Directory>
    REMARQUE
    Parfois, des paramètres supplémentaires peuvent être nécessaires. Pour plus d’informations, consultez la documentation d’Apache 2.4.

  3. Si vous avez modifié les paramètres Apache, redémarrez Apache :

    service apache2 restart
    REMARQUE
    • Si vous avez effectué une mise à niveau à partir d’une version précédente d’Apache, recherchez d’abord <Directory "/var/www/html"> ou <Directory "/var/www"> dans 000-default.conf.
    • Vous devez modifier la valeur de AllowOverride dans la directive du répertoire dans lequel vous comptez installer le logiciel Adobe Commerce. Par exemple, pour effectuer une installation dans le serveur web docroot, modifiez la directive dans <Directory /var/www>.
REMARQUE
Si ces paramètres ne sont pas activés, les styles ne s’affichent généralement pas sur le storefront ou l’administrateur.

Modules Apache requis

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

Vérification de la version Apache

Pour vérifier la version d’Apache en cours d’exécution, saisissez :

apache2 -v

Le résultat s’affiche comme suit :

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

Installation ou mise à niveau d’Apache sur Ubuntu

Les sections suivantes expliquent comment installer ou mettre à niveau Apache :

  • Installation d’Apache
  • Effectuez la mise à niveau vers Apache 2.4 sur Ubuntu pour utiliser PHP 7.4.

Installation d’Apache sur Ubuntu

Pour installer la version par défaut d’Apache :

  1. Installation d’Apache

    apt-get -y install apache2

  2. Vérifiez l’installation.

    apache2 -v

    Le résultat s’affiche comme suit :

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

  3. Activez les réécritures et .htaccess).

Mise à niveau d’Apache sur Ubuntu

Pour effectuer la mise à niveau vers Apache 2.4 :

  1. Ajoutez le référentiel ppa:ondrej, qui contient Apache 2.4 :

    apt-get -y update

    apt-add-repository ppa:ondrej/apache2

    apt-get -y update

  2. Installez Apache 2.4 :

    apt-get install -y apache2
    REMARQUE
    Si la commande « apt-get install » échoue en raison de dépendances non satisfaites, consultez une ressource telle que https://askubuntu.com/.

  3. Vérifiez l’installation.

    apache2 -v

    Des messages similaires à ceux-ci doivent s’afficher :

    Server version: Apache/2.4.10 (Ubuntu)
Server built: Jul 22 2020 22:46:25

  4. Activez les réécritures et .htaccess).

Installation d’Apache sous CentOS

Adobe Commerce nécessite des réécritures du serveur Apache. Vous devez également spécifier le type de directives pouvant être utilisées dans .htaccess, que l’application utilise pour spécifier des règles de réécriture.

L’installation et la configuration d’Apache sont essentiellement un processus en trois étapes : installation du logiciel, activation des réécritures et spécification des directives .htaccess.

Installation d’Apache

  1. Installez Apache 2.4 si ce n’est pas déjà fait.

    yum -y install httpd

  2. Vérifiez l’installation :

    httpd -v

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

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

  3. Passez à la section suivante.

    REMARQUE
    Même si Apache 2.4 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 /etc/httpd/conf/httpd.conf fichier pour le modifier :

    vim /etc/httpd/conf/httpd.conf`

  2. Localisez le bloc commençant par :

    <Directory "/var/www/html">

  3. Remplacez la valeur de AllowOverride par All.

    Par exemple,

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

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

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

    service apache2 restart
REMARQUE
Si ces paramètres ne sont pas activés, aucun style ne s’affiche généralement sur votre storefront ou votre administrateur.