Shop Projekt - Dokumentation

language

Schnellstart für Entwickler

Wichtige Einstiegsschritte für neue Entwickler zur lokalen Analyse und Fehlersuche.

🗺️ Stufe 0 | 📚 Entwurf | 📟 2026 06 15 | 📍 Entwicklertools

System-Voraussetzungen

Stelle sicher, dass PHP 8.x und eine MySQL/MariaDB Datenbank laufen.

Lokale Arbeitsumgebung einrichten

Da das Projekt derzeit lokal über Seafile synchronisiert wird und kein öffentliches Repository existiert, habe ich eine spezielle ‚Umgebungs-Logik‘ entwickelt, um dir den Einstieg zu erleichtern. Du kannst dieses Skript flexibel im Root-Verzeichnis oder in jedem beliebigen Überordner ablegen, in dem du mehrere Projekte verwaltest.\n Platziere deine Projektordner einfach als direkte Unterordner neben diese Umgebungs-Dateien. Das System durchsucht diese automatisch nach Einstiegspunkten (wie index.php, index.html oder public/index.php) und listet alle gefundenen Projekte sauber und übersichtlich in deinem Browser auf.

Wähle dein Betriebssystem für die spezifische Installation:

  1. Installiere und starte XAMPP.
  • Starte Apache und MySQL über das XAMPP Control Panel.
  1. Datenbank-Passwort setzen (Linux-Kompatibilität).
  • Klicke im XAMPP Control Panel bei MySQL auf Shell.
  • Melde dich als root an:
mysql -u root
  • Setze das Passwort auf dev:
ALTER USER 'root'@'localhost' IDENTIFIED BY 'dev';
FLUSH PRIVILEGES;
EXIT;
  • Schließe das Shell-Fenster.
  1. phpMyAdmin-Anmeldeseite aktivieren.
  • Klicke bei Apache auf Config und öffne config.inc.php (C:/xampp/phpMyAdmin/config.inc.php).
  • Suche nach auth_type und aktiviere die Cookie-Anmeldung:
$cfg['Servers'][$i]['auth_type'] = 'cookie';
  • Die Passwortzeile muss leer bleiben:
$cfg['Servers'][$i]['password'] = '';
  • Speichere die Datei, öffne http://localhost/phpmyadmin/ und melde dich mit root sowie dev an.
  1. Datenbank erstellen.
  • Erstelle in phpMyAdmin eine neue Datenbank mit dem Namen web_shop_db.
  1. Xdebug installieren und konfigurieren.
  • Rufe http://localhost/dashboard/phpinfo.php auf und kopiere die vollständige Ausgabe.
  • Füge sie in den https://xdebug.org/wizard ein, starte die Analyse und lade die vorgeschlagene DLL herunter.
  • Verschiebe die DLL nach C:/xampp/php/ext/ und benenne sie in php_xdebug.dll um.
  • Klicke bei Apache auf Config und öffne php.ini (C:/xampp/php/php.ini). Suche nach output_buffering und ersetze die Zeile durch:
; output_buffering=4096
output_buffering=off
  • Füge am Ende der Datei diesen Block ein:
[Xdebug]
zend_extension = "c:/xampp/php/ext/php_xdebug.dll"
xdebug.mode = debug
xdebug.start_with_request = yes
xdebug.client_port = 9003
xdebug.log = "c:/xampp/tmp/xdebug.log"
  • Starte Apache neu.
  1. Projekt einrichten und Datenbank-Setup ausführen.
  • Synchronisiere den Projektordner nach C:/xampp/htdocs/brulsim/.
  • Rufe https://shop.brulsim.ch/dev/dev.php?tool=setup-db im Browser auf, führe das Setup aus und öffne anschließend das Projekt.
  1. Verschiebe das Projekt nach /var/www/html/ und setze die Rechte:
    sudo chown -R $USER:$USER /var/www/html/.
  2. Aktiviere das Passwort-Login für MariaDB-Root: ALTER USER 'root'@'localhost' IDENTIFIED VIA mysql_native_password USING PASSWORD('dev');.
  3. Falls du DBeaver als Flatpak nutzt, erlaube den Netzwerkzugriff mit: flatpak override --user --share=network io.dbeaver.DBeaverCommunity.

Test-Link

Startseite Shop

Erste Schritte

  • Shop starten und node/lang/nav_UID Parameter prüfen.
  • Bei Routingfehlern cRouter und cSession kontrollieren.
  • URL Beispiel: https://shop.brulsim.ch/?node=article&lang=DE&nav_UID=3