Erweiterte lokale Installation
Befehlszeilenschnittstelle (CLI)
Adobe Commerce verfügt über eine einzige Befehlszeilenschnittstelle für Installations- und Konfigurationsaufgaben: <magento_root>/bin/magento
. Die Benutzeroberfläche führt mehrere Aufgaben aus, darunter:
- Installation (und damit zusammenhängende Aufgaben wie das Erstellen oder Aktualisieren des Datenbankschemas, das Erstellen der Bereitstellungskonfiguration).
- Löschen des Cache.
- Verwalten von Indizes, einschließlich Neuindizierung.
- Erstellen von Übersetzungswörterbüchern und Übersetzungspaketen.
- Generieren nicht vorhandener Klassen wie Factories und Interceptors für Plug-ins und Generieren der Konfiguration für die Injektion von Abhängigkeiten für den Objekt-Manager.
- Bereitstellen von statischen Ansichtsdateien.
- Erstellen von CSS aus Less.
Weitere Vorteile:
- Ein einzelner Befehl (
<magento_root>/bin/magento list
) listet alle verfügbaren Installations- und Konfigurationsbefehle auf. - Konsistente Benutzeroberfläche basierend auf Symfony.
- Die CLI ist erweiterbar, sodass sich Drittanbieter-Entwickler damit „verbinden“ können. Dies hat den zusätzlichen Vorteil, dass die Lernkurve der Benutzer eliminiert wird.
- Befehle für deaktivierte Module werden nicht angezeigt.
In diesem Abschnitt wird die Installation der Adobe Commerce-Software mithilfe der CLI beschrieben. Informationen zur Konfiguration finden Sie im Konfigurationshandbuch.
Das Installationsprogramm kann bei Bedarf mehrmals ausgeführt werden. So haben Sie folgende Möglichkeiten:
-
Unterschiedliche Werte angeben
Nachdem Sie beispielsweise Ihren Webserver für SSL (Secure Sockets Layer) konfiguriert haben, können Sie das Installationsprogramm ausführen, um SSL-Optionen festzulegen.
-
Fehler in früheren Installationen korrigieren
-
Installieren von Adobe Commerce in einer anderen Datenbankinstanz
Vor der Installation
Bevor Sie beginnen, führen Sie die folgenden Schritte aus:
-
Stellen Sie sicher, dass Ihr System die unter (Systemanforderungen beschriebenen Anforderungen.
-
Alle () Aufgaben.
-
Führen Sie die ersten Installationsschritte aus. Siehe Ihr Installations- oder Aktualisierungspfad.
-
Wechseln Sie nach der Anmeldung beim Anwendungsserver zum Dateisystembesitzer.
-
Überprüfen Sie die Schnellstart für die Installation Übersicht.
bin
-Unterverzeichnis installieren.Sie können das Installationsprogramm mehrmals mit verschiedenen Optionen ausführen, um Installationsaufgaben wie die folgenden durchzuführen:
-
Installieren Sie in Phasen - Nachdem Sie beispielsweise Ihren Webserver für SSL (Secure Sockets Layer) konfiguriert haben, können Sie das Installationsprogramm erneut ausführen, um SSL-Optionen festzulegen.
-
Fehler in früheren Installationen korrigieren.
-
Installieren Sie Adobe Commerce in einer anderen Datenbankinstanz.
cleanup-database
können Sie dieses Verhalten ändern.Siehe auch Aktualisieren, Neu installieren, Deinstallieren.
Sichere Installation
Um Secure Sockets Layer (SSL), auch als HTTPS bezeichnet, sowohl für die Admin- als auch für die Storefront zu verwenden, müssen Sie alle folgenden Parameter festlegen:
--use-secure
: Auf1
festlegen--base-url-secure
: Auf eine sichere URL festlegen (d. h., mithttps://
beginnen)--use-secure-admin
festgelegt auf1
Weitere Informationen zu diesen Parametern finden Sie weiter unten in diesem Thema.
Hilfe-Befehle des Installationsprogramms
Sie können die folgenden Befehle ausführen, um Werte für einige erforderliche Argumente zu finden:
bin/magento info:language:list
bin/magento info:currency:list
bin/magento info:timezone:list
Installieren über die Befehlszeile
Der Installationsbefehl verwendet das folgende Format:
bin/magento setup:install --<option>=<value> ... --<option>=<value>
In den folgenden Tabellen werden die Namen und Werte der Installationsoptionen beschrieben. Beispiele für Installationsbefehle finden Sie unter Beispiele für localhost-Installationen.
Admin-Anmeldedaten:
Die folgenden Optionen geben die Benutzerinformationen und Anmeldeinformationen für den Admin-Benutzer an.
Sie können den Admin-Benutzer während oder nach der Installation erstellen. Wenn Sie den Benutzer während der Installation erstellen, sind alle Variablen mit Administratorberechtigungen erforderlich. Siehe Beispiel für localhost-Installationen.
Die folgenden Tabellen enthalten viele, aber nicht alle verfügbaren Installationsparameter. Eine vollständige Liste finden Sie in Referenz zu Befehlszeilen-Tools.
--admin-firstname
--admin-lastname
--admin-email
--admin-user
--admin-password
--admin-password='A0b9%t3g'
Site- und Datenbankkonfigurationsoptionen:
--base-url
http[s]://<host or ip>/<your install dir>/
.Hinweis: Das Schema (http:// oder https://) und ein Schrägstrich am Ende sind beide erforderlich.
<your install dir>
ist der docroot-bezogene Pfad, in dem die Adobe Commerce-Software installiert werden soll. Je nachdem, wie Sie Ihren Webserver und die virtuellen Hosts einrichten, kann der Pfad Magento2 oder leer sein.Verwenden Sie entweder
http://127.0.0.1/<your install dir>/
oder http://127.0.0.1/<your install dir>/
, um auf Adobe Commerce oder MagenAdobe Commerce zuzugreifen.-
{{base_url}}
, die eine Basis-URL darstellt, die durch eine Virtual-Host-Einstellung oder eine Virtualisierungsumgebung wie Docker definiert ist. Wenn Sie beispielsweise einen virtuellen Host mit dem Host-Namen magento.example.com
einrichten, können Sie die Software mit --base-url={{base_url}}
installieren und mit einer URL wie http://magento.example.com/admin
auf den Admin zugreifen.--backend-frontname
admin_jkhgdfq
.Aus Sicherheitsgründen wird ein zufälliger URI empfohlen. Ein zufälliger URI ist für Hacker oder bösartige Software schwieriger auszunutzen.
Der URI wird am Ende der Installation angezeigt. Sie können ihn jederzeit mithilfe des Befehls
bin/magento info:adminuri
anzeigen.Wenn Sie einen Wert eingeben möchten, empfehlen wir, kein gängiges Wort wie „admin“ oder „backend“ zu verwenden. Der Admin-URI kann nur alphanumerische Werte und den Unterstrich (
_
) enthalten.--db-host
- Der voll qualifizierte Hostname oder die IP-Adresse des Datenbankservers.
-
localhost
(Standard) oder 127.0.0.1
, wenn sich Ihr Datenbankserver auf demselben Host wie Ihr Webserver befindet.localhost bedeutet, dass die MySQL-Client-Bibliothek UNIX-Sockets verwendet, um eine Verbindung zur Datenbank herzustellen. 127.0.0.1
verwendet die Client-Bibliothek das TCP-Protokoll. Weitere Informationen zu Sockets finden Sie in der PHP PDO_MYSQL-Dokumentation.Hinweis: Sie können optional den Datenbank-Server-Port in seinem Hostnamen wie www.example.com:9000 angeben
--db-name
Der Standardwert ist
magento2
.--db-user
Der Standardwert ist
root
.--db-password
--db-prefix
Verwenden Sie in diesem Fall ein Präfix, um die Tabellen für diese Installation zu identifizieren. Einige Kunden verfügen über mehr als einen Adobe Commerce- oder MagenAdobe Commerce-Server mit allen Tabellen in derselben Datenbank.
Das Präfix darf maximal fünf Zeichen lang sein. Sie muss mit einem Buchstaben beginnen und darf nur Buchstaben, Zahlen und Unterstriche enthalten.
Mit dieser Option können diese Kunden den Datenbankserver für mehr als eine Adobe Commerce-Installation freigeben
--db-ssl-key
--db-ssl-cert
--db-ssl-ca
--language
bin/magento info:language:list
aus dem Verzeichnis bin eingeben.)--currency
bin/magento info:currency:list
aus dem Verzeichnis bin eingeben.)--timezone
bin/magento info:timezone:list
aus dem bin/
eingeben.)--use-rewrites
1
bedeutet, dass Sie Webserver-Neuschreibungen für generierte Links in der Storefront und in Admin verwenden.0
Deaktiviert die Verwendung von Webserver-Neuschreibungen. Dies ist der Standardwert.--use-secure
1
ermöglicht die Verwendung von SSL (Secure Sockets Layer) in Storefront-URLs. Stellen Sie sicher, dass Ihr Webserver SSL unterstützt, bevor Sie diese Option auswählen.0
deaktiviert die Verwendung von SSL. In diesem Fall wird davon ausgegangen, dass alle anderen sicheren URL-Optionen ebenfalls 0 sind. Dies ist der Standardwert.--base-url-secure
http[s]://<host or ip>/<your install dir>/
--use-secure-admin
1
bedeutet, dass Sie SSL verwenden, um auf den Administrator zuzugreifen. Stellen Sie sicher, dass Ihr Webserver SSL unterstützt, bevor Sie diese Option auswählen.0
bedeutet, dass Sie SSL nicht mit dem Administrator verwenden. Dies ist der Standardwert.--admin-use-security-key
0
Deaktiviert die Verwendung des Schlüssels.--session-save
-
db
, um Sitzungsdaten in der Datenbank zu speichern. Wählen Sie Datenbankspeicher, wenn Sie eine geclusterte Datenbank haben. Andernfalls gibt es möglicherweise keinen großen Vorteil gegenüber dateibasiertem Speicher.-
files
, Sitzungsdaten im Dateisystem zu speichern. Die dateibasierte Sitzungsspeicherung ist geeignet, es sei denn, der Dateisystemzugriff ist langsam, Sie verfügen über eine geclusterte Datenbank oder Sie möchten Sitzungsdaten in Redis speichern.-
redis
zum Speichern von Sitzungsdaten in Redis. Wenn Sie Redis für das Standard- oder Seiten-Caching verwenden, muss Redis bereits installiert sein. Weitere Informationen zum Konfigurieren der Unterstützung für Redis finden Sie unter Verwenden von Redis für den Sitzungsspeicher .--key
--cleanup-database
--db-init-statements
Der Standardwert ist
SET NAMES utf8;
.--sales-order-increment-prefix
Konfigurationsoptionen für Suchmaschinen:
--search-engine
elasticsearch7
. Elasticsearch 5 wird nicht mehr unterstützt und wird nicht empfohlen.--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
RabbitMQKonfigurationsoptionen:
--amqp-host
--amqp
nur, wenn Sie bereits eine Installation von RabbitMQ eingerichtet haben. Weitere Informationen RabbitMQ Installieren und Konfigurieren von RabbitMQ finden Sie unter Installation .Der Hostname, auf dem RabbitMQ installiert ist.
--amqp-port
--amqp-user
guest
.--amqp-password
guest
Standardkennwort.--amqp-virtualhost
/
.--amqp-ssl
false
. Siehe RabbitMQ für Informationen zum Einrichten von SSL für RabbitMQ.--consumers-wait-for-messages
Konfigurationsoptionen sperren:
--lock-provider
Verfügbare Schlossanbieter:
db
, zookeeper
, file
.Der standardmäßige Sperranbieter:
db
--lock-db-prefix
db
Sperranbieters zu vermeiden.Der Standardwert:
NULL
--lock-zookeeper-host
zookeeper
Sperranbieters.Beispiel:
127.0.0.1:2181
--lock-provider=zookeeper
--lock-zookeeper-path
Der Standardpfad lautet:
/magento/locks
--lock-file-path
--lock-provider=file
Konfigurationsoptionen für Verbraucher:
--consumers-wait-for-messages
-
0
: Privatkunden verarbeiten verfügbare Nachrichten in der Warteschlange, schließen die TCP-Verbindung und beenden sie. Verbraucher warten nicht auf den Eintritt zusätzlicher Nachrichten in die Warteschlange, selbst wenn die Anzahl der verarbeiteten Nachrichten kleiner ist als der beim Starten von Verbrauchern angegebene--max_messages
. -
1
: Verbraucher verarbeiten weiterhin Nachrichten aus der Nachrichtenwarteschlange, bis die maximale Anzahl von Nachrichten erreicht ist (der Wert, der für--max_messages
imqueue:consumers:start
-Befehl angegeben wurde), bevor sie die TCP-Verbindung schließen und den Verbraucherprozess beenden. Wenn die Warteschlange geleert wird, bevor--max_messages
erreicht wird, wartet der Verbraucher auf den Eingang weiterer Nachrichten. Wenn Sie Worker verwenden, um Verbraucher auszuführen, anstatt einen Cron-Auftrag zu verwenden, setzen Sie diese Variable auf1
.
--consumers-wait-for-messages
Option ist eine globale Option und kann nicht für jeden Verbraucher separat konfiguriert werden.Sensible Daten:
Adobe Commerce verwendet Ihren Verschlüsselungsschlüssel, um Folgendes zu verschlüsseln:
- Kreditkartenangaben
- In der Admin-Konfiguration angegebene Benutzernamen und Kennwörter (z. B. Anmeldungen bei Zahlungs-Gateways)
- Über das Netzwerk gesendete CAPTCHA-Werte
Adobe Commerce Folgendes nicht:
- Administrative und kundenspezifische Benutzernamen und Kennwörter (diese Kennwörter werden gehasht)
- Adresse
- Telefonnummer
- Andere Arten von personenbezogenen Daten außer Kreditkartennummern
Beispiele für localhost-Installationen
Die folgenden Beispiele zeigen die Befehle zum lokalen Installieren von Adobe Commerce mit verschiedenen Optionen.
Beispiel 1: Einfache Installation mit Administrator-Benutzerkonto
Im folgenden Beispiel wird Adobe Commerce mit den folgenden Optionen installiert:
-
Die Anwendung wird im
magento2
-Verzeichnis relativ zum Webserver-Stammverzeichnis auflocalhost
installiert und der Pfad zum Admin wirdadmin
. Daher:Ihre Storefront-URL ist
http://127.0.0.1
-
Der Datenbankserver befindet sich auf demselben Host wie der Webserver.
Der Datenbankname ist
magento
und der Benutzername und das Kennwort sind beidemagento
-
Verwendet Server-Neuschreibungen
-
Der Administrator verfügt über die folgenden Eigenschaften:
- Vor- und Nachnamen sind
Magento User
- Benutzername ist
admin
und das Kennwortadmin123
- E-Mail-Adresse ist
user@example.com
- Vor- und Nachnamen sind
-
Die Standardsprache ist
en_US
(Englisch (USA)) -
Die Standardwährung ist US-Dollar
-
Die standardmäßige Zeitzone ist US Central (America/Chicago)
-
OpenSearch 1.2 ist auf
os-host.example.com
installiert und verbindet sich mit 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
Meldungen ähnlich der folgenden werden angezeigt, um eine erfolgreiche Installation anzuzeigen:
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
Beispiel 2 - Standardinstallation ohne Administratorkonto
Sie können Adobe Commerce installieren, ohne den Admin-Benutzer zu erstellen, wie im folgenden Beispiel gezeigt.
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
Meldungen wie die folgende werden angezeigt, wenn die Installation erfolgreich war:
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
Nach der Installation können Sie mit dem Befehl admin:user:create
einen Admin-Benutzer erstellen:
Erstellen oder Bearbeiten eines Administrators
Beispiel 3: Installation mit zusätzlichen Optionen
Im folgenden Beispiel wird Adobe Commerce mit den folgenden Optionen installiert:
-
Die Anwendung wird im
magento2
-Verzeichnis relativ zum Webserver-Stammverzeichnis auflocalhost
installiert und der Pfad zum Admin wirdadmin
. Daher:Ihre Storefront-URL ist
http://127.0.0.1
-
Der Datenbankserver befindet sich auf demselben Host wie der Webserver.
Der Datenbankname ist
magento
und der Benutzername und das Kennwort sind beidemagento
-
Der Administrator verfügt über die folgenden Eigenschaften:
- Vor- und Nachnamen sind
Magento User
- Benutzername ist
admin
und das Kennwortadmin123
- E-Mail-Adresse ist
user@example.com
- Vor- und Nachnamen sind
-
Die Standardsprache ist
en_US
(Englisch (USA)) -
Die Standardwährung ist US-Dollar
-
Die standardmäßige Zeitzone ist US Central (America/Chicago)
-
Das Installationsprogramm bereinigt zunächst die Datenbank, bevor die Tabellen und das Schema installiert werden
-
Sie können das Präfix "
ORD$
" für das Inkrement eines Kundenauftrags verwenden (da es ein [$
] enthält, muss der Wert in doppelte Anführungszeichen gesetzt werden) -
Sitzungsdaten werden in der Datenbank gespeichert
-
Verwendet Server-Neuschreibungen
-
OpenSearch wird auf
os-host.example.com
installiert und verbindet sich mit 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
\
am Ende jeder Zeile eingeben.Meldungen wie die folgende werden angezeigt, wenn die Installation erfolgreich war:
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