Fortgeschrittene Installation vor Ort
Befehlszeilenschnittstelle (CLI)
Adobe Commerce verfügt über eine einzige Befehlszeilenschnittstelle für Installations- und Konfigurationsaufgaben: <magento_root>/bin/magento
. Die Oberfläche führt mehrere Aufgaben durch, darunter:
- Installation (und damit verbundene Aufgaben wie Erstellen oder Aktualisieren des Datenbankschemas, 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 Fabriken und Abfänger für Plug-ins, Generieren der Konfiguration für die Injektion der Abhängigkeit für den Objektmanager.
- Bereitstellen von statischen Ansichtsdateien.
- Erstellen von CSS aus weniger.
Weitere Vorteile:
- Ein einzelner Befehl (
<magento_root>/bin/magento list
) enthält alle verfügbaren Installations- und Konfigurationsbefehle. - Konsistente Benutzeroberfläche basierend auf Symfony.
- Die CLI ist erweiterbar, sodass Entwickler von Drittanbietern sie "einbinden"können. Dies hat den zusätzlichen Vorteil, dass die Lernkurve der Benutzer entfernt wird.
- Befehle für deaktivierte Module werden nicht angezeigt.
In diesem Thema wird die Installation der Adobe Commerce-Software mithilfe des CLI erläutert. Weitere Informationen zur Konfiguration finden Sie unter Konfigurationshandbuch.
Das Installationsprogramm kann bei Bedarf mehrmals ausgeführt werden, damit Sie Folgendes tun können:
-
Bereitstellung verschiedener Werte
Nachdem Sie beispielsweise Ihren Webserver für Secure Sockets Layer (SSL) konfiguriert haben, können Sie das Installationsprogramm ausführen, um SSL-Optionen festzulegen.
-
Korrigieren von Fehlern in früheren Installationen
-
Installieren von Adobe Commerce in einer anderen Datenbankinstanz
Vor Beginn der Installation
Führen Sie zuerst die folgenden Schritte aus:
-
Stellen Sie sicher, dass Ihr System die in Systemanforderungen.
-
Alle Voraussetzung Aufgaben.
-
Führen Sie die ersten Installationsschritte aus. Siehe Ihren Installations- oder Aktualisierungspfad.
-
Nach der Anmeldung beim Anwendungsserver Wechseln zum Dateisysteminhaber.
-
Überprüfen Sie die Schnellstart für die Installation Übersicht.
bin
-Unterverzeichnis.Sie können das Installationsprogramm mehrmals mit verschiedenen Optionen ausführen, um Installationsaufgaben wie die folgenden abzuschließen:
-
In Phasen installieren - Nachdem Sie beispielsweise Ihren Webserver für Secure Sockets Layer (SSL) konfiguriert haben, können Sie das Installationsprogramm erneut ausführen, um SSL-Optionen festzulegen.
-
Korrigieren Sie Fehler in früheren Installationen.
-
Installieren Sie Adobe Commerce in einer anderen Datenbankinstanz.
cleanup-database
-Parameter, um dieses Verhalten zu ändern.Siehe auch Aktualisieren, Neuinstallieren, Deinstallieren.
Sichere Installation
Um Secure Sockets Layer (SSL), auch HTTPS genannt, sowohl für Admin als auch für die Storefront zu verwenden, müssen Sie alle folgenden Parameter festlegen:
--use-secure
: Setzen Sie auf1
--base-url-secure
: Auf eine sichere URL gesetzt (d. h. beginnend mithttps://
)--use-secure-admin
Legen Sie1
Weitere Informationen zu diesen Parametern finden Sie weiter unten in diesem Thema.
Hilfebefehle für Installationsprogramme
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. Beispiel für Installationsbefehle finden Sie unter Beispiele für lokale Host-Installationen.
Administratorberechtigungen:
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 Beispiele für lokale Host-Installationen.
Die folgenden Tabellen enthalten viele, aber nicht alle verfügbaren Installationsparameter. Eine vollständige Liste finden Sie in der Befehlszeilen-Tools-Referenz.
--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 sind beide erforderlich.
<your install dir>
ist der docroot-relative Pfad zur Installation der Adobe Commerce-Software. Je nachdem, wie Sie Ihren Webserver und virtuelle Hosts einrichten, kann der Pfad magento2 sein oder leer sein.Für den Zugriff auf Adobe Commerce oder Magen verwenden Sie Adobe Commerce entweder
http://127.0.0.1/<your install dir>/
oder http://127.0.0.1/<your install dir>/
.-
{{base_url}}
, die eine Basis-URL darstellt, die von einer virtuellen Host-Einstellung oder einer Virtualisierungsumgebung wie Docker definiert wird. Wenn Sie beispielsweise einen virtuellen Host mit dem Hostnamen einrichten magento.example.com
, können Sie die Software mit --base-url={{base_url}}
und greifen Sie mit einer URL wie auf den Administrator zu http://magento.example.com/admin
.--backend-frontname
admin_jkhgdfq
.Aus Sicherheitsgründen empfehlen wir einen zufälligen URI. Eine zufällige URI ist für Hacker oder böswillige Software schwieriger zu nutzen.
Der URI wird am Ende der Installation angezeigt. Sie können sie jederzeit mithilfe der
bin/magento info:adminuri
Befehl.Wenn Sie einen Wert eingeben möchten, empfehlen wir, kein gemeinsames Wort wie "admin", "backend"zu verwenden. Der Administrator-URI kann alphanumerische Werte und Unterstriche (
_
).--db-host
- Der vollständig qualifizierte Hostname oder die IP-Adresse des Datenbankservers.
-
localhost
(Standard) oder 127.0.0.1
Wenn sich Ihr Datenbankserver auf demselben Host befindet wie Ihr Webserver.localhost bedeutet, dass die MySQL-Client-Bibliothek UNIX-Sockets verwendet, um eine Verbindung zur Datenbank herzustellen. 127.0.0.1
bewirkt, dass die Client-Bibliothek das TCP-Protokoll verwendet. Weitere Informationen zu Sockets finden Sie im Abschnitt PHP PDO_MYSQL-Dokumentation.Hinweis: Sie können optional den Datenbankserver-Port in seinem Hostnamen angeben, z. B. www.example.com:9000
--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 kann maximal fünf Zeichen lang sein. Sie muss mit einem Brief beginnen und darf nur Buchstaben, Zahlen und Unterstriche enthalten.
Mit dieser Option können diese Kunden den Datenbankserver für mehrere Adobe Commerce-Installationen freigeben.
--db-ssl-key
--db-ssl-cert
--db-ssl-ca
--language
bin/magento info:language:list
aus dem Ordner bin.)--currency
bin/magento info:currency:list
aus dem Ordner bin.)--timezone
bin/magento info:timezone:list
aus dem bin/
directory.)--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 die Standardeinstellung.--use-secure
1
ermöglicht die Verwendung von Secure Sockets Layer (SSL) 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 angenommen, dass alle anderen sicheren URL-Optionen ebenfalls 0 sind. Dies ist die Standardeinstellung.--base-url-secure
http[s]://<host or ip>/<your install dir>/
--use-secure-admin
1
bedeutet, dass Sie SSL verwenden, um auf den Admin 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 die Standardeinstellung.--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 über eine Clusterdatenbank verfügen. Andernfalls hat der dateibasierte Speicher möglicherweise keinen großen Vorteil.-
files
, um Sitzungsdaten im Dateisystem zu speichern. Eine dateibasierte Sitzungsspeicherung ist angemessen, es sei denn, der Dateisystemzugriff ist langsam, Sie haben eine Clusterdatenbank oder Sie möchten Sitzungsdaten in Redis speichern.-
redis
, um Sitzungsdaten in Redis zu speichern. Wenn Sie Redis für 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 die Sitzungsspeicherung .--key
--cleanup-database
--db-init-statements
Der Standardwert ist
SET NAMES utf8;
.--sales-order-increment-prefix
Suchmaschinenkonfigurationsoptionen:
--search-engine
elasticsearch7
. Elasticsearch 5 wird nicht mehr 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
Optionen, sofern Sie nicht bereits eine Installation von RabbitMQ. Siehe RabbitMQ Installation für weitere Informationen zur Installation und Konfiguration RabbitMQ.Der Hostname, in dem RabbitMQ installiert ist.
--amqp-port
--amqp-user
guest
.--amqp-password
guest
.--amqp-virtualhost
/
.--amqp-ssl
false
. Siehe RabbitMQ Informationen zum Einrichten von SSL für RabbitMQ.--consumers-wait-for-messages
Konfigurationsoptionen sperren:
--lock-provider
Verfügbare Sperranbieter:
db
, zookeeper
, file
.Der standardmäßige Sperranbieter:
db
--lock-db-prefix
db
Sperranbieter.Der Standardwert:
NULL
--lock-zookeeper-host
zookeeper
Sperranbieter.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
: Die Verbraucher verarbeiten verfügbare Nachrichten in der Warteschlange, schließen die TCP-Verbindung und beenden sie. Die Verbraucher warten nicht darauf, dass zusätzliche Nachrichten in die Warteschlange gelangen, selbst wenn die Anzahl der verarbeiteten Nachrichten kleiner ist als die Anzahl der--max_messages
-Wert, der beim Starten von Verbrauchern angegeben wird. -
1
: Verbraucher verarbeiten weiterhin Nachrichten aus der Nachrichtenwarteschlange, bis sie die maximale Nachrichtenanzahl erreichen (der für--max_messages
aufqueue:consumers:start
-Befehl), bevor Sie die TCP-Verbindung schließen und den Consumer-Prozess beenden. Wenn die Warteschlange vor dem Erreichen geleert wird--max_messages
der Verbraucher wartet auf das Eintreffen weiterer Nachrichten. Wenn Sie Sekundäre verwenden, um Verbraucher anstatt eines Cron-Auftrags auszuführen, setzen Sie diese Variable auf1
.
--consumers-wait-for-messages
-Option ist eine globale Option und kann nicht für jeden Verbraucher einzeln konfiguriert werden.Sensible Daten:
Adobe Commerce verschlüsselt Folgendes mit Ihrem Verschlüsselungsschlüssel:
- Kreditkarteninformationen
- Benutzernamen und Kennwörter, die in der Admin-Konfiguration angegeben sind (z. B. Anmeldungen bei Payment Gateways)
- CAPTCHA-Werte, die über das Netzwerk gesendet werden
Adobe Commerce do not encrypt:
- Administrations- und Kundenbenutzernamen und -kennwörter (diese Kennwörter werden gehasht)
- Adresse
- Telefonnummer
- Sonstige Arten von persönlich identifizierbaren Informationen außer Kreditkartennummern
Beispiele für lokale Host-Installationen
Die folgenden Beispiele zeigen die Befehle zur lokalen Installation von Adobe Commerce mit verschiedenen Optionen.
Beispiel 1: Grundlegende Installation mit einem Administratorkonto
Im folgenden Beispiel wird Adobe Commerce mit den folgenden Optionen installiert:
-
Das Programm wird im
magento2
Verzeichnis relativ zum Basisverzeichnis des Webserverslocalhost
und der Pfad zum Admin lautetadmin
; daher:Ihre Storefront-URL lautet:
http://127.0.0.1
-
Der Datenbankserver befindet sich auf demselben Host wie der Webserver.
Der Datenbankname lautet
magento
und Benutzername und Kennwort beidemagento
-
Verwendet Server-Neuschreibungen
-
Der Administrator verfügt über die folgenden Eigenschaften:
- Vor- und Nachnamen sind
Magento User
- Benutzername ist
admin
und das Kennwort lautetadmin123
- E-Mail-Adresse ist
user@example.com
- Vor- und Nachnamen sind
-
Standardsprache ist
en_US
(Englisch in den USA) -
Die Standardwährung ist US-Dollar.
-
Die standardmäßige Zeitzone ist US Central (Amerika/Chicago).
-
OpenSearch 1.2 ist auf installiert.
os-host.example.com
und Verbindungen an 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, die der folgenden Anzeige ähneln, zeigen eine erfolgreiche Installation an:
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: Grundlegende Installation ohne Administratorkonto
Sie können Adobe Commerce installieren, ohne den Administratorbenutzer 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 bei erfolgreicher Installation angezeigt:
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 einen Administrator mithilfe der admin:user:create
command:
Erstellen oder Bearbeiten von Administratoren
Beispiel 3: Installation mit zusätzlichen Optionen
Im folgenden Beispiel wird Adobe Commerce mit den folgenden Optionen installiert:
-
Das Programm wird im
magento2
Verzeichnis relativ zum Basisverzeichnis des Webserverslocalhost
und der Pfad zum Admin lautetadmin
; daher:Ihre Storefront-URL lautet:
http://127.0.0.1
-
Der Datenbankserver befindet sich auf demselben Host wie der Webserver.
Der Datenbankname lautet
magento
und Benutzername und Kennwort beidemagento
-
Der Administrator verfügt über die folgenden Eigenschaften:
- Vor- und Nachnamen sind
Magento User
- Benutzername ist
admin
und das Kennwort lautetadmin123
- E-Mail-Adresse ist
user@example.com
- Vor- und Nachnamen sind
-
Standardsprache ist
en_US
(Englisch in den USA) -
Die Standardwährung ist US-Dollar.
-
Die standardmäßige Zeitzone ist US Central (Amerika/Chicago).
-
Das Installationsprogramm bereinigt zunächst die Datenbank, bevor die Tabellen und das Schema installiert werden
-
Sie können das Präfix zur Erhöhung der Verkaufsaufträge verwenden
ORD$
(da es ein Sonderzeichen enthält) [$
], muss der Wert in doppelte Anführungszeichen gesetzt werden.) -
Sitzungsdaten werden in der Datenbank gespeichert
-
Verwendet Server-Neuschreibungen
-
OpenSearch ist auf installiert.
os-host.example.com
und Verbindungen an 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.Meldungen wie die folgende werden bei erfolgreicher Installation angezeigt:
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