Installation von Oxid eShop 7.4 CE

Vorbereitung

Auf dem Speicherplatz:

Verbinden Sie sich zunächst per SSH mit Ihrem Speicherplatz. Eine Anleitung dazu finden Sie unter: Wie verbinde ich mich per SSH mit meinem Webspace?

Wenn Sie sich erfolgreich mit Ihrem Speicherplatz verbunden haben, benötigen Sie den Composer, um die Oxid Installation darüber auszuführen. Sofern Sie den Composer nicht schon nutzen, installieren Sie diesen bitte gemäß der folgenden Anleitung und legen auch den entsprechenden Alias an:

PHP Composer Installation

Wichtig: Bitte beachten Sie, dass für diese OXID Version Composer 2.8.8 benötigt wird. Mit einer aktuelleren Composer Version funktioniert die Installation aktuell nicht.

Datenbank:

Um Oxid zu installieren, benötigen wir noch eine leere MySQL Datenbank. Bitte legen Sie diese über ServerCon an. Eine entsprechende Anleitung finden Sie hier: Wie lege ich eine MySQL oder MariaDB Datenbank an?

Bitte notieren Sie sich den Namen der Datenbank, des Datenbankbenutzers und das zugehörige Kennwort -- diese Informationen benötigen Sie im weiteren Verlauf der Installation.

PHP Einstellungen:

Damit Oxid fehlerfrei funktioniert, müssen gewisse PHP Einstellungen gesetzt werden. Oxid 7.4 unterstützt PHP 8.2 - 8.4. Hier führen wir die Einstellungen exemplarisch für die PHP Version 8.2 durch.

Im Artikel Empfohlene php.ini für PHP 8.2 finden Sie unsere empfohlenen Einstellungen für PHP 8.1. Legen Sie eine Datei mit dem Namen php8.2.ini auf oberster Ebene Ihres Speicherplatzes ab, welche den im Artikel genannten Inhalt hat. Dies können Sie entweder direkt über SSH mit einem Editor, wie z.B. "nano" oder "vim", durchführen oder Sie legen die Datei per FTP dort ab: Wie verbinde ich mich über FTP mit meinem Server?

Download und Konfiguration

Herunterladen der benötigten Komponenten über den Composer:

Führen Sie den folgenden Befehl aus und ersetzen dabei "oxidshop" durch Ihren gewünschten Projektnamen. Der Befehl erzeugt ein neues Verzeichnis mit dem Namen Ihres Projekts und lädt die benötigten Daten dort hinein

composer create-project --no-dev oxid-esales/oxideshop-project oxidshop dev-b-7.4-ce

PHP 8.2 aktivieren

Wechseln Sie in das Unterverzeichnis /source Ihres Projektes und öffnen die dort liegende .htaccess Datei mit einem Editor Ihrer Wahl.

Fügen Sie oberhalb des bestehenden Inhalts die folgenden Zeilen ein und speichern die Datei anschließend.

# Liste der Dateiendungen die als PHP8.2 verarbeitet werden sollen
AddHandler php-fastcgi8.2 .php .phtml

Nun werden die Web-Aufrufe dieses Verzeichnisses über PHP8.2 abgehandelt.

(Sub) Domain konfigurieren

Loggen Sie sich in ServerCon ein und konfigurieren eine Ihrer Domains für den Betrieb mit Oxid. Alternativ können Sie auch eine Subdomain anlegen. Die (Sub)Domain muss auf das Verzeichnis "~/oxidshop/source/" zeigen. "oxidshop" entspricht dabei Ihrem gewählten Projektnamen (in diesem Installationsbeispiel lautet das Verzeichnis "~/oxidshop/source/".

Oxid Installer

Um den Oxid Installer auszuführen, rufen Sie bitte Ihre soeben konfigurierte (Sub)Domain im Browser Ihrer Wahl auf. Alle Prüfparameter sollten nun einen grünen Haken aufweisen.

Klicken Sie bitte anschließend auf SETUP BEGINNEN

Wählen Sie Ihr Hauptlieferland und die Sprache aus, stellen Sie ein ob automatisch auf Aktualisierungen geprüft werden soll und ob Sie erlauben möchten, dass Diagnosedaten an Oxid geschickt werden.