DocumentationCommerceGuide d’installation

[PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}

Nginx

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Expérimenté
  • Administration
  • Développeur

Adobe Commerce prend en charge nginx 1.x (ou la dernière version mainline). Vous devez également installer la dernière version de php-fpm.

Les instructions d’installation varient en fonction du système d’exploitation utilisé. Voir PHP pour plus d’informations.

Ubuntu

La section suivante décrit comment installer Adobe Commerce 2.x sur Ubuntu à l’aide de nginx, PHP et MySQL.

Installer Nginx

sudo apt -y install nginx

Vous pouvez également créer nginx à partir de la source

Après avoir complété les sections suivantes et installé l’application, nous utiliserons un exemple de fichier de configuration pour configurer nginx.

Installation et configuration de php-fpm

Adobe Commerce requiert plusieurs extensions PHP pour fonctionner correctement. En plus de ces extensions, vous devez également installer et configurer l’extension php-fpm si vous utilisez nginx.

Pour installer et configurer php-fpm :

  1. Installez php-fpm et php-cli :

    code language-bash 
    apt-get -y install php7.2-fpm php7.2-cli
    note note
    NOTE
    Cette commande installe la dernière version disponible de PHP 7.2.X. Voir configuration requise pour les versions PHP prises en charge.

  2. Ouvrez les fichiers php.ini dans un éditeur :

    code language-bash 
    vim /etc/php/7.2/fpm/php.ini
    code language-bash 
    vim /etc/php/7.2/cli/php.ini

  3. Modifiez les deux fichiers pour qu’ils correspondent aux lignes suivantes :

    code language-conf 
    memory_limit = 2G
max_execution_time = 1800
zlib.output_compression = On
    note note
    NOTE
    Nous vous recommandons de définir la limite de mémoire sur 2 Go lors du test d’Adobe Commerce. Pour plus d’informations, voir Paramètres PHP requis.

  4. Enregistrez et quittez l’éditeur.

  5. Redémarrez le service php-fpm :

    code language-bash 
    systemctl restart php7.2-fpm

Installation et configuration de MySQL

Voir MySQL pour plus d’informations.

Installation et configuration

Il existe plusieurs façons de télécharger Adobe Commerce, notamment :

Cet exemple illustre une installation basée sur le compositeur à l’aide de la ligne de commande .

  1. Connectez-vous à votre serveur d’applications en tant que propriétaire du système de fichiers.

  2. Passez au répertoire docroot du serveur web ou à un répertoire que vous avez configuré en tant qu'hôte virtuel docroot. Pour cet exemple, nous utilisons le /var/www/html par défaut Ubuntu.

    code language-bash 
    cd /var/www/html

  3. Installez Composer globalement. Le compositeur est nécessaire pour mettre à jour les dépendances avant d’installer Adobe Commerce :

    code language-bash 
    curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/bin --filename=composer

  4. Créez un projet Composer à l’aide du métapaquet Adobe Commerce.

    Magento Open Source

    code language-bash 
    composer create-project --repository=https://repo.magento.com/ magento/project-community-edition <install-directory-name>

    Adobe Commerce

    code language-bash 
    composer create-project --repository=https://repo.magento.com/ magento/project-enterprise-edition <install-directory-name>

    A l’invite, saisissez vos clés d’authentification. Votre clé publique est votre nom d’utilisateur ; votre clé privée est votre mot de passe.

  5. Définissez les autorisations de lecture et d’écriture pour le groupe de serveurs web avant d’installer l’application. Cela est nécessaire pour que la ligne de commande puisse écrire des fichiers dans le système de fichiers.

    code language-bash 
    cd /var/www/html/<magento install directory>
    code language-bash 
    find var generated vendor pub/static pub/media app/etc -type f -exec chmod g+w {} +
    code language-bash 
    find var generated vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} +
    code language-bash 
    chown -R :www-data . # Ubuntu
    code language-bash 
    chmod u+x bin/magento

  6. Installez à partir de la ligne de commande. Cet exemple suppose que le répertoire d’installation est nommé magento2ee, que le db-host se trouve sur le même ordinateur (localhost) et que les db-name, db-user et db-password sont tous magento :

    code language-bash 
    bin/magento setup:install \
