Installationsanleitung

In der hier beschriebenen Anleitung wird XAMPP verwendet, um die Webapp auf einem Endgerät für Testzwecke zum Laufen zu kriegen. Die Konfigurationsschritte für einen Webserver oder ein Endgerät mit einem alternativen Softwarepaket können jedoch alternativ umgesetzt werden. (Für einen produktiven Server müssen aber noch einige Dinge angepasst werden, welche hier jetzt nicht beschrieben sind) Vorausgesetzt sind jedoch folgende Dinge: Eine MariaDB-Datenbank (Syntax sollte mit MySQL kompatibel sein, dies wurde jedoch nichts getestet) und ein Webserver mit PHP 7.4. Beide Dinge müssen auf dem selben Gerät laufen.

Die Anleitung richtet sich an fortgeschrittene Benutzer. Die XAMPP-Installation ist nicht teil dieser Anleitung.

Schritt 1: Der Code

Als erstes gilts alle Dateien des Repositorys herunterzuladen. Dazu hier klicken. Das ZIP anschliessend am gewünschten Ort entpacken. Für uns sind die Order install und webroot sowie die Datei pw.inc.php relevant. Wo die Dateien/Ordner auf dem Betriebssystem abgelegt werden, spielt keine Rolle. Wichtig ist jedoch, dass die Beziehung zwischen pw.inc.php und webroot bestehen bleibt. Der Ordner webroot kann bei Bedarf auch umbenannt werden.

Schritt 2: Webserver Konfiguration

Nun muss der Webserver so konfiguriert werden, dass es die Dateien auch anzeigt. Bei Apache funktioniert dies wie folgt: In der httpd.conf (Bei XAMPP für Windows ist diese unter C:\xampp\apache\conf\httpd.conf zu finden) den DocumentRoot anpassen. DocumentRoot "C:/Pfad/zu/den/Dateien/webshop/webroot"

Schritt 3: Datenbank Setup

Die Dateien welche für die Datenbank relevant sind, wurden bereits mitgeliefert und befinden sich im heruntergeladenen Ordner install. Als erstes muss nun die Datei db_setup.sql in die Datenbank eingelesen werden: mysql -u {USER} < "C:\Pfad\zu\den\Dateien\webshop\install\db_setup.sql" An dieser Stelle wäre die Webapp praktisch funktionstüchtig. Wenn wir nun Beispiel-Daten haben möchten, kann auch noch die Datei insert_values.sql eingelesen werden: mysql -u {USER} < "C:\Pfad\zu\den\Dateien\webshop\install\insert_values.sql" Der Platzhalter {USER} muss mit einem auf Ihrem System vorhandenen Datenbank Benutzer substituiert werden. In den Beispieldaten sind auch drei WebShop-Benutzer (mit unterschiedlichen Rollen) mit den Logindaten a@a.a / Password: a, b@b.b / b, c@c.c / c vorhanden.

Schritt 4: Mailversand

Für die Passwort-Reset-Funktion wird ein Mailserver benötigt. Die Domain sowie die Mailadresse (von der Mails versendet werden) sind in der Datei /webroot/forgotPassword.php auf den Zeilen 84 und 87 zu finden. Das Password ist in einer Datei gespeichert, die NICHT im Github-Repo zu finden ist. Das Password wird auf der Zeile 90 angegeben. Wird dies nicht angepasst, so funktioniert der Mailversand nicht.