feat: implement user guide documentation in multiple languages and add IPC infrastructure for UI components

This commit is contained in:
Ümit Tunç
2026-04-02 17:16:52 +03:00
parent baf1739f6d
commit 0a67fda211
32 changed files with 1594 additions and 9 deletions
+46
View File
@@ -0,0 +1,46 @@
# MariaDB Datenbankverwaltung
Multi-PHP bietet ein umfassendes Toolset zur Verwaltung von MariaDB-Datenbanken, von GUI-basierten Assistenten bis hin zur tiefen Prozessüberwachung.
---
## 📊 Datenbank- & Benutzerverwaltung
Multi-PHP bietet Ihnen einfachen Zugriff auf das Erstellen und Verwalten von MySQL/MariaDB-Datenbanken und Benutzern:
- **Datenbank erstellen**: Erstellen Sie schnell eine neue Datenbank mit eigenem Namen.
- **Benutzer verwalten**: Erstellen Sie neue Datenbankbenutzer, setzen Sie Passwörter und verwalten Sie Berechtigungen.
- **Datenbanken auflisten**: Zeigen Sie alle vorhandenen Datenbanken und deren Nutzungsstatistiken an.
---
## 🧙 MariaDB Import- & Export-Assistenten
Unsere intelligenten Assistenten nehmen die Komplexität aus dem Verschieben von Daten:
### **Import-Assistent (SQL/Archiv)**
- Wählen Sie eine `.sql`-, `.zip`- oder `.sql.gz`-Datei aus.
- Wählen Sie Ihren Ziel-MariaDB-Server und Ihre Datenbank aus.
- Multi-PHP erledigt den Rest, entpackt Dateien automatisch und importiert Daten in die gewählte DB.
### **Export-Assistent (Backup)**
- Wählen Sie die Datenbank aus, die Sie exportieren möchten.
- Wählen Sie aus, ob Sie die Datei mit Gzip (`.gz`) komprimieren möchten.
- Speichern Sie die Datei an Ihrem gewünschten Ort.
---
## 🕒 MariaDB Prozessmonitor
Überwachen Sie die Aktivität Ihrer Datenbank in Echtzeit. Unser Prozessmonitor zeigt:
- **Aktive Verbindungen**: Wer ist aktuell mit der Datenbank verbunden.
- **SQL-Abfragen**: Das genaue SQL, das ausgeführt wird, und wie lange es dauert.
- **Prozesse abbrechen**: Beenden Sie hängende oder problematische Datenbankverbindungen sofort.
> [!TIP]
> Benötigen Sie ein traditionelleres webbasiertes Interface? Gehen Sie zum Menü **"Tools"** und installieren Sie **phpMyAdmin** mit nur einem Klick.
### 📖 Nächste Schritte
- [Lernen Sie, wie Sie Nginx & Apache Server verwalten](./web-servers.md)
- [CLI und Systemintegration verwalten](./settings.md)
- [Fehlerbehebung bei häufigen Problemen](./troubleshooting.md)
+39
View File
@@ -0,0 +1,39 @@
# Einführung & Schnellstart
Willkommen bei **Multi-PHP**, der All-in-One-lokalen Entwicklungsumgebung für Windows. Diese Anleitung führt Sie durch die ersten Schritte und hilft Ihnen dabei, Ihre Umgebung einzurichten und in Betrieb zu nehmen.
---
## 🚀 Schnellstart
Folgen Sie diesen Schritten, um mit Ihrem ersten PHP-Projekt zu beginnen:
1. **Multi-PHP starten**: Öffnen Sie die Anwendung von Ihrem Desktop oder dem Startmenü aus.
2. **Dashboard-Übersicht**: Beim ersten Start sehen Sie das Dashboard. Dies ist Ihre Zentrale für alle Dienste.
3. **PHP herunterladen**: Gehen Sie zu `Einstellungen > PHP-Versionen` und laden Sie mindestens eine PHP-Version (z. B. PHP 8.3) herunter.
4. **Dienste starten**: Klicken Sie auf die Schaltfläche **"Alle starten"** im Dashboard, um Nginx/Apache und MariaDB zu starten.
5. **Projekt erstellen**: Navigieren Sie zum Tab **"Meine Projekte"** und fügen Sie Ihren ersten Projektordner hinzu.
---
## 🏢 Kernkomponenten
Multi-PHP bündelt mehrere wichtige Werkzeuge für die moderne Webentwicklung:
| Komponente | Beschreibung |
| :--- | :--- |
| **PHP-FPM** | Hochleistungs-FastCGI-Prozessmanager für PHP. |
| **Nginx** | Moderner, leichtgewichtiger und schneller Webserver. |
| **Apache** | Robuster, traditioneller Webserver mit Unterstützung für `.htaccess`. |
| **MariaDB** | Der von der Community entwickelte, kommerziell unterstützte Fork von MySQL. |
| **phpMyAdmin** | Web-Interface für einfaches Datenbankmanagement. |
---
> [!IMPORTANT]
> Einige Dienste können möglicherweise nicht gestartet werden, wenn ihre Standard-Ports (80, 3306) bereits von anderen Anwendungen (wie Skype oder einer anderen XAMPP-Installation) belegt sind. Überprüfen Sie die **"Einstellungen"**, um diese Ports bei Bedarf zu ändern.
### 📖 Nächste Schritte
- [Lernen Sie, wie Sie Projekte verwalten](./projects.md)
- [PHP-Versionen und Erweiterungen konfigurieren](./php.md)
- [MariaDB-Datenbanken verwalten](./database.md)
+43
View File
@@ -0,0 +1,43 @@
# Verwaltung von PHP-Versionen & Erweiterungen
Multi-PHP macht es einfach, verschiedene PHP-Umgebungen für Ihre Projekte zu wechseln, zu konfigurieren und zu verwalten.
---
## 🔩 PHP-Versionen verwalten
Navigieren Sie zu `Einstellungen > PHP-Versionen`, um PHP-Versionen herunterzuladen, auszuwählen und zu verwalten.
- **Verfügbare Versionen**: Liste aller PHP-Versionen, die zum Download bereitstehen.
- **Heruntergeladene Versionen**: Versionen, die bereits auf Ihrem System vorhanden sind.
- **Standard-Version**: Die globale PHP-Version, die normalerweise für CLI verwendet wird (z. B. in einem Terminal).
- **Neustart-Verzögerung**: Multi-PHP startet PHP-FPM automatisch neu, wenn Einstellungen geändert werden.
---
## 🛠️ PHP-Erweiterungsmanager
Jede PHP-Version in Multi-PHP wird mit ihrem eigenen Erweiterungsmanager geliefert. Sie müssen die `php.ini` für gängige Aufgaben nicht mehr manuell bearbeiten.
### Verwendung des Managers:
1. **Erweiterung auswählen**: Finden Sie Ihre gewünschte Erweiterung (z. B. `mysql`, `gd`, `zip`).
2. **Umschalten**: Klicken Sie, um die Erweiterung zu aktivieren oder zu deaktivieren.
3. **Anwenden**: Multi-PHP wird die `php.ini`-Datei für Sie aktualisieren und den Dienst der Version automatisch neu starten.
---
## 📝 Manuelle Bearbeitung der `php.ini`
Wenn Sie mehr Kontrolle über Ihre PHP-Konfiguration benötigen, verwenden Sie den integrierten **RAW EDITOR**.
1. **Editor öffnen**: Greifen Sie über die Schaltfläche im Erweiterungsfenster auf den Editor zu.
2. **Speichern & Neustarten**: Klicken Sie auf "Speichern und Neustarten", um Änderungen sofort anzuwenden.
3. **Suchen & Ersetzen**: Verwenden Sie die Suchfunktion, um spezifische Variablen wie `memory_limit` oder `max_execution_time` zu finden.
> [!TIP]
> Sie können auch das Werkzeug **"Server Tuning"** im Menü "Tools" verwenden, um gängige PHP-Leistungseinstellungen schnell anzupassen, ohne Code-Dateien manuell bearbeiten zu müssen.
### 📖 Nächste Schritte
- [Lernen Sie, wie Sie MariaDB-Datenbanken verwalten](./database.md)
- [Webserver konfigurieren](./web-servers.md)
- [Systemintegration](./settings.md)
+42
View File
@@ -0,0 +1,42 @@
# Virtuelle Hosts & Projektmanagement
Die Verwaltung Ihrer lokalen PHP-Projekte in Multi-PHP ist einfach und effektiv. Unsere Plattform übernimmt automatisch die Konfiguration der virtuellen Hosts für Sie.
---
## 🏗️ Ihr erstes Projekt hinzufügen
Um ein neues Projekt hinzuzufügen, navigieren Sie zum Tab **"Meine Projekte"** und klicken Sie auf die Schaltfläche **"Neues Projekt hinzufügen"**.
### Zu füllende Felder:
- **Projektname**: Ein aussagekräftiger Name für Ihr lokales Projekt.
- **Projektpfad**: Der absolute Pfad zu Ihrem Projektordner.
- **Host / Domain**: Die zu verwendende lokale Domain (z.B. `test-site.local`).
- **PHP-Version**: Wählen Sie, welche PHP-FPM-Version dieses Projekt ausführen soll.
- **MariaDB-Version**: Wählen Sie die MariaDB-Version aus (Standard: Aktuellste).
- **Servertyp**: Entscheiden Sie sich zwischen **Nginx** (Modern, Hochleistung) oder **Apache** (Unterstützt `.htaccess`).
---
## 🛠️ Projekte verwalten
Jedes Projekt in Ihrer Liste hat eine Reihe von Aktionen:
1. **Dateisystem durchsuchen**: Öffnen Sie schnell Ihren Projektordner.
2. **Im Browser öffnen**: Öffnen Sie Ihre lokale Domain in Ihrem Standardbrowser.
3. **Server konfigurieren**: Bearbeiten Sie spezifische Nginx/Apache-Konfigurationen nur für dieses Projekt.
4. **Projekteinstellungen bearbeiten**: Ändern Sie PHP-Version, Servertyp oder Projektpfade.
5. **Projekt löschen**: Entfernen Sie es aus der Liste (Dateien werden nicht gelöscht).
---
## 🌐 Automatische virtuelle Hosts
Das Konfigurationsmodul von Multi-PHP generiert automatisch die erforderlichen Dateien für die virtuellen Hosts von Nginx und Apache. Wenn Sie die Dienste starten, sind alle Ihre lokalen Domains bekannt.
> [!WARNING]
> Sie müssen möglicherweise die **`hosts`**-Datei Ihres Systems manuell bearbeiten, wenn Sie benutzerdefinierte Domains wie `.local` oder `.dev` verwenden. Multi-PHP versucht sein Bestes, dies zu verwalten, aber einige Systemberechtigungen erfordern möglicherweise manuelles Eingreifen.
### 📖 Nächste Schritte
- [PHP-Versionen und Erweiterungen konfigurieren](./php.md)
- [MariaDB-Datenbanken verwalten](./database.md)
- [Systemintegration](./settings.md)
+43
View File
@@ -0,0 +1,43 @@
# Systemeinstellungen & CLI-Integration
Multi-PHP bietet eine robuste Möglichkeit, Ihre lokale Entwicklungsumgebung direkt in die Befehlszeile Ihres Betriebssystems zu integrieren.
---
## 💻 CLI & System-PATH-Integration
Greifen Sie direkt von jedem Terminalfenster (CMD, PowerShell) auf Ihre PHP- und MariaDB-Binärdateien zu.
### CLI-Zugriff einrichten:
1. Navigieren Sie zu `Einstellungen > CLI & Umgebungsvariablen`.
2. Aktivieren Sie die **"System-PATH-Integration"**.
3. Wählen Sie Ihre **"Standard-PHP-Version"** (das ist die Version, die ausgeführt wird, wenn Sie `php` in ein Terminal eingeben).
4. Wählen Sie Ihre **"Standard-MariaDB-Version"** (für die Befehle `mysql` und `mariadb`).
5. Klicken Sie auf **"Befehle synchronisieren"**, um Änderungen zu übernehmen.
### Generierte Befehle (Aliase):
Multi-PHP erstellt und verwaltet automatisch versionsspezifische Befehle für Sie:
- `php83`: Löst das PHP 8.3-Binary aus.
- `php74`: Löst das PHP 7.4-Binary aus.
- `mysql`: Löst den Standard-MariaDB-Client aus.
---
## 🛰️ Port-Management & Fernzugriff
Jeder Web- und Datenbankserver hat seine eigenen Port-Einstellungen in `Einstellungen > Allgemein`.
- **Nginx- & Apache-Ports**: Standardmäßig 80, kann aber auf 8080 oder 8888 geändert werden.
- **MariaDB-Port**: Standardmäßig 3306.
- **PHP-FPM-Port**: Standardmäßig 9000.
- **Fernzugriff erlauben**: Wenn aktiviert, lauscht die Software auf `0.0.0.0`, sodass andere Geräte in Ihrem lokalen Netzwerk auf Ihre Entwicklungs-Websites zugreifen können.
---
> [!WARNING]
> Sie müssen Ihre **Terminalfenster neu starten** (CMD, PowerShell), damit die PATH-Änderungen nach dem Klicken auf "Befehle synchronisieren" wirksam werden.
### 📖 Nächste Schritte
- [Lernen Sie die Datenbankverwaltung kennen](./database.md)
- [Fortgeschrittene Systemwerkzeuge](./tools.md)
- [Fehlerbehebung bei häufigen Problemen](./troubleshooting.md)
+45
View File
@@ -0,0 +1,45 @@
# Erweiterte Werkzeuge & Überwachung
Multi-PHP geht über die reine Bereitstellung von PHP-Projekten hinaus und bietet eine umfassende Palette an Diagnose- und Leistungsoptimierungswerkzeugen.
---
## 🚦 Dienstprotokolle & Aktivitätsverfolgung
Greifen Sie im Menü **"Dienst-Log"** auf Live- und Verlaufs-Protokolle für alle Dienste zu.
### Protokollierte Ereignisse:
- **Dienststarts/-stopps**: Sehen Sie genau, wann jeder Server gestartet oder gestoppt wurde.
- **Dienstfehler**: Erhalten Sie detaillierte Fehlermeldungen, wenn ein Dienst abstürzt oder nicht startet.
- **Aktivitätsdiagramm**: Eine visuelle Darstellung der Dienstverfügbarkeit im Zeitverlauf.
- **Ereignis-Protokoll**: Ein detaillierter, zeilenweiser Verlauf jeder dienstbezogenen Aktion.
---
## 🎛️ Servertuning & Leistung
Optimieren Sie Ihre Umgebung mit **"Servertuning"** für verschiedene Arten von Entwicklungsaufgaben.
### Änderbare Parameter:
- **PHP-Gesamtspeicher**: Erhöhen Sie den `memory_limit` für ressourcenintensive Skripte.
- **Max. Ausführungszeit**: Ermöglichen Sie langwierige lokale Operationen.
- **Max. Upload-Größe**: Erhöhen Sie Dateigrößenlimits für Formulare.
- **MariaDB-Verbindungen**: Legen Sie Concurrent-Client-Limits fest.
- **InnoDB-Pufferpool**: Passen Sie die Datenbankleistung basierend auf Ihrem System-RAM an.
---
## 🗃️ phpMyAdmin-Installation
Wenn Sie kein anderes Datenbank-GUI verwenden, bietet Multi-PHP eine Ein-Klick-Installation für **phpMyAdmin**.
- **Schnellinstallation**: Multi-PHP lädt die neueste Version von phpMyAdmin automatisch herunter und konfiguriert sie.
- **Einfache Integration**: Zugänglich über Ihren virtuellen Host als `localhost/phpmyadmin` oder über eine spezielle "ÖFFNEN"-Schaltfläche.
> [!TIP]
> Verwenden Sie die Schaltfläche **"Aktualisieren"**, um sicherzustellen, dass Sie die aktuellsten Dienstinformationen sehen.
### 📖 Nächste Schritte
- [Fehlerbehebung bei häufigen Problemen](./troubleshooting.md)
- [Lernen Sie die MariaDB-Datenbankverwaltung kennen](./database.md)
- [PHP-Versionen und Erweiterungen konfigurieren](./php.md)
+46
View File
@@ -0,0 +1,46 @@
# Fehlerbehebung & Häufig gestellte Fragen
Häufige Probleme, auf die Sie bei der Verwendung von Multi-PHP stoßen könnten, und wie Sie diese beheben können.
---
## 🚫 Dienst lässt sich nicht starten
Dies wird oft durch **Port-Konflikte** mit anderer Software verursacht.
- **Nginx & Apache (Port 80/443)**: Überprüfen Sie, ob Skype, IIS oder eine andere XAMPP/WAMP-Umgebung läuft und Port 80 verendet.
- **MariaDB (Port 3306)**: Überprüfen Sie, ob Sie eine bestehende MySQL- oder MariaDB-Installation haben, die bereits ausgeführt wird.
- **Lösung**: Gehen Sie zu `Einstellungen > Allgemein` und ändern Sie den betroffenen Port in etwas anderes (z. B. Nginx auf 8080 oder MariaDB auf 3307).
---
## ❌ PHP-Fehler: "No input file specified"
Dies bedeutet normalerweise, dass Nginx oder Apache die PHP-Dateien Ihres Projekts nicht finden kann.
- **Projektpfad überprüfen**: Überprüfen Sie, ob der Projektpfad in "Meine Projekte" korrekt ist.
- **Abschließender Schrägstrich**: Stellen Sie sicher, dass Ihr Projektpfad nicht mit einem extra Schrägstrich endet, es sei denn, dies ist erforderlich.
- **Dienste neu starten**: Versuchen Sie, alle Dienste zu stoppen und erneut zu starten.
---
## 🔒 403 Forbidden (Zugriff verweigert)
Berechtigungs- oder Konfigurationsprobleme können den Zugriff auf Ihre lokale Website blockieren.
- **Indexdatei fehlt**: Stellen Sie sicher, dass Ihr Projektordner eine `index.php` oder `index.html` enthält.
- **Nginx-Konfiguration**: Wenn Sie Nginx verwenden, überprüfen Sie die projektspezifische Konfiguration auf manuelle `deny`-Regeln.
- **Verzeichnisauflistung**: Standardmäßig erlaubt Multi-PHP die Verzeichnisauflistung. Wenn dies blockiert ist, müssen Sie eine Indexdatei haben.
---
## 💻 CLI-Befehle (php, mysql) funktionieren nicht
- **PATH nicht aktualisiert**: Sie müssen in den CLI-Einstellungen auf "Befehle synchronisieren" klicken.
- **Terminal-Fenster**: Schließen Sie Ihr Terminal (CMD, PowerShell) und öffnen Sie es erneut, damit die Änderungen wirksam werden.
- **Integration prüfen**: Stellen Sie sicher, dass der Schalter "System-PATH-Integration" auf EIN steht.
---
> [!TIP]
> Wenn Sie weiterhin Probleme haben, überprüfen Sie die **"Dienst-Logs"** auf detaillierte Fehlermeldungen der PHP-, Nginx- oder MariaDB-Binärdateien.
+40
View File
@@ -0,0 +1,40 @@
# Webserver: Nginx vs. Apache
Multi-PHP lässt Sie den richtigen Webserver für jedes Ihrer Projekte auswählen oder einen globalen Standard festlegen.
---
## 🌩️ Einen Webserver auswählen
Sie können für jedes Ihrer Projekte in den **"Meine Projekte"**-Einstellungen zwischen Nginx und Apache wechseln.
- **Nginx**: Leichtgewichtig, leistungsstark und Standard für die moderne Webentwicklung.
- **Apache**: Traditionell, robust und unterstützt nativ `.htaccess`-Dateien für fein abgestimmte Konfigurationen.
---
## 🛠️ Globales Konfigurationsmanagement
Jeder Server verfügt über eine eigene Hauptkonfigurationsdatei, in der Sie Ports, Worker-Prozesse und globale Einstellungen verwalten können.
### Nginx-Konfiguration (`nginx.conf`)
- **Konfiguration testen**: Verwenden Sie die Schaltfläche "Konfiguration testen", um Ihre Änderungen zu überprüfen, ohne den Server neu zu starten.
- **Speichern & Neu laden**: Wenden Sie Konfigurationsänderungen sofort an.
### Apache-Konfiguration (`httpd.conf`)
- **Hauptserver-Einstellungen**: Konfigurieren Sie globale Basisverzeichnisse, Modulaktivierungen und Standard-Ports.
- **HTAccess-Unterstützung**: Wenn Apache aktiv ist, liest er automatisch `.htaccess`-Dateien in Ihren Projektordnern.
---
## 📁 Gemeinsame Server-Assets
Multi-PHP bietet vorkonfigurierte, professionelle Designs für **Index von** (Verzeichnisauflistungen) und **Fehlerseiten** (404, 500). Diese sind sowohl in Nginx als auch in Apache konsistent.
> [!WARNING]
> Das Bearbeiten globaler Konfigurationsdateien kann den Start Ihrer Server verhindern. Verwenden Sie immer das Werkzeug **"Konfiguration testen"**, bevor Sie Änderungen übernehmen.
### 📖 Nächste Schritte
- [Lernen Sie, wie Sie CLI und Systemintegration verwalten](./settings.md)
- [Fortgeschrittene Systemwerkzeuge](./tools.md)
- [Fehlerbehebung bei häufigen Problemen](./troubleshooting.md)