--base-url=http://localhost/magento2ee \
--db-host=localhost \
--db-name=magento \
--db-user=magento \
--db-password=magento \
--backend-frontname=admin \
--admin-firstname=admin \
--admin-lastname=admin \
--admin-email=admin@admin.com \
--admin-user=admin \
--admin-password=admin123 \
--language=en_US \
--currency=USD \
--timezone=America/Chicago \
--use-rewrites=1 \
--search-engine=elasticsearch7 \
--elasticsearch-host=es-host.example.com \
--elasticsearch-port=9200

  7. Basculez vers le mode Développeur :

    code language-bash 
    cd /var/www/html/magento2/bin
    code language-bash 
    ./magento deploy:mode:set developer

Configuration de Nginx

Nous vous recommandons de configurer nginx en utilisant le fichier de configuration nginx.conf.sample fourni dans le répertoire d'installation et l'hôte virtuel nginx.

Ces instructions supposent que vous utilisez l'emplacement par défaut Ubuntu pour l'hôte virtuel nginx (par exemple, /etc/nginx/sites-available) et la racine docroot par défaut Ubuntu (par exemple, /var/www/html), mais vous pouvez modifier ces emplacements en fonction de votre environnement.

  1. Créez un hôte virtuel pour votre site :

    code language-bash 
    vim /etc/nginx/sites-available/magento

  2. Ajoutez la configuration suivante :

    code language-conf 
    upstream fastcgi_backend {
  server  unix:/run/php/php7.2-fpm.sock;
}

server {

  listen 80;
  server_name www.magento-dev.com;
  set $MAGE_ROOT /var/www/html/magento2;
  include /var/www/html/magento2/nginx.conf.sample;
}
    note note
    NOTE
    La directive include doit pointer vers l'exemple de fichier de configuration nginx dans votre répertoire d'installation.

  3. Remplacez www.magento-dev.com par votre nom de domaine. Elle doit correspondre à l’URL de base que vous avez spécifiée lors de l’installation d’Adobe Commerce.

  4. Enregistrez et quittez l’éditeur.

  5. Activez l’hôte virtuel que vous venez de créer en y créant un lien symbolique dans le répertoire /etc/nginx/sites-enabled :

    code language-bash 
    ln -s /etc/nginx/sites-available/magento /etc/nginx/sites-enabled

  6. Vérifiez que la syntaxe est correcte :

    code language-bash 
    nginx -t

  7. Redémarrez Angles :

    code language-bash 
    systemctl restart nginx

Vérification de l’installation

Ouvrez un navigateur web et accédez à l’URL de base de votre site pour vérifier l’installation.

CentOS 7

La section suivante décrit comment installer Adobe Commerce 2.x sur CentOS 7 à l’aide de nginx, PHP et MySQL.

Installer Nginx

yum -y install epel-release

yum -y install nginx

Une fois l’installation terminée, démarrez nginx et configurez-le pour qu’il démarre au moment du démarrage :

systemctl start nginx

systemctl enable nginx

Après avoir complété les sections suivantes et installé l’application, nous utiliserons un exemple de fichier de configuration pour configurer nginx.

Installation et configuration de php-fpm

Adobe Commerce requiert plusieurs extensions PHP pour fonctionner correctement. En plus de ces extensions, vous devez également installer et configurer l'extension php-fpm si vous utilisez nginx.

  1. Installez php-fpm :

    code language-bash 
    yum -y install php70w-fpm

  2. Ouvrez le fichier /etc/php.ini dans un éditeur.

  3. Supprimez les commentaires de la ligne de cgi.fix_pathinfo et définissez la valeur sur 0.

  4. Modifiez le fichier pour qu’il corresponde aux lignes suivantes :

    code language-conf 
    memory_limit = 2G
