WizardsToolkit

Wizard's Toolkit (WTK)

Ein leistungsstarker, produktionsbereiterer Full-Stack-Entwicklungsrahmen für den Aufbau moderner Webanwendungen. Unternehmensklasse, Docker-fähig und seit 2009 kontinuierlich aufrechterhalten.

Dokumentation •? Tutorials • Live -Demo • ⚡ Schneller Start

Inhaltsverzeichnis

• Überblick
• Schlüsselmerkmale
• Schneller Beginn mit Docker
  • Voraussetzungen
  • Basic Setup
  • Zugangspunkte
• Projektstruktur
• Konfiguration
  • Lokale Entwicklungssetup
  • Datenbankkonfiguration
• Entwicklungstools
  • Dienstprogrammskripte
  • Datenbankverwaltung
• Dokumentation & Ressourcen
• Lizenz
• Fehlerbehebung
  • Häufige Probleme
• Sicherheit

Überblick

Wizard's Toolkit (WTK) ist ein leistungsstarkes Full-Stack-Entwicklungsrahmen, das PHP, SQL, JavaScript und Materializecss kombiniert. WTK wurde ursprünglich 2009 erstellt und kontinuierlich gepflegt, rationalisiert die Entwicklung datengesteuerter Websites und mobiler Anwendungen. Das Framework hat sich durch mehrere PHP -Versionen entwickelt und ist derzeit für PHP 8.1 optimiert und gleichzeitig die Kompatibilität mit früheren Versionen beibehalten.

Es bietet eine umfassende Lösung für die Erstellung und Aufrechterhaltung von datengesteuerten Websites und mobilen Apps schnell und effizient. Das Repository enthält SQL -Tabellendefinitionen, Anfangsdaten, PHP -Komponenten, HTML -Vorlagen, CSS -Styling und JavaScript -Funktionalität sowie umfangreiche Dokumentation, die über PHPDOCs und zahlreiche Demo -Dateien erstellt wurden.

Website : https://wizardstoolkit.com

Schlüsselmerkmale

• Full-Stack-Lösung : Integrierte PHP, SQL, JavaScript und Materializecss
• Datenbankflexibilität : nahtlose Unterstützung sowohl für MySQL 8.3 als auch für PostgreSQL
• Docker-Ready : Komplette Entwicklungsumgebung Einrichtung in weniger als 2 Minuten
• Moderner Stack :
  • Nginx mit Alpine für leichte Leistung
  • PHP 8.1 mit PDO -Unterstützung
  • MySQL 8.3 oder Postgresql
  • Entwicklungstools (PhpMyAdmin für MySQL)
• Unternehmensklasse : Produktionss seit 2009 mit kontinuierlichen Updates
• Umfangreiche Dokumentation : Enthält API -Dokumente, Demos und Tutorials
• Versionskompatibilität : Unterstützt PHP 5.4 bis 8.1

Schneller Beginn mit Docker

Voraussetzungen

1. Für Windows -Benutzer :

   • WSL2 mit Ubuntu 20.04 LTs
   • Docker Desktop
   • Docker Hub -Konto (kostenlos)

2. Für Mac -Benutzer :

   • Docker Desktop
   • Docker Hub -Konto (kostenlos)

Basic Setup

1. Klonen Sie das Repository :

   git clone https://github.com/AlecBS/WizardsToolkit.git
   cd WizardsToolkit

2. Umgebung initialisieren :

   ./WTK.sh

3. Wählen und setzen Sie die Datenbank aus :

   • Für MySQL:

     ./SETUP_MYSQL.sh

   • Für PostgreSQL: Automatisches Setup beim ersten Start

4. Überprüfen Sie die Installation : Besuchen Sie http://127.0.0.1/devutils/testwtk.php, um zu bestätigen:

   • Datenbankkonnektivität
   • Umgebungsvariablen
   • E -Mail -Funktionalität
   • Setzen Sie das Administratorkennwort

Zugangspunkte

• Hauptanwendung : http://127.0.0.1/ oder http://dev.wtk.com/
• Datenbankadministrator :
  • MySQL: http://127.0.0.1:8080/ (phpmyadmin)
  • PostgreSQL: Verwenden Sie DBeaver (empfohlen)
• Standard -Administrator :
  • E -Mail: [email protected]
  • Setzen Sie Kennwort: /wtk/passwordreset.php?u=needtoset

Projektstruktur

 WizardsToolkit/
├── app/                # Application source files
├── config/             # Configuration settings
├── SQL/                # Database scripts and migrations
│   ├── mySQL/          # MySQL specific scripts
│   └── postgresql/     # PostgreSQL specific scripts
├── Mounts/             # Docker volume mount points
└── *.sh                # Utility scripts

Konfiguration

