DocumentationCommerceGuide d’installation

Nginx

Last update: Mon Jul 15 2024 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 de la ligne principale). 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 depuis la source

Après avoir terminé 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 nécessite plusieurs extensions PHP pour fonctionner correctement. Outre 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. Editez 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 G lors du test d’Adobe Commerce. Pour plus d’informations, voir Paramètres PHP requis .

  4. Enregistrez l’éditeur, puis quittez-le.

  5. Redémarrez le service php-fpm :

    code language-bash 
    systemctl restart php7.2-fpm

Installation et configuration de MySQL

Pour plus d’informations, voir MySQL .

Installation et configuration

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

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

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

  2. Modifiez le répertoire docroot du serveur web ou un répertoire que vous avez configuré comme docroot d’hôte virtuel. Pour cet exemple, nous utilisons la valeur par défaut Ubuntu /var/www/html.

    code language-bash 
    cd /var/www/html

  3. Installez le compositeur 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 de compositeur à 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>

    Lorsque vous y êtes invité, 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-écriture pour le groupe de serveurs web avant d’installer l’application. Cela est nécessaire afin 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 db-host se trouve sur le même ordinateur (localhost) et que les répertoires 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. Passez en 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 à l’aide du fichier de configuration nginx.conf.sample fourni dans le répertoire d’installation et de 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 le docroot par défaut Ubuntu (par exemple, /var/www/html). Cependant, 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. Il doit correspondre à l’URL de base que vous avez spécifiée lors de l’installation d’Adobe Commerce.

  4. Enregistrez l’éditeur, puis quittez-le.

  5. Activez l’hôte virtuel que vous venez de créer en 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 le nginx :

    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 terminé 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 a besoin de plusieurs extensions PHP pour fonctionner correctement. Outre ces extensions, vous devez également installer et configurer l’extension php-fpm si vous utilisez nginx.

  1. Installer php-fpm :

    code language-bash 
    yum -y install php70w-fpm

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

  3. Supprimez le commentaire de la ligne cgi.fix_pathinfo et remplacez la valeur par 0.

  4. Editez 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 G lors du test d’Adobe Commerce. Pour plus d’informations, voir Paramètres PHP requis .

  5. Annulez la mise en commentaire du répertoire du chemin de session et définissez le chemin d’accès :

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

  6. Enregistrez l’éditeur, puis quittez-le.

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

  8. Editez 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. Ne commentez pas les lignes de l’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 l’éditeur, puis quittez-le.

  11. Créez un répertoire pour le chemin de session PHP et remplacez le propriétaire par l’utilisateur et le 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 remplacez le propriétaire par l’utilisateur et le 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 moment du 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

Pour plus d’informations, voir MySQL .

Installation et configuration

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

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

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

  2. Modifiez le répertoire docroot du serveur web ou un répertoire que vous avez configuré comme docroot d’hôte virtuel. Pour cet exemple, nous utilisons la valeur par défaut Ubuntu /var/www/html.

    code language-bash 
    cd /var/www/html

  3. Installez le compositeur 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 de compositeur à 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>

    Lorsque vous y êtes invité, 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-écriture pour le groupe de serveurs web avant d’installer l’application. Cela est nécessaire afin 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 db-host se trouve sur le même ordinateur (localhost) et que les répertoires 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. Passez en 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 à l’aide du fichier de configuration nginx.conf.sample fourni dans le répertoire d’installation et de 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 le docroot par défaut (par exemple, /usr/share/nginx/html). Cependant, 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 l’éditeur, puis quittez-le.

  5. Vérifiez que la syntaxe est correcte :

    code language-bash 
    nginx -t

  6. Redémarrez le nginx :

    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 voir si elle est en cours d’exécution :

sestatus

Pour configurer SELinux et firewall :

  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 firewall :

    code language-bash 
    yum -y install firewalld

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

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

  5. Exécutez les commandes suivantes pour ouvrir les ports pour HTTP et HTTPS afin d’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