Schnellstart für die Installation vor Ort

Die Anweisungen auf dieser Seite beschreiben, wie Adobe Commerce in der selbstgehosteten -Infrastruktur installiert wird. Eine Anleitung zum Aktualisieren einer vorhandenen Installation finden Sie im Upgrade-Handbuch.

Adobe verwendet Composer, um Adobe Commerce-Komponenten und ihre Abhängigkeiten zu verwalten. Die Verwendung von Composer zum Abrufen des Adobe Commerce-Metapakets bietet die folgenden Vorteile:

  • Wiederverwenden von Bibliotheken von Drittanbietern ohne Bundle mit Quellcode
  • Reduzieren von Erweiterungskonflikten und Kompatibilitätsproblemen durch Verwendung einer komponentenbasierten Architektur mit robuster Abhängigkeitsverwaltung
  • Einhaltung der PHP-Framework Interoperability Group (FIG)-Standards
  • Magento Open Source mit anderen Komponenten umpacken
  • Verwenden der Adobe Commerce-Software in einer Produktionsumgebung
NOTE
Entwickler, die zur Magento Open Source beitragen, sollten die git-basierte -Installationsmethode verwenden.

Voraussetzungen

Bevor Sie fortfahren, müssen Sie Folgendes tun:

Als Dateisysteminhaber anmelden

Erfahren Sie mehr über Eigentümer, Berechtigungen und den Dateisysteminhaber im Thema Überblick über Eigentümer und Berechtigungen.

So wechseln Sie zum Dateisysteminhaber:

  1. Melden Sie sich beim Anwendungsserver als Benutzer an oder wechseln Sie zu einem Benutzer mit Schreibberechtigung für das Dateisystem.

    Wenn Sie die Bash-Shell verwenden, können Sie die folgende Syntax verwenden, um zum Dateisysteminhaber zu wechseln und den Befehl gleichzeitig einzugeben:

    code language-bash
    su <file system owner> -s /bin/bash -c <command>
    

    Wenn der Dateisysteminhaber keine Anmeldung zulässt, können Sie Folgendes tun:

    code language-bash
    sudo -u <file system owner>  <command>
    
  2. Um CLI-Befehle aus einem beliebigen Verzeichnis auszuführen, fügen Sie <app_root>/bin zu Ihrem System PATH hinzu.

    Da Muscheln unterschiedliche Syntaxen haben, sollten Sie einen Verweis wie unix.stackexchange.com lesen.

    Beispiel-Bash-Shell für CentOS:

    code language-bash
    export PATH=$PATH:/var/www/html/magento2/bin
    

    Optional können Sie die Befehle wie folgt ausführen:

    • cd <app_root>/bin und führen Sie sie als ./magento <command name> aus
    • app_root>/bin/magento <command name>
    • <app_root> ist ein Unterverzeichnis Ihres Webserver-Basisverzeichnisses.

Metapaket abrufen

So rufen Sie das Adobe Commerce-Metapaket ab:

  1. Melden Sie sich bei Ihrem Anwendungsserver als Dateisysteminhaber an oder wechseln Sie zu ihm.

  2. Wechseln Sie zum Basisverzeichnis des Webservers oder zu einem Ordner, den Sie als virtuelles Host-Basisverzeichnis konfiguriert haben.

  3. Erstellen Sie ein Composer-Projekt mit einem Commerce-Metapaket.

    Magento Open Source

    code language-bash
    composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition <install-directory-name>
    

    Adobe Commerce

    code language-bash
    composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition <install-directory-name>
    

    Geben Sie bei Aufforderung die Authentifizierungsschlüssel ein. Öffentliche und private Schlüssel werden in Ihrem Commerce Marketplace erstellt und konfiguriert.

    note note
    NOTE
    Bei Verwendung einer Composer auth.json -Datei oder Umgebungsvariablen werden Sie nicht aufgefordert, Ihre Authentifizierungsschlüssel einzugeben.

    Wenn Fehler wie Could not find package... oder ...no matching package found auftreten, stellen Sie sicher, dass Ihr Befehl keine Tippfehler enthält. Sollten dennoch Fehler auftreten, sind Sie möglicherweise nicht berechtigt, Adobe Commerce herunterzuladen. Wenden Sie sich für Hilfe an den Adobe Commerce-Support.

    Weitere Informationen zu Fehlern finden Sie unter Fehlerbehebung .

Beispiel - Nebenversion

Nebenversionen enthalten neue Funktionen, Qualitätsverbesserungen und Sicherheitskorrekturen. Verwenden Sie Composer , um eine Nebenversion anzugeben. So legen Sie beispielsweise das Adobe Commerce 2.4.6-Metapaket fest:

composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>

Beispiel - Qualitäts-Patch

Qualitäts-Patches enthalten in erster Linie funktionale Sicherheitskorrekturen für und. Manchmal können sie jedoch auch neue, abwärtskompatible Funktionen enthalten. Verwenden Sie Composer , um einen Qualitäts-Patch herunterzuladen. So legen Sie beispielsweise das Adobe Commerce 2.4.6-Metapaket fest:

composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>

Beispiel - Sicherheits-Patch

