Documentation Commerce Guide d’installation

Installation d’Adobe Commerce

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :

Créé pour :

Expérimenté
Administration
Développeur

Avant de commencer, procédez comme suit :

Vérifiez que votre système respecte la configuration requise décrite dans la configuration requise.
Effectuez toutes les tâches préalables.
Effectuez les premières étapes d'installation. Voir Votre chemin d’installation ou de mise à niveau.
Une fois connecté au serveur d’applications, basculez vers le propriétaire du système de fichiers.
Passez en revue la présentation de Prise en main de l’installation de ligne de commande .

NOTE

Vous devez installer l’application à partir de son sous-répertoire bin.

Vous pouvez exécuter le programme d’installation plusieurs fois avec différentes options pour effectuer les tâches d’installation suivantes :

Installation en phases : par exemple, après avoir configuré votre serveur web pour SSL (Secure Sockets Layer), vous pouvez à nouveau exécuter le programme d’installation pour définir les options SSL.
Corrige les erreurs dans les installations précédentes.
Installez l’application dans une autre instance de base de données.

NOTE

Par défaut, le programme d’installation ne remplace pas la base de données si vous installez le logiciel Commerce dans la même instance de base de données. Vous pouvez utiliser le paramètre facultatif cleanup-database pour modifier ce comportement.

Voir aussi Mise à jour, réinstallation, désinstallation.

Installation sécurisée

Pour utiliser le protocole SSL (Secure Sockets Layer), également appelé HTTPS, pour l’administrateur et le storefront, vous devez définir tous les paramètres suivants :