max_execution_time = 1800
zlib.output_compression = On
    note note
    NOTE
    Nous vous recommandons de définir la limite de mémoire sur 2 Go lors du test d’Adobe Commerce. Pour plus d’informations, voir Paramètres PHP requis.

  5. Supprimez les commentaires du répertoire de chemin de session et définissez le chemin d’accès :

    code language-conf 
    session.save_path = "/var/lib/php/session"

  6. Enregistrez et quittez l’éditeur.

  7. Ouvrez /etc/php-fpm.d/www.conf dans un éditeur.

  8. Modifiez le fichier pour qu’il corresponde aux lignes suivantes :

    code language-conf 
    user = nginx
group = nginx
listen = /run/php-fpm/php-fpm.sock
listen.owner = nginx
listen.group = nginx
listen.mode = 0660

  9. Supprimez les commentaires des lignes d’environnement :

    code language-conf 
    env[HOSTNAME] = $HOSTNAME
env[PATH] = /usr/local/bin:/usr/bin:/bin
env[TMP] = /tmp
env[TMPDIR] = /tmp
env[TEMP] = /tmp

  10. Enregistrez et quittez l’éditeur.

  11. Créez un répertoire pour le chemin de session PHP et modifiez le propriétaire en utilisateur et groupe apache :

    code language-bash 
    mkdir -p /var/lib/php/session/
    code language-bash 
    chown -R apache:apache /var/lib/php/

  12. Créez un répertoire pour le chemin de session PHP et modifiez le propriétaire en utilisateur et groupe apache :

    code language-bash 
    mkdir -p /run/php-fpm/
    code language-bash 
    chown -R apache:apache /run/php-fpm/

  13. Démarrez le service php-fpm et configurez-le pour qu'il démarre au démarrage :

    code language-bash 
    systemctl start php-fpm
    code language-bash 
    systemctl enable php-fpm

  14. Vérifiez que le service php-fpm est en cours d’exécution :

    code language-bash 
    netstat -pl | grep php-fpm.sock

Installation et configuration de MySQL

Voir MySQL pour plus d’informations.

Installation et configuration

Il existe plusieurs façons de télécharger Adobe Commerce, notamment :

Cet exemple illustre une installation basée sur le compositeur à l’aide de la ligne de commande .

  1. Connectez-vous à votre serveur d’applications en tant que propriétaire du système de fichiers.

  2. Passez au répertoire docroot du serveur web ou à un répertoire que vous avez configuré en tant qu'hôte virtuel docroot. Pour cet exemple, nous utilisons le /var/www/html par défaut Ubuntu.

    code language-bash 
    cd /var/www/html

  3. Installez Composer globalement. Le compositeur est nécessaire pour mettre à jour les dépendances avant d’installer Adobe Commerce :

    code language-bash 
    curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/bin --filename=composer

  4. Créez un projet Composer à l’aide du métapaquet Adobe Commerce.

    Magento Open Source

    code language-bash 
    composer create-project --repository=https://repo.magento.com/ magento/project-community-edition <install-directory-name>

    Adobe Commerce

    code language-bash 
    composer create-project --repository=https://repo.magento.com/ magento/project-enterprise-edition <install-directory-name>

    A l’invite, saisissez vos clés d’authentification. Votre clé publique est votre nom d’utilisateur ; votre clé privée est votre mot de passe.

  5. Définissez les autorisations de lecture et d’écriture pour le groupe de serveurs web avant d’installer l’application. Cela est nécessaire pour que la ligne de commande puisse écrire des fichiers dans le système de fichiers.

    code language-bash 
    cd /var/www/html/<magento install directory>
    code language-bash 
    find var generated vendor pub/static pub/media app/etc -type f -exec chmod g+w {} +
    code language-bash 
    find var generated vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} +
    code language-bash 
    chown -R :www-data . # Ubuntu
    code language-bash 
    chmod u+x bin/magento

  6. Installez à partir de la ligne de commande. Cet exemple suppose que le répertoire d’installation est nommé magento2ee, que le db-host se trouve sur le même ordinateur (localhost) et que les db-name, db-user et db-password sont tous magento :

    code language-bash 
    bin/magento setup:install \
