Démarrage rapide de l’installation locale
Créé pour :
- Expérimenté
- Administration
- Développeur
Les instructions de cette page décrivent comment installer Adobe Commerce sur une infrastructure auto-hébergée. Pour obtenir des conseils sur la mise à niveau d’une installation existante, consultez le Guide de mise à niveau.
Adobe utilise Composer pour gérer les composants Adobe Commerce et leurs dépendances. L’utilisation du compositeur pour obtenir le métapaquet Adobe Commerce offre les avantages suivants :
- Réutiliser des bibliothèques tierces sans les regrouper avec du code source
- Réduisez les conflits d’extension et les problèmes de compatibilité en utilisant une architecture basée sur des composants avec une gestion robuste des dépendances
- Respectez les normes PHP-Framework Interoperability Group (FIG)
- Recompresser le Magento Open Source avec d’autres composants
- Utilisation du logiciel Adobe Commerce dans un environnement de production
NOTEConditions préalables
Avant de poursuivre, vous devez procéder comme suit :
- Effectuez toutes les tâches préalables.
- Installez le compositeur.
- Obtenez les clés d’authentification dans le référentiel du compositeur Adobe Commerce.
Connexion en tant que propriétaire du système de fichiers
Découvrez la propriété, les autorisations et le propriétaire du système de fichiers dans la rubrique Présentation de la propriété et des autorisations.
Pour basculer vers le propriétaire du système de fichiers :
-
Connectez-vous au serveur d’applications ou basculez vers un utilisateur autorisé à écrire dans le système de fichiers.
Si vous utilisez le shell bash, vous pouvez utiliser la syntaxe suivante pour basculer sur le propriétaire du système de fichiers et entrer la commande en même temps :
su <file system owner> -s /bin/bash -c <command>Si le propriétaire du système de fichiers n’autorise pas les connexions, vous pouvez effectuer les opérations suivantes :
sudo -u <file system owner> <command> -
Pour exécuter des commandes CLI à partir de n’importe quel répertoire, ajoutez
<app_root>/binà votre systèmePATH.Comme les shell ont des syntaxes différentes, consultez une référence comme unix.stackexchange.com.
Exemple de shell Bash pour CentOS :
export PATH=$PATH:/var/www/html/magento2/binVous pouvez éventuellement exécuter les commandes des manières suivantes :
cd <app_root>/binet exécutez-les en tant que./magento <command name>app_root>/bin/magento <command name><app_root>est un sous-répertoire de votre serveur web docroot
Obtenir le métapaquet
Pour obtenir le métapaquet Adobe Commerce :
-
Connectez-vous au serveur d’applications en tant que propriétaire du système de fichiers ou passez à ce serveur.
-
Passez au répertoire docroot du serveur web ou à un répertoire que vous avez configuré en tant qu'hôte virtuel docroot.
-
Créez un projet Composer à l’aide d’un métapaquet Commerce.
Magento Open Source
composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition <install-directory-name>Adobe Commerce
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition <install-directory-name>A l’invite, saisissez vos clés d’authentification. Les clés publiques et privées sont créées et configurées à partir de Commerce Marketplace - Clés d'accès. Pour le
username, copiez et collez la valeur de la clé publique. Pour lepassword, copiez et collez la valeur de la clé privée.NOTESi vous utilisez un fichier[auth.json](https://experienceleague.adobe.com/fr/docs/commerce-cloud-service/user-guide/develop/authentication-keys)du compositeur ou une variable d’environnement configurée avec vos clés d’authentification Commerce, vous n’êtes pas invité à saisir les clés d’authentification.Si vous rencontrez des erreurs, telles que
Could not find package...ou...no matching package found, assurez-vous qu’il n’y a aucune faute de frappe dans votre commande. Si vous rencontrez toujours des erreurs, il se peut que vous ne soyez pas autorisé à télécharger Adobe Commerce. Contactez l’assistance Adobe Commerce pour obtenir de l’aide.Voir Dépannage pour obtenir de l’aide sur d’autres erreurs.
Exemple - Version mineure
Les versions mineures contiennent de nouvelles fonctionnalités, des correctifs de qualité et des correctifs de sécurité. Utilisez le compositeur pour spécifier une version mineure. Par exemple, pour spécifier le métapaquet Adobe Commerce 2.4.6 :
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>
Exemple - Correctif de qualité
Les correctifs de qualité contiennent principalement des correctifs de sécurité et fonctionnels. Cependant, ils peuvent également parfois contenir de nouvelles fonctionnalités rétrocompatibles. Utilisez le compositeur pour télécharger un correctif de qualité. Par exemple, pour spécifier le métapaquet Adobe Commerce 2.4.6 :
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>
Exemple - Correctif de sécurité
Les correctifs de sécurité contiennent uniquement des correctifs de sécurité. Ils sont conçus pour accélérer et faciliter le processus de mise à niveau.
Les correctifs de sécurité utilisent la 2.4.6-px de convention de nommage du compositeur. Utilisez le compositeur pour spécifier un correctif. Par exemple, pour télécharger le métapaquet Adobe Commerce 2.4.6-p1 :
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6-p1 <install-directory-name>
Définition des autorisations de fichier
Vous devez définir des autorisations de lecture et d’écriture pour le groupe de serveurs web avant d’installer Adobe Commerce. Cela est nécessaire pour que la ligne de commande puisse écrire des fichiers dans le système de fichiers.
cd /var/www/html/<magento install directory>
find var generated vendor pub/static pub/media app/etc -type f -exec chmod g+w {} +
find var generated vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} +
chown -R :www-data . # Ubuntu
chmod u+x bin/magento
Installation de l’application
Vous devez utiliser la ligne de commande pour installer Adobe Commerce.
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 :
bin/magento setup:install \
--base-url=http://localhost/magento2ee \
--db-host=localhost \
--db-name=magento \
--db-user=magento \
--db-password=magento \
--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=opensearch \
--opensearch-host=os-host.example.com \
--opensearch-port=9200 \
--opensearch-index-prefix=magento2 \
--opensearch-timeout=15
--backend-frontname . Cependant, Adobe recommande d’omettre cette option et de permettre à la commande d’installation de générer automatiquement un URI aléatoire. Un URI aléatoire est plus difficile à exploiter pour les pirates ou les logiciels malveillants. L’URI s’affiche dans la console une fois l’installation terminée.TIPRésumé des commandes
Pour afficher la liste complète des commandes, saisissez :
bin/magento list
Pour obtenir de l’aide sur une commande spécifique, saisissez :
bin/magento help <command>
Par exemple :
bin/magento help setup:install
bin/magento help cache:enable
Le tableau suivant résume les commandes disponibles. Les commandes sont présentées sous forme de résumé uniquement. Pour plus d'informations sur une commande, cliquez sur le lien dans la colonne Commande.
magento setup:installmagento setup:uninstallmagento setup:upgrademagento maintenance:{enable/disable}magento setup:config:setmagento module:{enable/disable}magento setup:store-config:setmagento setup:db-schema:upgrademagento setup:db-data:upgrademagento setup:db:statusmagento admin:user:createConfiguration du
déploiement Activez au minimum la base de
Magento_User données des moduleset
Magento_Authorization (la méthode la plus simple consiste à utiliser bin/magento setup:upgrade)magento listmagento helpArguments courants
Les arguments suivants sont communs à toutes les commandes. Ces commandes peuvent être exécutées avant ou après l’installation de l’application :
--help-h./magento help setup:install ou ./magento help setup:config:set.--quiet-q--no-interaction-n--verbose=1,2,3-v, -vv, -vvv--verbose=3 ou -vvv affiche le niveau de détail du débogage, qui est la sortie la plus détaillée. La valeur par défaut est --verbose=1 ou -v.--version-V--ansi--no-ansiNOTE