Sicherheits-Patches enthalten nur Sicherheitskorrekturen. Sie sind so konzipiert, dass der Aktualisierungsprozess schneller und einfacher wird.

Sicherheits-Patches verwenden die Composer-Namenskonvention 2.4.6-px. Verwenden Sie Composer, um einen Patch anzugeben. So laden Sie beispielsweise das Metapaket Adobe Commerce 2.4.6-p1 herunter:

composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6-p1 <install-directory-name>

Festlegen von Dateiberechtigungen

Sie müssen Lese- und Schreibberechtigungen für die Webservergruppe festlegen, bevor Sie Adobe Commerce installieren. Dies ist erforderlich, damit die Befehlszeile Dateien in das Dateisystem schreiben kann.

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

Installieren des Programms

Sie müssen die Befehlszeile verwenden, um Adobe Commerce zu installieren.

In diesem Beispiel wird davon ausgegangen, dass der Installationsordner den Namen magento2ee hat, sich der db-host auf demselben Computer befindet (localhost) und dass die db-name, db-user und db-password alle magento sind:

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
TIP
Sie können den Admin-URI mit der Option --backend-frontname anpassen. Adobe empfiehlt jedoch, diese Option wegzulassen und dem Installationsbefehl zu erlauben, automatisch einen zufälligen URI zu generieren. Eine zufällige URI ist für Hacker oder böswillige Software schwieriger zu nutzen. Der URI wird in Ihrer Konsole angezeigt, wenn die Installation abgeschlossen ist.
TIP
Eine vollständige Beschreibung der CLI-Installationsoptionen finden Sie unter Installieren der Anwendung über die Befehlszeile.

Befehlszusammenfassung

Geben Sie Folgendes ein, um eine vollständige Liste der Befehle anzuzeigen:

bin/magento list

Um Hilfe für einen bestimmten Befehl zu erhalten, geben Sie Folgendes ein:

bin/magento help <command>

Beispiel:

bin/magento help setup:install
bin/magento help cache:enable

Die folgende Tabelle fasst die verfügbaren Befehle zusammen. Befehle werden nur in der Zusammenfassung angezeigt. Weitere Informationen zu einem Befehl erhalten Sie, wenn Sie in der Spalte Befehl auf den Link klicken.

Befehl
Beschreibung
Voraussetzungen
magento setup:install
Installation des Programms
Keines
magento setup:uninstall
Entfernt die Anwendung.
Anwendung installiert
magento setup:upgrade
Aktualisiert die Anwendung.
Bereitstellungskonfiguration
magento maintenance:{enable/disable}
Aktiviert oder deaktiviert den Wartungsmodus (im Wartungsmodus können nur ausgenommene IP-Adressen auf die Admin- oder Storefront zugreifen).
Anwendung installiert
magento setup:config:set
Erstellt oder aktualisiert die Bereitstellungskonfiguration.
Keines
magento module:{enable/disable}
Aktivieren oder deaktivieren Sie Module.
Keines
magento setup:store-config:set
Legt Storefront-bezogene Optionen fest, z. B. Basis-URL, Sprache und Zeitzone.
Bereitstellungskonfiguration
magento setup:db-schema:upgrade
Aktualisiert das Datenbankschema.
Bereitstellungskonfiguration
magento setup:db-data:upgrade
Aktualisiert die Datenbankdaten.
Bereitstellungskonfiguration
magento setup:db:status
Überprüft, ob die Datenbank mit dem Code auf dem neuesten Stand ist.
Bereitstellungskonfiguration
magento admin:user:create
Erstellt einen Administratorbenutzer.
Sie können Benutzer für Folgendes erstellen:

Bereitstellungskonfiguration

Aktivieren Sie mindestens die Datenbank Magento_User und die Module Magento_Authorization

Datenbank (die einfachste Methode ist die Verwendung von bin/magento setup:upgrade)
magento list
Führt alle verfügbaren Befehle auf.
Keines
magento help
Bietet Hilfe für den angegebenen Befehl.
Keines

Allgemeine Argumente

Die folgenden Argumente gelten für alle Befehle. Diese Befehle können vor oder nach der Installation der Anwendung ausgeführt werden:

Lange Version
Kurzversion
Bedeutung
--help
-h
Erhalten Sie Hilfe für jeden Befehl. Beispiel: ./magento help setup:install oder ./magento help setup:config:set.
--quiet
-q
Ruhig, keine Ausgabe.
--no-interaction
-n
Keine interaktiven Fragen.
--verbose=1,2,3
-v, -vv, -vvv
Verbosity level. Beispielsweise zeigt --verbose=3 oder -vvv Debug-Ausführlichkeit an, die die ausführlichste Ausgabe ist. Der Standardwert ist --verbose=1 oder -v.
--version
-V
Diese Anwendungsversion anzeigen
--ansi
Nicht zutreffend
ANSI-Ausgabe erzwingen
--no-ansi
Nicht zutreffend
ANSI-Ausgabe deaktivieren
NOTE
Herzlichen Glückwunsch! Sie haben die Schnellinstallation abgeschlossen. Sie benötigen weiterführende Hilfe? Sehen Sie sich das Handbuch Erweiterte Installation an.
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995