Systemvoraussetzungen

Systemvoraussetzungen für LKWaWi

Damit LKWaWi zuverlässig installiert, aktualisiert und mit Ihren Shops verbunden werden kann, müssen einige technische Voraussetzungen erfüllt sein. Die meisten aktuellen Webhosting- und Plesk-Systeme unterstützen diese Anforderungen bereits.

Serveranforderungen

Komponente	Voraussetzung
PHP	PHP 8.3 bis einschließlich PHP 8.5
Datenbank	MySQL 8 oder MariaDB 10.6 und neuer
Webserver	Apache oder nginx
Verschlüsselung	Gültiges SSL-Zertifikat und Aufruf über HTTPS
Speicherplatz	Ausreichend Platz für Produktdaten, Protokolle, Updates und Sicherungen
Zeitgesteuerte Aufgaben	Möglichkeit zum Einrichten eines Cronjobs

PHP-Versionen unter 8.3 werden nicht unterstützt. Bei PHP-Versionen oberhalb von 8.5 sollte vor dem produktiven Einsatz zunächst die Kompatibilität geprüft werden.

Benötigte PHP-Erweiterungen

Folgende PHP-Erweiterungen müssen aktiviert sein:

• curl
• json
• openssl
• pdo
• pdo_mysql

Für automatische Aktualisierungen wird zusätzlich ZipArchive benötigt. In Plesk wird diese Erweiterung meistens als zip bezeichnet.

Webserver und Domain

Für LKWaWi sollte eine eigene Domain oder Subdomain verwendet werden, beispielsweise:

https://wawi.example.de

Der Dokumentenstamm der Domain muss auf den Ordner public/ der Installation zeigen. Dadurch sind Konfigurationsdateien, Protokolle und andere interne Verzeichnisse nicht öffentlich erreichbar.

Bei Apache müssen außerdem URL-Umschreibungen aktiviert sein. Hierfür werden mod_rewrite und die Auswertung von .htaccess-Dateien benötigt.

Schreibrechte und Speicherplatz

Während der Einrichtung muss LKWaWi die Konfigurationsdatei .env anlegen können. Das Projektverzeichnis muss daher für den verwendeten PHP-Benutzer beschreibbar sein.

Für den laufenden Betrieb werden Schreibrechte insbesondere für folgende Daten benötigt:

• Protokolle
• temporäre Update-Dateien
• automatische Sicherungen
• Update-Sperren und Statusinformationen

Vor einem Update erstellt LKWaWi eine Sicherung der Anwendung und der Datenbank. Auf dem Server sollte deshalb ausreichend freier Speicherplatz für mindestens eine vollständige Sicherung vorhanden sein.

Datenbank

Vor der Installation muss eine leere Datenbank angelegt werden. Benötigt werden:

• Datenbankserver beziehungsweise Hostname
• Datenbankport
• Datenbankname
• Datenbankbenutzer
• Datenbankpasswort

Die Datenbank sollte InnoDB und den Zeichensatz utf8mb4 unterstützen. Der Datenbankbenutzer benötigt Rechte zum Anlegen und Ändern von Tabellen sowie zum Lesen, Einfügen, Aktualisieren und Löschen von Datensätzen.

Cronjob

Für regelmäßige Lizenzprüfungen, Updateprüfungen und Shop-Abgleiche wird ein Cronjob empfohlen. Ein typischer Aufruf im Abstand von 15 Minuten lautet:

*/15 * * * * /usr/bin/php /pfad/zu/LKWaWi/bin/cron.php all >/dev/null 2>&1

Der genaue PHP-Pfad und Installationspfad müssen an den Server angepasst werden. Die PHP-Version der Kommandozeile sollte mit der PHP-Version der Domain übereinstimmen.

Voraussetzungen für Shop-Anbindungen

Shopware 6

Für die Verbindung mit Shopware wird eine Integration mit Zugangs-ID und Sicherheitsschlüssel benötigt. Die erforderlichen Berechtigungen hängen von den verwendeten Funktionen ab.

Die aktuelle LKWaWi-Version ist für Shopware 6.7.5.1 bis 6.7.13.0 vorgesehen und wurde mit Shopware 6.7.13.0 geprüft.

WooCommerce

Für WooCommerce wird ein REST-API-Schlüssel benötigt. Die Anbindung verwendet die WooCommerce-Schnittstelle wc/v3. Für vollständige Synchronisationsfunktionen sollte der Schlüssel über Lese- und Schreibrechte verfügen.

Die aktuelle LKWaWi-Version ist für WooCommerce 10.9.4 bis 11.0.1 vorgesehen und wurde mit WooCommerce 11.0.1 geprüft.

Die konkrete Verbindung und die verfügbaren Funktionen können nach der Einrichtung über die Kompatibilitätsprüfung in LKWaWi getestet werden.

Browseranforderungen

Für die Bedienung wird ein aktueller Browser benötigt, beispielsweise:

• Google Chrome
• Microsoft Edge
• Mozilla Firefox
• Safari

JavaScript und Cookies müssen aktiviert sein. Für Scanner- und Kamerafunktionen ist der Aufruf über HTTPS erforderlich.

Vor der Installation bereithalten

• Domain oder Subdomain mit gültigem SSL-Zertifikat
• PHP 8.3 bis PHP 8.5 mit den erforderlichen Erweiterungen
• leere MySQL- oder MariaDB-Datenbank
• Zugang zur Hosting- oder Plesk-Verwaltung
• Möglichkeit zum Einrichten eines Cronjobs
• gültiger LKWaWi-Lizenzschlüssel
• Zugangsdaten für die gewünschte Shop-Anbindung

Nach dem ersten Aufruf führt der Einrichtungsassistent durch die Datenbankverbindung, die Grundeinstellungen und die Erstellung des ersten Administratorkontos.