Shop Projekt - Dokumentation

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:

Windows (XAMPP)

  1. Installiere XAMPP mit Xdebug falls noch nicht vorhanden.
  2. Plziere die umgebungs-Dateien (index.php, favicon, language switcher etc.) in einem Ordner deiner Wahl, z.B. C:/xampp/htdocs/.
  3. Kopiere den Projektordner in das gleiche Verzeichnis.
  4. Öffne das XAMPP Control Panel und starte Apache sowie MySQL.
  5. Um die Kompatibilität mit Linux zu gewährleisten, setze das MySQL-Passwort für den User "root" auf "dev". Dies kannst du über das Terminal im MySQL-bin Ordner tun: mysqladmin -u root password dev.

Linux (LAMP)

  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: http://localhost/brulsim/my_projects/Shop/?node=article&lang=DE&nav_UID=3