--base-url=http://localhost/magento2ee \
--db-host=localhost \
--db-name=magento \
--db-user=magento \
--db-password=magento \
--backend-frontname=admin \
--admin-firstname=admin \
--admin-lastname=admin \
--admin-email=admin@admin.com \
--admin-user=admin \
--admin-password=admin123 \
--language=en_US \
--currency=USD \
--timezone=America/Chicago \
--use-rewrites=1

  7. Basculez vers le mode Développeur :

    code language-bash 
    cd /var/www/html/magento2/bin
    code language-bash 
    ./magento deploy:mode:set developer

Configuration de Nginx

Nous vous recommandons de configurer nginx en utilisant le fichier de configuration nginx.conf.sample fourni dans le répertoire d'installation et l'hôte virtuel nginx.

Ces instructions supposent que vous utilisez l’emplacement par défaut de CentOS pour l’hôte virtuel nginx (par exemple, /etc/nginx/conf.d) et docroot par défaut (par exemple, /usr/share/nginx/html), mais vous pouvez modifier ces emplacements en fonction de votre environnement.

  1. Créez un hôte virtuel pour votre site :

    code language-bash 
    vim /etc/nginx/conf.d/magento.conf

  2. Ajoutez la configuration suivante :

    code language-conf 
    upstream fastcgi_backend {
  server  unix:/run/php-fpm/php-fpm.sock;
}

server {

  listen 80;
  server_name www.magento-dev.com;
  set $MAGE_ROOT /usr/share/nginx/html/magento2;
  include /usr/share/nginx/html/magento2/nginx.conf.sample;
}
    note note
    NOTE
    La directive include doit pointer vers l'exemple de fichier de configuration nginx dans votre répertoire d'installation.

  3. Remplacez www.magento-dev.com par votre nom de domaine.

  4. Enregistrez et quittez l’éditeur.

  5. Vérifiez que la syntaxe est correcte :

    code language-bash 
    nginx -t

  6. Redémarrez Angles :

    code language-bash 
    systemctl restart nginx

Configuration de SELinux et de Firewall

SELinux est activé par défaut sur CentOS 7. Utilisez la commande suivante pour vérifier si elle est en cours d’exécution :

sestatus

Pour configurer SELinux et le pare-feu :

  1. Installez les outils de gestion SELinux :

    code language-bash 
    yum -y install policycoreutils-python

  2. Exécutez les commandes suivantes pour modifier le contexte de sécurité du répertoire d'installation :

    code language-bash 
    semanage fcontext -a -t httpd_sys_rw_content_t '/usr/share/nginx/html/magento2/app/etc(/.*)?'
    code language-bash 
    semanage fcontext -a -t httpd_sys_rw_content_t '/usr/share/nginx/html/magento2/var(/.*)?'
    code language-bash 
    semanage fcontext -a -t httpd_sys_rw_content_t '/usr/share/nginx/html/magento2/pub/media(/.*)?'
    code language-bash 
    semanage fcontext -a -t httpd_sys_rw_content_t '/usr/share/nginx/html/magento2/pub/static(/.*)?'
    code language-bash 
    restorecon -Rv '/usr/share/nginx/html/magento2/'

  3. Installez le package de pare-feu :

    code language-bash 
    yum -y install firewalld

  4. Démarrez le service de pare-feu et configurez-le pour qu'il démarre au démarrage :

    code language-bash 
    systemctl start firewalld
    code language-bash 
    systemctl enable firewalld

  5. Exécutez les commandes suivantes pour ouvrir les ports HTTP et HTTPS afin de pouvoir accéder à l’URL de base à partir d’un navigateur web :

    code language-bash 
    firewall-cmd --permanent --add-service=http
    code language-bash 
    firewall-cmd --permanent --add-service=https
    code language-bash 
    firewall-cmd --reload

Vérification de l’installation

Ouvrez un navigateur web et accédez à l’URL de base de votre site pour vérifier l’installation.

recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995