Lokale Entwicklungssetup

1. Hostkonfiguration (optional, aber empfohlen):

    # Add to /etc/hosts
   127.0.0.1   dev.wtk.com
   

2. Umgebungseinstellungen : Bearbeiten Sie Ihre datenbankspezifische Konfiguration:

    # In phpMySQL.env or phpPG.env
   URL = "http://dev.wtk.com"  # or http://127.0.0.1

Datenbankkonfiguration

Wählen Sie Ihre bevorzugte Datenbank:

MySQL (Standard) :

• Verwenden Sie die vorhandene Konfiguration
• Datenort: /Mounts/mydata
• Zugriff über phpmyadmin oder cli

PostgreSQL :

• docker-composePG.yml in docker-compose.yml umbenennen
• Datenort: /Mounts/pgdata
• Verbinden Sie mit DBeaver oder Preferred Client
• Verbindungsdetails:

   Database: pgwiztools
  Username: wizdba
  Password: See docker-compose.yml
  

Entwicklungstools

Dienstprogrammskripte

• WTK.sh : Umgebung initialisieren
• START_CONTAINERS.sh : Startdienste
• STOP_CONTAINERS.sh : STOPT ALLE Container
• REBUILD_CONTAINERS.sh : Umgebung wieder aufbauen
• RESTART_WEBSITE.sh : Quick Service Neustart
• SETUP_MYSQL.sh : MySQL -Datenbank initialisieren
• MYSQL.sh : MySQL CLI -Zugriff

Datenbankverwaltung

MySQL (über phpmyadmin)

Zugriff auf phpmyadmin unter http://127.0.0.1:8080/ oder http://dev.wtk.com:8080/

1. Login :

   • Benutzername: Wurzel
   • Passwort: (siehe Docker-compose.yml)

2. Grundlegende Operationen :

   • Wählen Sie wiztools -Datenbank aus der linken Seitenleiste aus
   • Durchsuchen Sie Tabellen und Daten mit der GUI -Schnittstelle
   • Führen Sie SQL -Abfragen mit der Registerkarte "SQL" aus
   • Import/exportieren Sie Daten mit den entsprechenden Registerkarten

3. Häufige Aufgaben :

   • Tabellenstruktur anzeigen: Klicken Sie auf Tabellenname → "Struktur"
   • Daten durchsuchen: Klicken Sie auf Tabellenname → "Durchsuchen"
   • Datensätze hinzufügen: Klicken Sie auf Tabellenname → "Einfügen"
   • Sicherungsdatenbank: Export → "Schnell" oder "benutzerdefiniert"

PostgreSQL

Verbindungsdetails:

• Datenbank: pgwiztools
• Benutzername: Wizdba
• Passwort: (siehe Docker-compose.yml)

Empfohlene PostgreSQL GUI -Kunde: dBeaver (kostenlos)

Hinweis: Stellen Sie sicher, dass kein lokaler PostgreSQL -Server ausgeführt wird, bevor die Docker -Container gestartet werden.

Dokumentation & Ressourcen

• Offizielle Dokumentation
• Setup -Handbuch
• Wiki
• Tutorials
• Demo -Dateien
• Kontaktformular

Lizenz

Dieses Projekt ist unter der Apache -Lizenz 2.0 lizenziert. Weitere Informationen finden Sie in der Lizenzdatei.

Fehlerbehebung

Häufige Probleme

1. Docker -Aufbau -Fehler :

    export DOCKER_BUILDKIT=0
   ./WTK.sh  # Retry build

2. Datenbank Zurücksetzen :

   ./STOP_CONTAINERS.sh
   rm -rf /Mounts/mydata  # For MySQL
   # or
   rm -rf /Mounts/pgdata  # For PostgreSQL
   ./START_CONTAINERS.sh
   ./SETUP_MYSQL.sh  # MySQL only

3. Hafenkonflikte :

   • Stellen Sie sicher, dass die Ports 80 und 443 verfügbar sind
   • Stoppen Sie alle laufenden Webserver (Apache, Nginx)
   • Wählen Sie zwischen MAMP oder Docker, nicht beides

4. Erstanpassungs-Setup :

   • Die Datenbankinitialisierung dauert ~ 1-2 Minuten
   • Überwachen Sie den Fortschritt in DockerDesktop
   • Warten Sie, bis der Datenbankcontainer vollständig fertig ist

5. Verbindungsprobleme :

   • Überprüfen Sie, ob Docker -Container ausgeführt werden
   • Überprüfen Sie, ob die Ports nicht durch Firewall blockiert werden
   • Stellen Sie sicher

Sicherheit

Verwenden Sie für sicherheitsrelevante Probleme unser Kontaktformular.

---

Gebaut und gepflegt mit ❤️ seit 2009