--use-secure : Défini sur 1
--base-url-secure : défini sur une URL sécurisée (commençant par https://)
--use-secure-admin Défini sur 1

Vous trouverez plus d’informations sur ces paramètres plus loin dans cette rubrique.

Commandes d’aide du programme

Vous pouvez exécuter les commandes suivantes pour rechercher des valeurs pour certains arguments requis :

Argument du programme d'installation

Commande

Langue

magento info:language:list

Devise

magento info:currency:list

Fuseau horaire

magento info:timezone:list

NOTE

Si une erreur s’affiche lors de l’exécution de ces commandes, vérifiez que vous avez mis à jour les dépendances d’installation comme décrit dans la section Mise à jour des dépendances d’installation.

Installation à partir de la ligne de commande

La commande install utilise le format suivant :

magento setup:install --<option>=<value> ... --<option>=<value>

Les tableaux suivants décrivent les noms et les valeurs des options d’installation, telles que les commandes d’installation. Voir Exemple d’installations localhost.

NOTE

Toutes les options contenant des espaces ou des caractères spéciaux doivent être entourées de guillemets simples ou doubles.

Informations d’identification d’administrateur :

Les options suivantes spécifient les informations d’identification et les informations d’identification de l’utilisateur administrateur.

Dans Adobe Commerce version 2.2.8 et ultérieure, vous pouvez créer l’utilisateur administrateur pendant ou après l’installation. Si vous créez l’utilisateur pendant l’installation, toutes les variables d’informations d’identification d’administrateur sont requises. Voir Exemple d’installations localhost.

Nom

Valeur

Obligatoire ?

--admin-firstname

Prénom de l’utilisateur administrateur.

Oui

--admin-lastname

Nom de l’utilisateur administrateur.

Oui

--admin-email

Adresse électronique de l’utilisateur administrateur.

Oui

--admin-user

Nom d’utilisateur administrateur.

Oui

--admin-password

Mot de passe de l’administrateur. Le mot de passe doit contenir au moins 7 caractères et au moins un caractère alphabétique et au moins un caractère numérique. Nous vous recommandons un mot de passe plus long et plus complexe. Entourez l’intégralité de la chaîne du mot de passe de guillemets simples. Par exemple, --admin-password='A0b9%t3g'

Oui

Options de configuration du site et de la base de données :

Nom

Valeur

Obligatoire ?

--base-url

URL de base à utiliser pour accéder à votre Admin et à votre storefront dans l’un des formats suivants :

http[s]://<host or ip>/<your install dir>/.

Remarque : Le schéma (http:// ou https://) et une barre oblique de fin sont tous les deux requis.

<your install dir> est le chemin d’accès relatif au docroot dans lequel installer l’application. Selon la configuration de votre serveur web et de vos hôtes virtuels, le chemin peut être magento2 ou il peut être vide.

Pour accéder à l’application sur localhost, vous pouvez utiliser http://127.0.0.1/<your install dir>/ ou http://127.0.0.1/<your install dir>/.

- {{base_url}} qui représente une URL de base définie par un paramètre d’hôte virtuel ou par un environnement de virtualisation tel que Docker. Par exemple, si vous configurez un hôte virtuel avec le nom d’hôte commerce.example.com, vous pouvez installer l’application avec --base-url={{base_url}} et accéder à l’administrateur avec une URL du type http://commerce.example.com/admin.

Oui

--backend-frontname

URI (Uniform Resource Identifier) pour accéder à l’administrateur. Vous pouvez omettre ce paramètre pour laisser l’application générer un URI aléatoire pour vous avec le modèle suivant admin_jkhgdfq.

Nous recommandons un URI aléatoire à des fins de sécurité. Un URI aléatoire est plus difficile à exploiter pour les hackers ou les logiciels malveillants.

L’URI s’affiche à la fin de l’installation. Vous pouvez l’afficher ultérieurement à tout moment à l’aide de la commande magento info:adminuri.

Si vous choisissez de saisir une valeur, nous vous recommandons de ne pas utiliser un mot commun tel que admin, backend. L’URI d’administration ne peut contenir que des valeurs alphanumériques et le caractère de soulignement (_).

Non

--db-host

Utilisez l’une des méthodes suivantes :

- Nom d’hôte complet du serveur de base de données ou adresse IP.

- localhost (par défaut) ou 127.0.0.1 si votre serveur de base de données se trouve sur le même hôte que votre serveur web.localhost signifie que la bibliothèque cliente MySQL utilise des sockets UNIX pour se connecter à la base de données. 127.0.0.1 entraîne l’utilisation du protocole TCP par la bibliothèque cliente. Pour plus d’informations sur les sockets, consultez la documentation PHP PDO_MYSQL.

Remarque : Vous pouvez éventuellement spécifier le port du serveur de base de données dans son nom d’hôte comme www.example.com:9000

Oui

--db-name

Nom de l'instance de base de données dans laquelle vous souhaitez installer les tables de base de données.

La valeur par défaut est magento2.

Oui

--db-user

Nom d’utilisateur du propriétaire de l’instance de base de données.

La valeur par défaut est root.

Oui

--db-password

Mot de passe du propriétaire de l’instance de base de données.

Oui

--db-prefix

À utiliser uniquement si vous installez les tables de base de données dans une instance de base de données qui contient déjà des tables Adobe Commerce.

Dans ce cas, utilisez un préfixe pour identifier les tables pour cette installation. Certains clients disposent de plusieurs instances Adobe Commerce s’exécutant sur un serveur avec toutes les tables dans la même base de données.

Le préfixe peut contenir, au maximum, cinq caractères. Il doit commencer par une lettre et ne peut contenir que des lettres, des chiffres et des caractères de soulignement.

Cette option permet à ces clients de partager le serveur de base de données avec plusieurs installations.

Non

--db-ssl-key

Chemin d’accès à la clé client.

Non

--db-ssl-cert

Chemin d’accès au certificat client.

Non

--db-ssl-ca

Chemin d’accès au certificat du serveur.

Non

--language

Code de langue à utiliser dans l’Admin et le storefront. (Si vous ne l’avez pas déjà fait, vous pouvez afficher la liste des codes de langue en saisissant magento info:language:list à partir du répertoire bin.)

Non

--currency

Devise par défaut à utiliser dans le storefront. (Si vous ne l’avez pas déjà fait, vous pouvez afficher la liste des devises en saisissant magento info:currency:list à partir du répertoire bin.)

Non

--timezone

Fuseau horaire par défaut à utiliser dans l’administration et le storefront. (Si vous ne l’avez pas déjà fait, vous pouvez afficher la liste des fuseaux horaires en entrant magento info:timezone:list à partir du répertoire bin.)

Non

--use-rewrites

1 signifie que vous utilisez des réécritures de serveur web pour les liens générés dans le storefront et l’administrateur.

0 désactive l’utilisation des réécritures de serveur web. Il s’agit du paramètre par défaut.

Non

--use-secure

1 permet l’utilisation de SSL (Secure Sockets Layer) dans les URL de storefront. Assurez-vous que votre serveur web prend en charge SSL avant de sélectionner cette option.

0 désactive l’utilisation de SSL. Dans ce cas, toutes les autres options d’URL sécurisées sont également supposées être 0. Il s’agit du paramètre par défaut.

Non

--base-url-secure

URL de base sécurisée à utiliser pour accéder à votre Admin et à votre storefront au format suivant : http[s]://<host or ip>/<your install dir>/

Non

--use-secure-admin

1 signifie que vous utilisez SSL pour accéder à l’administrateur. Assurez-vous que votre serveur web prend en charge SSL avant de sélectionner cette option.

0 signifie que vous n’utilisez pas SSL avec l’administrateur. Il s’agit du paramètre par défaut.

Non

--admin-use-security-key

1 fait en sorte que l’application utilise une valeur de clé générée de manière aléatoire pour accéder aux pages dans l’administrateur et dans les formulaires. Ces valeurs clés permettent d’éviter les attaques par falsification de script intersite. Il s’agit du paramètre par défaut.

0 désactive l’utilisation de la clé.

Non

--session-save

Utilisez l’une des méthodes suivantes :

- db pour stocker les données de session dans la base de données. Choisissez le stockage de la base de données si vous disposez d’une base de données en grappe ; dans le cas contraire, le stockage basé sur les fichiers n’offre pas beaucoup d’avantages.

- files pour stocker les données de session dans le système de fichiers. Le stockage des sessions basées sur des fichiers est approprié, sauf si l’accès au système de fichiers est lent, si vous disposez d’une base de données en grappe ou si vous souhaitez stocker des données de session dans Redis.

- redis pour stocker des données de session dans Redis. Si vous utilisez Redis pour la mise en cache des pages ou par défaut, Redis doit être déjà installé. Pour plus d’informations sur la configuration de la prise en charge de Redis, reportez-vous à la section Utilisation des rendus pour le stockage de session .

Non

--key

Si vous en avez un, spécifiez une clé pour crypter les données sensibles dans la base de données. Si vous n’en avez pas, l’application en génère une pour vous.

Oui

--cleanup-database

Pour déposer les tables de base de données avant d'installer l'application, indiquez ce paramètre sans valeur. Sinon, la base de données reste intacte.

Non

--db-init-statements

Paramètre de configuration MySQL avancé. Utilise les instructions d’initialisation de base de données à exécuter lors de la connexion à la base de données MySQL. Consultez une référence similaire à celle-ci avant de définir des valeurs.

La valeur par défaut est SET NAMES utf8;.

Non

--sales-order-increment-prefix

Spécifiez une valeur string à utiliser comme préfixe pour les commandes client. En règle générale, il est utilisé pour garantir des numéros de commande uniques aux responsables du paiement.

Non

TIP

Pour activer les services de stockage distant lors de l’installation, voir Configuration du stockage distant dans le Guide de configuration.

Options de configuration du moteur de recherche :

Nom

Valeur

Obligatoire ?

--search-engine

Version du moteur de recherche. Les valeurs possibles sont elasticsearch7, elasticsearch6 et elasticsearch5. La valeur par défaut est elasticsearch7. Si vous avez installé OpenSearch en tant que moteur de recherche, spécifiez la valeur elasticsearch7. Elasticsearch 5 a été abandonné et n’est pas recommandé.

Non

--elasticsearch-host

Nom d’hôte ou adresse IP où le moteur de recherche est en cours d’exécution. La valeur par défaut est localhost.

Non

--elasticsearch-port

Port des requêtes HTTP entrantes. La valeur par défaut est 9200.

Non

--elasticsearch-index-prefix

Préfixe qui identifie l’index de recherche. La valeur par défaut est magento2.

Non

--elasticsearch-timeout

Nombre de secondes avant que le système ne s’arrête. La valeur par défaut est 15.

Non

--elasticsearch-enable-auth

Active l’authentification sur le serveur du moteur de recherche. La valeur par défaut est false.

Non

--elasticsearch-username

ID utilisateur à authentifier

Non, sauf si l’authentification est activée

--elasticsearch-password

Mot de passe pour l’authentification

Non, sauf si l’authentification est activée

RabbitMQoptions de configuration :

Nom

Valeur

Obligatoire ?

--amqp-host

N’utilisez pas les options --amqp, sauf si vous avez déjà configuré une installation de RabbitMQ. Voir RabbitMQ installation pour plus d'informations sur l'installation et la configuration de RabbitMQ.

Nom d’hôte sur lequel RabbitMQ est installé.

Non

--amqp-port

Port à utiliser pour la connexion à RabbitMQ. La valeur par défaut est 5672.

Non

--amqp-user

Nom d’utilisateur pour la connexion à RabbitMQ. N’utilisez pas l’utilisateur par défaut guest.

Non

--amqp-password

Mot de passe de la connexion à RabbitMQ. N’utilisez pas le mot de passe par défaut guest.

Non

--amqp-virtualhost

L’hôte virtuel pour la connexion à RabbitMQ. La valeur par défaut est /.

Non

--amqp-ssl

Indique s’il faut se connecter à RabbitMQ. La valeur par défaut est false. Voir RabbitMQ pour plus d’informations sur la configuration de SSL pour RabbitMQ.

Non

--consumers-wait-for-messages

Les consommateurs doivent-ils attendre un message de la file d’attente ? 1 - Oui, 0 - Non

Non

Options de stockage à distance :

Nom

Description

Obligatoire ?

remote-storage-driver

Nom de l’adaptateur
Valeurs possibles :
file : désactive le stockage distant et utilise le système de fichiers local
aws-s3 : utilisez le service de stockage simple Amazon (Amazon S3)

Non

remote-storage-bucket

Stockage d’objet ou nom du conteneur

Non

remote-storage-prefix

Préfixe facultatif (emplacement dans le stockage d’objets)

Non

remote-storage-region

Nom de la région

Non

remote-storage-key

Clé d’accès facultative

Non

remote-storage-secret

Clé secrète facultative

Non

Verrouiller les options de configuration :

Nom

Valeur

Obligatoire ?

--lock-provider

Verrouillez le nom du fournisseur.

Fournisseurs de verrouillage disponibles : db, zookeeper, file.

Le fournisseur de verrouillage par défaut : db

Non

--lock-db-prefix

Préfixe db spécifique pour éviter les conflits de verrouillage lors de l'utilisation du fournisseur de verrouillage db.

La valeur par défaut : NULL

Non

--lock-zookeeper-host

Hébergez et port pour vous connecter à la grappe Zookeeper lorsque vous utilisez le fournisseur de verrouillage zookeeper.

Par exemple : 127.0.0.1:2181

Oui, si vous définissez --lock-provider=zookeeper

--lock-zookeeper-path

Chemin d’accès dans lequel le gardien de page enregistre les verrous.

Le chemin par défaut est : /magento/locks

Non

--lock-file-path

Chemin d’accès où les verrous de fichier sont enregistrés.

Oui, si vous définissez --lock-provider=file

Options de configuration des consommateurs :

Nom

Description

Valeur

Obligatoire

--consumers-wait-for-messages

Détermine si les consommateurs attendront un message de la file d’attente.

1 - Oui, 0 - Non

Non

0 : les consommateurs traitent les messages disponibles dans la file d’attente, ferment la connexion TCP et s’arrêtent. Les consommateurs n’attendent pas que des messages supplémentaires entrent dans la file d’attente, même si le nombre de messages traités est inférieur à la valeur --max_messages spécifiée lors du démarrage des consommateurs.
1 : les consommateurs continuent à traiter les messages de la file d’attente des messages jusqu’à atteindre le nombre maximal de messages (la valeur spécifiée pour --max_messages sur la commande queue:consumers:start) avant de fermer la connexion TCP et d’interrompre le processus du consommateur. Si la file d’attente se vide avant d’atteindre --max_messages, le consommateur attend que d’autres messages arrivent. Si vous utilisez des programmes de travail pour exécuter des consommateurs au lieu d’utiliser une tâche cron, définissez cette variable sur 1.

WARNING

L’option --consumers-wait-for-messages est une option globale qui ne peut pas être configurée séparément pour chaque consommateur.

NOTE

Pour activer ou désactiver les modules après l’installation de l’application, voir Activation et désactivation des modules.

Données sensibles :

Adobe Commerce utilise votre clé de chiffrement pour chiffrer les éléments suivants :

Informations sur la carte de crédit
Noms d’utilisateur et mots de passe spécifiés dans la configuration Admin (par exemple, connexions aux passerelles de paiement)
Valeurs CAPTCHA envoyées sur le réseau

Adobe Commerce do not encrypt :

Noms d’utilisateur et mots de passe administratifs et clients (ces mots de passe sont hachés)
Adresse
Numéro de téléphone
Autres types d’informations d’identification personnelle, à l’exception des numéros de carte de crédit

Exemples d’installations localhost

Les exemples suivants présentent les commandes permettant d’installer Adobe Commerce en local avec différentes options.

Exemple 1 : installation de base avec compte utilisateur admin

L’exemple suivant installe l’application avec les options suivantes :

L’application est installée dans le répertoire magento2 par rapport à la docroot du serveur web sur localhost et le chemin d’accès à l’administrateur est admin. Par conséquent :

Votre URL de storefront est http://127.0.0.1
Le serveur de base de données se trouve sur le même hôte que le serveur web.

Le nom de la base de données est magento et le nom d’utilisateur et le mot de passe sont magento.
Utilise les réécritures du serveur
L’administrateur possède les propriétés suivantes :
- Les prénoms et les noms sont Commerce User
- Le nom d'utilisateur est admin et le mot de passe est admin123
- L’adresse électronique est user@example.com
La langue par défaut est en_US (anglais américain)
La devise par défaut est le dollar américain
Le fuseau horaire par défaut est centré aux États-Unis (Amérique/Chicago)
Elasticsearch 7 est installé sur es-host.example.com et se connecte sur le port 9200

magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--admin-firstname=Commerce --admin-lastname=User --admin-email=user@example.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

Messages similaires à l’affichage suivant pour indiquer une installation réussie :

Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q

Exemple 2 : installation de base sans compte utilisateur administrateur

Vous pouvez installer l’application sans créer d’utilisateur administrateur, comme illustré dans l’exemple suivant.

magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--language=en_US --currency=USD --timezone=America/Chicago --use-rewrites=1 \
--search-engine=elasticsearch7 --elasticsearch-host=es-host.example.com \
--elasticsearch-port=9200

Les messages comme celui-ci s’affichent si l’installation est réussie :

Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q

Après l’installation, vous pouvez créer un utilisateur administrateur à l’aide de la commande admin:user:create :
Créez ou modifiez un administrateur

Exemple 3 : installation avec des options supplémentaires

L’exemple suivant installe l’application avec les options suivantes :

La Magapplication est installée dans le répertoire magento2 relatif au docroot du serveur web sur localhost et le chemin d’accès à l’administrateur est admin. Par conséquent :

Votre URL de storefront est http://127.0.0.1
Le serveur de base de données se trouve sur le même hôte que le serveur web.

Le nom de la base de données est magento et le nom d’utilisateur et le mot de passe sont magento.
L’administrateur possède les propriétés suivantes :
- Les prénoms et les noms sont Commerce User
- Le nom d'utilisateur est admin et le mot de passe est admin123
- L’adresse électronique est user@example.com
La langue par défaut est en_US (anglais américain)
La devise par défaut est le dollar américain
Le fuseau horaire par défaut est centré aux États-Unis (Amérique/Chicago)
Le programme d’installation nettoie d’abord la base de données avant d’installer les tables et le schéma.
Vous utilisez un préfixe d’incrément de commande client ORD$ (puisqu’il contient un caractère spécial [$], la valeur doit être mise entre guillemets doubles).
Les données de session sont enregistrées dans la base de données.
Utilise les réécritures du serveur
Elasticsearch 7 est installé sur es-host.example.com et se connecte sur le port 9200

magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--admin-firstname=Commerce --admin-lastname=User --admin-email=user@example.com \
--admin-user=admin --admin-password=admin123 --language=en_US \
--currency=USD --timezone=America/Chicago --cleanup-database \
--sales-order-increment-prefix="ORD$" --session-save=db --use-rewrites=1 \
--search-engine=elasticsearch7 --elasticsearch-host=es-host.example.com \
--elasticsearch-port=9200

NOTE

Vous devez saisir la commande sur une seule ligne ou, comme dans l’exemple précédent, avec un caractère \ à la fin de chaque ligne.

Les messages comme celui-ci s’affichent si l’installation est réussie :

Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q

TIP

Si vous disposez d’un compte utilisateur pour accéder au serveur d’applications, voir définition d’un umask. Ce type de configuration est typique pour l’hébergement partagé.

recommendation-more-help

0f8e7db5-0e9c-4002-a5b8-a0088077d995