Installation sur site avancée
Interface de ligne de commande
Adobe Commerce dispose d'une seule interface de ligne de commande pour les tâches d'installation et de configuration : <magento_root>/bin/magento
. L’interface effectue plusieurs tâches, notamment :
- Installation (et tâches associées, telles que la création ou la mise à jour du schéma de base de données, la création de la configuration de déploiement).
- Effacement du cache.
- Gestion des index, y compris la réindexation.
- Création de dictionnaires de traduction et de packages de traduction.
- Génération de classes inexistantes, telles que des usines et des intercepteurs pour les modules externes, générant la configuration d’injection de dépendance pour le gestionnaire d’objets.
- Déploiement de fichiers d’affichage statiques.
- Création de CSS à partir de Less.
Autres avantages :
- Une seule commande (
<magento_root>/bin/magento list
) répertorie toutes les commandes d’installation et de configuration disponibles. - Interface utilisateur cohérente basée sur Symfony.
- L’interface en ligne de commande est extensible, de sorte que les développeurs tiers puissent y "se connecter". Cela permet également d’éliminer la courbe d’apprentissage des utilisateurs.
- Les commandes des modules désactivés ne s’affichent pas.
Cette rubrique aborde l’installation du logiciel Adobe Commerce à l’aide de l’interface de ligne de commande. Pour plus d’informations sur la configuration, voir le Guide de configuration.
Le programme d’installation peut être exécuté plusieurs fois si nécessaire afin que vous puissiez :
-
Fournir des valeurs différentes
Par exemple, après avoir configuré votre serveur web pour SSL (Secure Sockets Layer), vous pouvez exécuter le programme d’installation pour définir les options SSL.
-
Correction des erreurs dans les installations précédentes
-
Installer Adobe Commerce dans une autre instance de base de données
Avant de commencer l’installation
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.
-
Examinez l’aperçu démarrage rapide de l’installation .
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 Adobe Commerce dans une autre instance de base de données.
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 sur1
--base-url-secure
: défini sur une URL sécurisée (commençant parhttps://
)--use-secure-admin
Défini sur1
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 :
bin/magento info:language:list
bin/magento info:currency:list
bin/magento info:timezone:list
Installation à partir de la ligne de commande
La commande install utilise le format suivant :
bin/magento setup:install --<option>=<value> ... --<option>=<value>
Les tableaux suivants décrivent les noms et les valeurs des options d’installation. Par exemple, pour les commandes d’installation, voir Exemple d’installation localhost.
Informations d’identification d’administrateur :
Les options suivantes spécifient les informations d’identification et les informations d’identification de l’utilisateur administrateur.
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.
Les tableaux suivants contiennent de nombreux paramètres d’installation disponibles, mais pas tous. Pour obtenir une liste complète, voir la référence des outils de ligne de commande.
--admin-firstname
--admin-lastname
--admin-email
--admin-user
--admin-password
--admin-password='A0b9%t3g'
Options de configuration du site et de la base de données :
--base-url
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 le logiciel Adobe Commerce. 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 à Adobe Commerce ou MagenAdobe Commerce
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 magento.example.com
, vous pouvez installer le logiciel avec --base-url={{base_url}}
et accéder à l’administrateur avec une URL du type http://magento.example.com/admin
.--backend-frontname
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
bin/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 (
_
).--db-host
- 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
--db-name
La valeur par défaut est
magento2
.--db-user
La valeur par défaut est
root
.--db-password
--db-prefix
Dans ce cas, utilisez un préfixe pour identifier les tables pour cette installation. Certains clients ont plusieurs Adobe Commerce ou MagenAdobe Commerceserver 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 Adobe Commerce.
--db-ssl-key
--db-ssl-cert
--db-ssl-ca
--language
bin/magento info:language:list
à partir du répertoire bin.)--currency
bin/magento info:currency:list
à partir du répertoire bin.)--timezone
bin/magento info:timezone:list
à partir du répertoire bin/
.)--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.--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.--base-url-secure
http[s]://<host or ip>/<your install dir>/
--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.--admin-use-security-key
0
désactive l’utilisation de la clé.--session-save
-
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 .--key
--cleanup-database
--db-init-statements
La valeur par défaut est
SET NAMES utf8;
.--sales-order-increment-prefix
Options de configuration du moteur de recherche :
--search-engine
elasticsearch7
. Elasticsearch 5 a été abandonné et n’est pas recommandé.--elasticsearch-host
localhost
.--elasticsearch-port
9200
.--elasticsearch-index-prefix
magento2
.--elasticsearch-timeout
15
.--elasticsearch-enable-auth
false
.--elasticsearch-username
--elasticsearch-password
--opensearch-host
localhost
.--opensearch-port
9200
.--opensearch-index-prefix
magento2
.--opensearch-timeout
15
.--opensearch-enable-auth
false
.--opensearch-username
--opensearch-password
RabbitMQoptions de configuration :
--amqp-host
--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é.
--amqp-port
--amqp-user
guest
.--amqp-password
guest
.--amqp-virtualhost
/
.--amqp-ssl
false
. Voir RabbitMQ pour plus d’informations sur la configuration de SSL pour RabbitMQ.--consumers-wait-for-messages
Verrouiller les options de configuration :
--lock-provider
Fournisseurs de verrouillage disponibles :
db
, zookeeper
, file
.Le fournisseur de verrouillage par défaut :
db
--lock-db-prefix
db
.La valeur par défaut :
NULL
--lock-zookeeper-host
zookeeper
.Par exemple :
127.0.0.1:2181
--lock-provider=zookeeper
--lock-zookeeper-path
Le chemin par défaut est :
/magento/locks
--lock-file-path
--lock-provider=file
Options de configuration des consommateurs :
--consumers-wait-for-messages
-
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 commandequeue: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 sur1
.
--consumers-wait-for-messages
est une option globale qui ne peut pas être configurée séparément pour chaque consommateur.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 Adobe Commerce avec les options suivantes :
-
L’application est installée dans le répertoire
magento2
par rapport à la docroot du serveur web surlocalhost
et le chemin d’accès à l’administrateur estadmin
. 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 sontmagento
. -
Utilise les réécritures du serveur
-
L’administrateur possède les propriétés suivantes :
- Les prénoms et les noms sont
Magento User
- Le nom d'utilisateur est
admin
et le mot de passe estadmin123
- L’adresse électronique est
user@example.com
- Les prénoms et les noms sont
-
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)
-
OpenSearch 1.2 est installé sur
os-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=Magento --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=opensearch --opensearch-host=os-host.example.com \
--opensearch-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 Adobe Commerce 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=opensearch --opensearch-host=os-host.example.com \
--opensearch-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 Adobe Commerce avec les options suivantes :
-
L’application est installée dans le répertoire
magento2
par rapport à la docroot du serveur web surlocalhost
et le chemin d’accès à l’administrateur estadmin
. 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 sontmagento
. -
L’administrateur possède les propriétés suivantes :
- Les prénoms et les noms sont
Magento User
- Le nom d'utilisateur est
admin
et le mot de passe estadmin123
- L’adresse électronique est
user@example.com
- Les prénoms et les noms sont
-
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 pouvez utiliser le 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
-
OpenSearch est installé sur
os-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=Magento --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=opensearch --opensearch-host=os-host.example.com \
--opensearch-port=9200
\
à 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