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

docs/user-guide/README.md

@@ -0,0 +1,20 @@
+# Multi-PHP User Guide / Kullanım Kılavuzu / Benutzerhandbuch
+
+Welcome to the official Multi-PHP documentation. Please select your preferred language to continue.
+
+Multi-PHP resmi dokümantasyonuna hoş geldiniz. Devam etmek için lütfen tercih ettiğiniz dili seçin.
+
+Willkommen zur offiziellen Multi-PHP-Dokumentation. Bitte wählen Sie Ihre bevorzugte Sprache aus, um fortzufahren.
+
+---
+
+### 🌐 Select Language / Dil Seçin / Sprache wählen
+
+- [**English (EN)**](./en/index.md) - Official documentation in English.
+- [**Türkçe (TR)**](./tr/index.md) - Türkçe kullanım kılavuzu.
+- [**Deutsch (DE)**](./de/index.md) - Benutzerhandbuch auf Deutsch.
+
+---
+
+> [!TIP]
+> Multi-PHP is designed to provide a seamless local development environment with multiple PHP, MariaDB, and web server versions.

docs/user-guide/de/database.md

@@ -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)

docs/user-guide/de/index.md

@@ -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)

docs/user-guide/de/php.md

@@ -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)

docs/user-guide/de/projects.md

@@ -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)

docs/user-guide/de/settings.md

@@ -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)

docs/user-guide/de/tools.md

@@ -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)

docs/user-guide/de/troubleshooting.md

@@ -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.

docs/user-guide/de/web-servers.md

@@ -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)

docs/user-guide/en/database.md

@@ -0,0 +1,46 @@
+# MariaDB Database Management
+
+Multi-PHP provides a comprehensive toolset for managing MariaDB databases, from GUI-based wizards to deep process monitoring.
+
+---
+
+## 📊 Database & User Management
+
+Multi-PHP gives you easy access to creating and managing MySQL/MariaDB databases and users:
+
+- **Create Database**: Quickly create a new database with its own name.
+- **Manage Users**: Create new database users, set passwords, and manage permissions.
+- **List Databases**: View all existing databases and their usage statistics.
+
+---
+
+## 🧙 MariaDB Import & Export Wizards
+
+Our intelligent wizards take the complexity out of moving data:
+
+### **Import Wizard (SQL/Archive)**
+- Select a `.sql`, `.zip`, or `.sql.gz` file.
+- Choose your target MariaDB server and database.
+- Multi-PHP handles the rest, automatically extracting files and importing data into the chosen DB.
+
+### **Export Wizard (Backup)**
+- Select the database you want to export.
+- Choose if you want to compress the file using Gzip (`.gz`).
+- Save the file to your desired location.
+
+---
+
+## 🕒 MariaDB Process Monitor
+
+Monitor your database's activity in real time. Our Process Monitor shows:
+- **Active Connections**: Who is currently connected to the database.
+- **SQL Queries**: The exact SQL being executed and how long it's taking.
+- **Kill Processes**: Instantly terminate any stuck or problematic database connections.
+
+> [!TIP]
+> Need a more traditional web-based interface? Go to the **"Tools"** menu and install **phpMyAdmin** with just one click.
+
+### 📖 Next Steps
+- [Learn how to manage Nginx & Apache Servers](./web-servers.md)
+- [Manage CLI and System Integration](./settings.md)
+- [Troubleshooting Common Issues](./troubleshooting.md)

docs/user-guide/en/index.md

@@ -0,0 +1,39 @@
+# Introduction & Quick Start
+
+Welcome to **Multi-PHP**, the all-in-one local development environment for Windows. This guide will walk you through the first steps and help you get your environment up and running.
+
+---
+
+## 🚀 Quick Start
+
+Follow these steps to get started with your first PHP project:
+
+1.  **Launch Multi-PHP**: Open the application from your desktop or start menu.
+2.  **Dashboard Overview**: On your first launch, you'll see the Dashboard. This is your control center for all services.
+3.  **Download PHP**: Go to `Settings > PHP Versions` and download at least one PHP version (e.g., PHP 8.3).
+4.  **Start Services**: Click the **"Start All"** button on the Dashboard to launch Nginx/Apache and MariaDB.
+5.  **Create a Project**: Navigate to the **"My Projects"** tab and add your first project folder.
+
+---
+
+## 🏢 Core Components
+
+Multi-PHP bundles several essential tools for modern web development:
+
+| Component | Description |
+| :--- | :--- |
+| **PHP-FPM** | High-performance FastCGI process manager for PHP. |
+| **Nginx** | Modern, lightweight, and fast web server. |
+| **Apache** | Robust, traditional web server with `.htaccess` support. |
+| **MariaDB** | The community-developed, commercially supported fork of MySQL. |
+| **phpMyAdmin** | Web interface for easy database management. |
+
+---
+
+> [!IMPORTANT]
+> Some services might fail to start if their default ports (80, 3306) are already being used by other applications (like Skype or another XAMPP installation). Check the **"Settings"** to change these ports if needed.
+
+### 📖 Next Steps
+- [Learn how to manage Projects](./projects.md)
+- [Configure PHP Versions & Extensions](./php.md)
+- [Manage MariaDB Databases](./database.md)

docs/user-guide/en/php.md

@@ -0,0 +1,43 @@
+# PHP Versions & Extensions Management
+
+Multi-PHP makes it easy to switch, configure, and manage different PHP environments for your projects.
+
+---
+
+## 🔩 Managing PHP Versions
+
+Navigate to `Settings > PHP Versions` to download, select, and manage multiple PHP versions.
+
+- **Available Versions**: List of all PHP versions available for download.
+- **Downloaded Versions**: Versions already present on your system.
+- **Default Version**: The global PHP version typically used for CLI (e.g., in a terminal).
+- **Restart Delay**: Multi-PHP automatically restarts PHP-FPM when settings change.
+
+---
+
+## 🛠️ PHP Extension Manager
+
+Every PHP version in Multi-PHP comes with its own extension manager. You don't need to manually edit `php.ini` for common tasks anymore.
+
+### Using the Manager:
+1.  **Select Extension**: Find your desired extension (e.g., `mysql`, `gd`, `zip`).
+2.  **Toggle**: Click to enable or disable the extension.
+3.  **Apply**: Multi-PHP will update the `php.ini` file for you and restart the version's service automatically.
+
+---
+
+## 📝 Raw Editing of `php.ini`
+
+If you need fine-grained control over your PHP configuration, use the built-in **RAW EDITOR**.
+
+1.  **Open Editor**: Access the editor button in the extensions window.
+2.  **Save & Restart**: Click "Save and Restart" to apply changes immediately.
+3.  **Search & Replace**: Use the search functionality to find specific variables like `memory_limit` or `max_execution_time`.
+
+> [!TIP]
+> You can also use the **"Server Tuning"** tool under the "Tools" menu to quickly adjust common PHP performance settings without manually editing code files.
+
+### 📖 Next Steps
+- [Learn how to manage MariaDB Databases](./database.md)
+- [Configure Web Servers](./web-servers.md)
+- [System Integration](./settings.md)

docs/user-guide/en/projects.md

@@ -0,0 +1,42 @@
+# Virtual Hosts & Project Management
+
+Managing your local PHP projects in Multi-PHP is simple and effective. Our platform automatically handles virtual host configuration for you.
+
+---
+
+## 🏗️ Adding Your First Project
+
+To add a new project, navigate to the **"My Projects"** tab and click on the **"Add New Project"** button.
+
+### Fields to Fill:
+- **Project Name**: A descriptive name for your local project.
+- **Project Path**: The absolute path to your project folder.
+- **Host / Domain**: The local domain to use (e.g., `test-site.local`).
+- **PHP Version**: Choose which PHP-FPM version will run this project.
+- **MariaDB Version**: Choose the MariaDB version to use (Default: Latest).
+- **Server Type**: Decide between **Nginx** (Modern, High-performance) or **Apache** (Supports `.htaccess`).
+
+---
+
+## 🛠️ Managing Projects
+
+Each project in your list has a set of actions:
+1. **Browse File System**: Quickly open your project folder.
+2. **Open in Browser**: Open your local domain in your default browser.
+3. **Configure Server**: Edit specific Nginx/Apache configs just for this project.
+4. **Edit Project Settings**: Change PHP version, server type, or project paths.
+5. **Delete Project**: Remove it from the list (does not delete files).
+
+---
+
+## 🌐 Automatic Virtual Hosts
+
+Multi-PHP's configuration engine automatically generates the necessary virtual host files for Nginx and Apache. When you start the services, they will be aware of all your local domains.
+
+> [!WARNING]
+> You may need to edit your system's **`hosts`** file manually if you are using custom domains like `.local` or `.dev`. Multi-PHP tries its best to manage this, but some system permissions may require manual intervention.
+
+### 📖 Next Steps
+- [Configure PHP Versions & Extensions](./php.md)
+- [Manage MariaDB Databases](./database.md)
+- [System Integration](./settings.md)

docs/user-guide/en/settings.md

@@ -0,0 +1,43 @@
+# System Settings & CLI Integration
+
+Multi-PHP provides a robust way to integrate your local development environment directly into your operating system's command line.
+
+---
+
+## 💻 CLI & System PATH Integration
+
+Access your PHP and MariaDB binaries directly from any terminal window (CMD, PowerShell).
+
+### Setting Up CLI Access:
+1.  Navigate to `Settings > CLI & Environment Variables`.
+2.  Enable **"System PATH Integration"**.
+3.  Choose your **"Default PHP Version"** (this is what runs when you type `php` in a terminal).
+4.  Choose your **"Default MariaDB Version"** (for `mysql` and `mariadb` commands).
+5.  Click **"Sync Commands"** to apply changes.
+
+### Generated Commands (Aliases):
+Multi-PHP automatically creates and manages version-specific commands for you:
+- `php83`: Triggers PHP 8.3 binary.
+- `php74`: Triggers PHP 7.4 binary.
+- `mysql`: Triggers default MariaDB client.
+
+---
+
+## 🛰️ Port Management & Remote Access
+
+Each web and database server has its own port settings in `Settings > General`.
+
+- **Nginx & Apache Ports**: Defaults to 80, but can be changed to 8080 or 8888.
+- **MariaDB Port**: Defaults to 3306.
+- **PHP-FPM Port**: Defaults to 9000.
+- **Allow Remote Access**: When enabled, the software listens on `0.0.0.0` allowing other devices on your local network to access your development sites.
+
+---
+
+> [!WARNING]
+> You must **restart your terminal windows** (CMD, PowerShell) for the PATH changes to take effect after clicking "Sync Commands".
+
+### 📖 Next Steps
+- [Learn about Database Management](./database.md)
+- [System Advanced Tools](./tools.md)
+- [Troubleshooting Common Issues](./troubleshooting.md)

docs/user-guide/en/tools.md

@@ -0,0 +1,45 @@
+# Advanced Tools & Monitoring
+
+Multi-PHP goes beyond just serving PHP projects, providing a comprehensive set of diagnostic and performance tuning tools.
+
+---
+
+## 🚦 Service Logs & Activity Tracking
+
+Access live and historical logs for all services in the **"Service Logs"** menu.
+
+### Tracked Events:
+- **Service Starts/Stops**: View when exactly each server was launched or stopped.
+- **Service Errors**: Get detailed error messages if a service crashes or fails to start.
+- **Activity Chart**: A visual representation of service availability over time.
+- **Event Log**: A detailed, row-by-row history of every service-related action.
+
+---
+
+## 🎛️ Server Tuning & Performance
+
+Fine-tune your environment for different types of development tasks using **"Server Tuning"**.
+
+### Modifiable Parameters:
+- **PHP Total Memory**: Increase `memory_limit` for heavy scripts.
+- **Max Execution Time**: Allow long-running local operations.
+- **Max Upload Size**: Increase file size limits for forms.
+- **MariaDB Connections**: Set the concurrent client limits.
+- **InnoDB Buffer Pool**: Tailor database performance based on your system RAM.
+
+---
+
+## 🗃️ phpMyAdmin Installation
+
+If you don't use another database GUI, Multi-PHP offers a one-click **phpMyAdmin** installation.
+
+- **Fast Install**: Multi-PHP downloads and configures the latest phpMyAdmin automatically.
+- **Easy Integration**: Accessible via your virtual host as `localhost/phpmyadmin` or a dedicated "OPEN" button.
+
+> [!TIP]
+> Use the **"Refresh"** button to ensure you are viewing the most up-to-date service information.
+
+### 📖 Next Steps
+- [Troubleshooting Common Issues](./troubleshooting.md)
+- [How to manage MariaDB Databases](./database.md)
+- [Configure PHP Versions & Extensions](./php.md)

docs/user-guide/en/troubleshooting.md

@@ -0,0 +1,46 @@
+# Troubleshooting & Frequently Asked Questions
+
+Common issues you might encounter while using Multi-PHP and how to fix them.
+
+---
+
+## 🚫 Service Fails to Start
+
+This is often caused by **port conflicts** with other software.
+
+- **Nginx & Apache (Port 80/443)**: Check if Skype, IIS, or another XAMPP/WAMP environment is running and using Port 80.
+- **MariaDB (Port 3306)**: Check if you have an existing MySQL or MariaDB installation running.
+- **Solution**: Go to `Settings > General` and change the conflicting port to something else (e.g., Change Nginx to 8080 or MariaDB to 3307).
+
+---
+
+## ❌ PHP Error: "No input file specified"
+
+This usually means Nginx or Apache cannot find your project's PHP files.
+
+- **Verify Project Path**: Check if the project path in "My Projects" is correct.
+- **Trailing Slash**: Ensure your project path doesn't end with an extra trailing slash unless necessary.
+- **Restart Services**: Try stopping all services and starting them again.
+
+---
+
+## 🔒 403 Forbidden Access
+
+Permissions or configuration issues can block access to your local site.
+
+- **Index File Missing**: Ensure your project folder contains an `index.php` or `index.html`.
+- **Nginx Config**: If using Nginx, check the project-specific configuration for any manual `deny` rules.
+- **Directory Indexing**: By default, Multi-PHP allows directory indexing. If it's blocked, you must have an index file.
+
+---
+
+## 💻 CLI Commands (php, mysql) Not Working
+
+- **PATH Not Updated**: You must click "Sync Commands" in the CLI settings.
+- **Terminal Window**: Close and reopen your terminal (CMD, PowerShell) for the changes to take effect.
+- **Check Integration**: Ensure the "System PATH Integration" toggle is ON.
+
+---
+
+> [!TIP]
+> If you're still having trouble, check the **"Service Logs"** for detailed error messages from the PHP, Nginx, or MariaDB binaries.

docs/user-guide/en/web-servers.md

@@ -0,0 +1,40 @@
+# Web Servers: Nginx vs. Apache
+
+Multi-PHP lets you choose the right web server for each of your projects or set a global default.
+
+---
+
+## 🌩️ Choosing a Web Server
+
+You can switch between Nginx and Apache for any of your projects in the **"My Projects"** settings.
+
+- **Nginx**: Lightweight, high-performance, and standard for modern web development.
+- **Apache**: Traditional, robust, and supports native `.htaccess` files for fine-grained configuration.
+
+---
+
+## 🛠️ Global Configuration Management
+
+Each server has its own main configuration file where you can manage ports, worker processes, and global settings.
+
+### Nginx Configuration (`nginx.conf`)
+- **Test Config**: Use the "Test Configuration" button to verify your changes without restarting the server.
+- **Save & Reload**: Apply configuration changes instantly.
+
+### Apache Configuration (`httpd.conf`)
+- **Main Server Settings**: Configure global document roots, module activation, and standard ports.
+- **HTAccess Support**: When Apache is active, it automatically reads `.htaccess` files in your project folders.
+
+---
+
+## 📁 Shared Server Assets
+
+Multi-PHP comes with pre-configured, professional designs for **Index of** (directory listings) and **Error Pages** (404, 500). These are consistent across both Nginx and Apache.
+
+> [!WARNING]
+> Editing global configuration files can prevent your servers from starting. Always use the **"Test Configuration"** tool before applying changes.
+
+### 📖 Next Steps
+- [Learn how to manage CLI and System Integration](./settings.md)
+- [System Advanced Tools](./tools.md)
+- [Troubleshooting Common Issues](./troubleshooting.md)

docs/user-guide/tr/database.md

@@ -0,0 +1,46 @@
+# MariaDB Veritabanı Yönetimi
+
+Multi-PHP, GUI tabanlı sihirbazlardan derin süreç izlemeye kadar MariaDB veritabanlarını yönetmek için kapsamlı bir araç seti sunar.
+
+---
+
+## 📊 Veritabanı ve Kullanıcı Yönetimi
+
+Multi-PHP, MySQL/MariaDB veritabanlarını ve kullanıcılarını kolayca oluşturmanızı ve yönetmenizi sağlar:
+
+- **Veritabanı Oluştur**: Kendi adıyla hızlıca yeni bir veritabanı oluşturun.
+- **Kullanıcıları Yönet**: Yeni veritabanı kullanıcıları oluşturun, şifre belirleyin ve izinleri yönetin.
+- **Veritabanlarını Listele**: Mevcut tüm veritabanlarını ve kullanım istatistiklerini görüntüleyin.
+
+---
+
+## 🧙 MariaDB İçe ve Dışa Aktarma Sihirbazları
+
+Akıllı sihirbazlarımız veri taşıma işleminin karmaşıklığını ortadan kaldırır:
+
+### **İçe Aktarma Sihirbazı (SQL/Arşiv)**
+- Bir `.sql`, `.zip` veya `.sql.gz` dosyası seçin.
+- Hedef MariaDB sunucunuzu ve veritabanınızı seçin.
+- Multi-PHP gerisini halleder, dosyaları otomatik olarak ayıklar ve verileri seçilen DB'ye aktarır.
+
+### **Dışa Aktarma Sihirbazı (Yedekleme)**
+- Dışa aktarmak istediğiniz veritabanını seçin.
+- Dosyayı Gzip (`.gz`) kullanarak sıkıştırmak isteyip istemediğinizi seçin.
+- Dosyayı istediğiniz konuma kaydedin.
+
+---
+
+## 🕒 MariaDB Süreç İzleyici
+
+Veritabanınızın etkinliğini gerçek zamanlı olarak izleyin. Süreç İzleyicimiz şunları gösterir:
+- **Aktif Bağlantılar**: Şu anda veritabanına kimlerin bağlı olduğu.
+- **SQL Sorguları**: Çalıştırılan tam SQL ve ne kadar sürdüğü.
+- **Süreçleri Sonlandır**: Takılan veya sorunlu veritabanı bağlantılarını anında sonlandırın.
+
+> [!TIP]
+> Daha geleneksel bir web tabanlı arayüze mi ihtiyacınız var? **"Araçlar"** menüsüne gidin ve tek bir tıklamayla **phpMyAdmin**'i kurun.
+
+### 📖 Sonraki Adımlar
+- [Nginx ve Apache Sunucularını Yönetmeyi Öğrenin](./web-servers.md)
+- [CLI ve Sistem Entegrasyonunu Yönetin](./settings.md)
+- [Yaygın Sorunları Giderme](./troubleshooting.md)

docs/user-guide/tr/index.md

@@ -0,0 +1,39 @@
+# Giriş ve Hızlı Başlangıç
+
+Windows için hepsi bir arada yerel geliştirme ortamı olan **Multi-PHP**'ye hoş geldiniz. Bu kılavuz, ilk adımlarınızda size yol gösterecek ve ortamınızı kurup çalıştırmanıza yardımcı olacaktır.
+
+---
+
+## 🚀 Hızlı Başlangıç
+
+İlk PHP projenize başlamak için bu adımları izleyin:
+
+1.  **Multi-PHP'yi Başlatın**: Uygulamayı masaüstünden veya başlat menüsünden açın.
+2.  **Kontrol Paneli Özeti**: İlk açılışta Kontrol Panelini göreceksiniz. Burası tüm servisleriniz için kontrol merkezinizdir.
+3.  **PHP İndirin**: `Ayarlar > PHP Versiyonları` bölümüne gidin ve en az bir PHP versiyonu (ör. PHP 8.3) indirin.
+4.  **Servisleri Başlatın**: Nginx/Apache ve MariaDB'yi başlatmak için Kontrol Panelindeki **"Hepsini Başlat"** düğmesine tıklayın.
+5.  **Proje Oluşturun**: **"Projelerim"** sekmesine gidin ve ilk proje klasörünüzü ekleyin.
+
+---
+
+## 🏢 Temel Bileşenler
+
+Multi-PHP, modern web geliştirme için birkaç temel aracı bir araya getirir:
+
+| Bileşen | Açıklama |
+| :--- | :--- |
+| **PHP-FPM** | PHP için yüksek performanslı FastCGI süreç yöneticisi. |
+| **Nginx** | Modern, hafif ve hızlı web sunucusu. |
+| **Apache** | `.htaccess` desteğine sahip, sağlam, geleneksel web sunucusu. |
+| **MariaDB** | MySQL'in topluluk tarafından geliştirilen, ticari olarak desteklenen çatalı. |
+| **phpMyAdmin** | Kolay veritabanı yönetimi için web arayüzü. |
+
+---
+
+> [!IMPORTANT]
+> Varsayılan portları (80, 3306) başka uygulamalar (Skype veya başka bir XAMPP kurulumu gibi) tarafından kullanılıyorsa servislerin başlatılması başarısız olabilir. Gerekirse bu portları değiştirmek için **"Ayarlar"**ı kontrol edin.
+
+### 📖 Sonraki Adımlar
+- [Projeleri Nasıl Yöneteceğinizi Öğrenin](./projects.md)
+- [PHP Versiyonlarını ve Eklentilerini Yapılandırın](./php.md)
+- [MariaDB Veritabanlarını Yönetin](./database.md)

docs/user-guide/tr/php.md

@@ -0,0 +1,43 @@
+# PHP Versiyonları ve Eklentileri Yönetimi
+
+Multi-PHP, projeleriniz için farklı PHP ortamlarını kolayca değiştirmenize, yapılandırmanıza ve yönetmenize olanak tanır.
+
+---
+
+## 🔩 PHP Versiyonlarını Yönetme
+
+Gereken PHP versiyonlarını indirmek, seçmek ve yönetmek için `Ayarlar > PHP Versiyonları` bölümüne gidin.
+
+- **Kullanılabilir Versiyonlar**: İndirilmeye hazır tüm PHP versiyonlarının listesi.
+- **İndirilen Versiyonlar**: Sisteminizde yüklü olan versiyonlar.
+- **Varsayılan Versiyon**: CLI (ör. terminal) için kullanılan genel PHP versiyonu.
+- **Yeniden Başlatma Gecikmesi**: Ayarlar değiştiğinde Multi-PHP, PHP-FPM'yi otomatik olarak yeniden başlatır.
+
+---
+
+## 🛠️ PHP Eklenti Yöneticisi
+
+Multi-PHP'deki her PHP versiyonu kendi eklenti yöneticisiyle birlikte gelir. Artık yaygın görevler için `php.ini` dosyasını manuel olarak düzenlemenize gerek yok.
+
+### Yöneticinin Kullanımı:
+1.  **Eklentiyi Seçin**: İstediğiniz eklentiyi bulun (ör. `mysql`, `gd`, `zip`).
+2.  **Değiştir**: Eklentiyi etkinleştirmek veya devre dışı bırakmak için tıklayın.
+3.  **Uygula**: Multi-PHP, `php.ini` dosyasını sizin için güncelleyecek ve ilgili servisi otomatik olarak yeniden başlatacaktır.
+
+---
+
+## 📝 `php.ini` Dosyasını Manuel Düzenleme
+
+PHP yapılandırmanız üzerinde ince ayar yapmanız gerekirse, yerleşik **RAW EDİTÖR**'ü kullanın.
+
+1.  **Editörü Açın**: Eklentiler penceresindeki editör düğmesine erişin.
+2.  **Kaydet ve Yeniden Başlat**: Değişiklikleri anında uygulamak için "Kaydet ve Yeniden Başlat" düğmesine tıklayın.
+3.  **Bul ve Değiştir**: `memory_limit` veya `max_execution_time` gibi belirli değişkenleri bulmak için arama işlevini kullanın.
+
+> [!TIP]
+> `php.ini` dosyalarını manuel olarak düzenlemek zorunda kalmadan yaygın PHP performans ayarlarını hızlıca yapmak için "Araçlar" menüsü altındaki **"Sunucu Ayarlaması"** aracını da kullanabilirsiniz.
+
+### 📖 Sonraki Adımlar
+- [MariaDB Veritabanlarını Yönetmeyi Öğrenin](./database.md)
+- [Web Sunucularını Yapılandırın](./web-servers.md)
+- [Sistem Entegrasyonu](./settings.md)

docs/user-guide/tr/projects.md

@@ -0,0 +1,42 @@
+# Sanal Host ve Proje Yönetimi
+
+Multi-PHP'de yerel PHP projelerinizi yönetmek basit ve etkilidir. Platformumuz sizin için sanal host yapılandırmasını otomatik olarak yönetir.
+
+---
+
+## 🏗️ İlk Projenizi Ekleyin
+
+Yeni bir proje eklemek için **"Projelerim"** sekmesine gidin ve **"Yeni Proje Ekle"** düğmesine tıklayın.
+
+### Doldurulacak Alanlar:
+- **Proje Adı**: Yerel projeniz için açıklayıcı bir ad.
+- **Proje Yolu**: Proje klasörünüzün mutlak yolu.
+- **Host / Domain**: Kullanılacak yerel alan adı (örneğin, `test-site.local`).
+- **PHP Versiyonu**: Bu projeyi çalıştıracak PHP-FPM versiyonunu seçin.
+- **MariaDB Versiyonu**: Kullanılacak MariaDB versiyonunu seçin (Varsayılan: En Son).
+- **Sunucu Tipi**: **Nginx** (Modern, Yüksek Performans) veya **Apache** (`.htaccess` destekler) arasında karar verin.
+
+---
+
+## 🛠️ Projeleri Yönetme
+
+Listenizdeki her projenin bir dizi eylemi vardır:
+1. **Dosya Sistemi Gözat**: Proje klasörünüzü hızlıca açın.
+2. **Tarayıcıda Aç**: Yerel alan adınızı varsayılan tarayıcınızda açın.
+3. **Sunucuyu Yapılandır**: Yalnızca bu proje için özel Nginx/Apache konfigürasyonlarını düzenleyin.
+4. **Proje Ayarlarını Düzenle**: PHP versiyonunu, sunucu tipini veya proje yollarını değiştirin.
+5. **Projeyi Sil**: Listeden kaldırın (dosyaları silmez).
+
+---
+
+## 🌐 Otomatik Sanal Hostlar
+
+Multi-PHP'nin yapılandırma motoru, Nginx ve Apache için gerekli sanal host dosyalarını otomatik olarak oluşturur. Servisleri başlattığınızda, tüm yerel alan adlarınızdan haberdar olurlar.
+
+> [!WARNING]
+> `.local` veya `.dev` gibi özel alan adları kullanıyorsanız sisteminizin **`hosts`** dosyasını manuel olarak düzenlemeniz gerekebilir. Multi-PHP bunu yönetmek için elinden geleni yapar, ancak bazı sistem izinleri manuel müdahale gerektirebilir.
+
+### 📖 Sonraki Adımlar
+- [PHP Versiyonlarını ve Eklentilerini Yapılandırın](./php.md)
+- [MariaDB Veritabanlarını Yönetin](./database.md)
+- [Sistem Entegrasyonu](./settings.md)

docs/user-guide/tr/settings.md

@@ -0,0 +1,43 @@
+# Sistem Ayarları ve CLI Entegrasyonu
+
+Multi-PHP, yerel geliştirme ortamınızı doğrudan işletim sisteminizin komut satırına entegre etmenin sağlam bir yolunu sunar.
+
+---
+
+## 💻 CLI ve Sistem PATH Entegrasyonu
+
+Herhangi bir terminal penceresinden (CMD, PowerShell) PHP ve MariaDB ikili dosyalarına doğrudan erişin.
+
+### CLI Erişimini Kurma:
+1.  `Ayarlar > CLI ve Ortam Değişkenleri` bölümüne gidin.
+2.  **"Sistem PATH Entegrasyonu"** seçeneğini etkinleştirin.
+3.  **"Varsayılan PHP Versiyonu"**nu seçin (terminale `php` yazdığınızda bu versiyon çalışır).
+4.  **"Varsayılan MariaDB Versiyonu"**nu seçin (`mysql` ve `mariadb` komutları için).
+5.  Değişiklikleri uygulamak için **"Komutları Senkronize Et"** düğmesine tıklayın.
+
+### Oluşturulan Komutlar (Takma Adlar):
+Multi-PHP sizin için versiyona özel komutları otomatik olarak oluşturur ve yönetir:
+- `php83`: PHP 8.3 ikili dosyasını tetikler.
+- `php74`: PHP 7.4 ikili dosyasını tetikler.
+- `mysql`: Varsayılan MariaDB istemcisini tetikler.
+
+---
+
+## 🛰️ Port Yönetimi ve Uzaktan Erişim
+
+Her web ve veritabanı sunucusunun `Ayarlar > Genel` bölümünde kendi port ayarları vardır.
+
+- **Nginx ve Apache Portları**: Varsayılan olarak 80'dir, ancak 8080 veya 8888 olarak değiştirilebilir.
+- **MariaDB Portu**: Varsayılan olarak 3306'dır.
+- **PHP-FPM Portu**: Varsayılan olarak 9000'dir.
+- **Uzaktan Erişime İzin Ver**: Etkinleştirildiğinde, yazılım `0.0.0.0` adresini dinleyerek yerel ağınızdaki diğer cihazların geliştirme sitelerinize erişmesine olanak tanır.
+
+---
+
+> [!WARNING]
+> "Komutları Senkronize Et" düğmesine tıkladıktan sonra PATH değişikliklerinin etkili olması için **terminal pencerelerini (CMD, PowerShell) yeniden başlatmanız** gerekir.
+
+### 📖 Sonraki Adımlar
+- [Veritabanı Yönetimi Hakkında Bilgi Edinin](./database.md)
+- [Gelişmiş Sistem Araçları](./tools.md)
+- [Yaygın Sorunları Giderme](./troubleshooting.md)

docs/user-guide/tr/tools.md

@@ -0,0 +1,45 @@
+# Gelişmiş Araçlar ve İzleme
+
+Multi-PHP, sadece PHP projelerini sunmakla kalmaz, aynı zamanda kapsamlı bir tanılama ve performans ayarlama araçları seti sunar.
+
+---
+
+## 🚦 Servis Kayıtları ve Etkinlik İzleme
+
+**"Servis Logları"** menüsünden tüm servisler için canlı ve geçmiş kayıtlara erişin.
+
+### İzlenen Etkinlikler:
+- **Servis Başlatma/Durdurma**: Her sunucunun tam olarak ne zaman başlatıldığını veya durdurulduğunu görün.
+- **Servis Hataları**: Bir servis çökerse veya başlatılamazsa ayrıntılı hata mesajları alın.
+- **Etkinlik Grafiği**: Servislerin zaman içindeki kullanılabilirliğinin görsel temsili.
+- **Olay Günlüğü**: Servisle ilgili her eylemin ayrıntılı, satır satır geçmişi.
+
+---
+
+## 🎛️ Sunucu Ayarı ve Performans
+
+**"Sunucu Ayarlaması"** seçeneğini kullanarak farklı geliştirme görevleri türleri için ortamınıza ince ayar yapın.
+
+### Değiştirilebilir Parametreler:
+- **Toplam PHP Belleği**: Ağır betikler için `memory_limit` değerini artırın.
+- **Maksimum Çalışma Süresi**: Uzun süren yerel işlemler için izin verin.
+- **Maksimum Yükleme Boyutu**: Formlar için dosya boyutu sınırlarını artırın.
+- **MariaDB Bağlantıları**: Eşzamanlı istemci sınırlarını belirleyin.
+- **InnoDB Arabellek Havuzu**: Veritabanı performansını sistem RAM'inize göre uyarlayın.
+
+---
+
+## 🗃️ phpMyAdmin Kurulumu
+
+Başka bir veritabanı GUI'si kullanmıyorsanız, Multi-PHP tek tıkla **phpMyAdmin** kurulumu sunar.
+
+- **Hızlı Kurulum**: Multi-PHP, en son phpMyAdmin sürümünü otomatik olarak indirir ve yapılandırır.
+- **Kolay Entegrasyon**: Sanal ana bilgisayarınız üzerinden `localhost/phpmyadmin` olarak veya özel bir "AÇ" düğmesiyle erişilebilir.
+
+> [!TIP]
+> En güncel servis bilgilerini görüntülediğinizden emin olmak için **"Yenile"** düğmesini kullanın.
+
+### 📖 Sonraki Adımlar
+- [Yaygın Sorunları Giderme](./troubleshooting.md)
+- [MariaDB Veritabanlarını Yönetme](./database.md)
+- [PHP Versiyonlarını ve Eklentilerini Yapılandırma](./php.md)

docs/user-guide/tr/troubleshooting.md

@@ -0,0 +1,46 @@
+# Sorun Giderme ve Sıkça Sorulan Sorular
+
+Multi-PHP kullanırken karşılaşabileceğiniz yaygın sorunlar ve bunların nasıl düzeltileceği.
+
+---
+
+## 🚫 Servis Başlatılamadı
+
+Bu durum genellikle diğer yazılımlarla olan **port çakışmalarından** kaynaklanır.
+
+- **Nginx ve Apache (Port 80/443)**: Skype, IIS veya başka bir XAMPP/WAMP ortamının çalışıp çalışmadığını ve Port 80'i kullanıp kullanmadığını kontrol edin.
+- **MariaDB (Port 3306)**: Mevcut bir MySQL veya MariaDB kurulumunun çalışıp çalışmadığını kontrol edin.
+- **Çözüm**: `Ayarlar > Genel` bölümüne gidin ve çakışan portu başka bir numara ile değiştirin (örneğin, Nginx'i 8080 veya MariaDB'yi 3307 olarak değiştirin).
+
+---
+
+## ❌ PHP Hatası: "No input file specified"
+
+Bu genellikle Nginx veya Apache'nin projenizin PHP dosyalarını bulamadığı anlamına gelir.
+
+- **Proje Yolunu Doğrulayın**: "Projelerim"deki proje yolunun doğru olup olmadığını kontrol edin.
+- **Sondaki Eğik Çizgi**: Proje yolunuzun gerekli olmadıkça fazladan bir eğik çizgi ile bitmediğinden emin olun.
+- **Servisleri Yeniden Başlatın**: Tüm servisleri durdurup yeniden başlatmayı deneyin.
+
+---
+
+## 🔒 403 Erişim Engellendi
+
+İzinler veya yapılandırma sorunları yerel sitenize erişimi engelleyebilir.
+
+- **Dizin Dosyası Eksik**: Proje klasörünüzün bir `index.php` veya `index.html` dosyası içerdiğinden emin olun.
+- **Nginx Yapılandırması**: Nginx kullanıyorsanız, projeye özel yapılandırmada herhangi bir manuel `deny` kuralı olup olmadığını kontrol edin.
+- **Dizin Listeleme**: Varsayılan olarak Multi-PHP dizin listelemeye izin verir. Engellenmişse, bir dizin dosyanızın olması gerekir.
+
+---
+
+## 💻 CLI Komutları (php, mysql) Çalışmıyor
+
+- **PATH Güncellenmedi**: CLI ayarlarında "Komutları Senkronize Et" düğmesine tıklamanız gerekir.
+- **Terminal Penceresi**: Değişikliklerin etkili olması için terminali (CMD, PowerShell) kapatıp yeniden açın.
+- **Entegrasyonu Kontrol Edin**: "Sistem PATH Entegrasyonu" anahtarının AÇIK olduğundan emin olun.
+
+---
+
+> [!TIP]
+> Hala sorun yaşıyorsanız, PHP, Nginx veya MariaDB ikili dosyalarından gelen ayrıntılı hata mesajları için **"Servis Logları"**nı kontrol edin.

docs/user-guide/tr/web-servers.md

@@ -0,0 +1,40 @@
+# Web Sunucuları: Nginx ve Apache
+
+Multi-PHP, her projeniz için doğru web sunucusunu seçmenize veya genel bir varsayılan belirlemenize olanak tanır.
+
+---
+
+## 🌩️ Web Sunucusu Seçme
+
+**"Projelerim"** ayarlarında projelerinizden herhangi biri için Nginx ve Apache arasında geçiş yapabilirsiniz.
+
+- **Nginx**: Hafif, yüksek performanslı ve modern web geliştirme için standart.
+- **Apache**: Geleneksel, sağlam ve ince ayarlı yapılandırma için yerel `.htaccess` dosyalarını destekler.
+
+---
+
+## 🛠️ Genel Yapılandırma Yönetimi
+
+Her sunucunun portları, işçi süreçlerini ve genel ayarları yönetebileceğiniz kendi ana yapılandırma dosyası vardır.
+
+### Nginx Yapılandırması (`nginx.conf`)
+- **Yapılandırmayı Test Et**: Sunucuyu yeniden başlatmadan değişikliklerinizi doğrulamak için "Yapılandırmoyu Test Et" düğmesini kullanın.
+- **Kaydet ve Yeniden Yükle**: Yapılandırma değişikliklerini anında uygulayın.
+
+### Apache Yapılandırması (`httpd.conf`)
+- **Ana Sunucu Ayarları**: Genel belge köklerini, modül etkinleştirmeyi ve standart portları yapılandırın.
+- **HTAccess Desteği**: Apache aktif olduğunda, proje klasörlerinizdeki `.htaccess` dosyalarını otomatik olarak okur.
+
+---
+
+## 📁 Paylaşılan Sunucu Varlıkları
+
+Multi-PHP, **Dizin Listeleme** ve **Hata Sayfaları** (404, 500) için önceden yapılandırılmış, profesyonel tasarımlarla birlikte gelir. Bunlar hem Nginx hem de Apache'de tutarlıdır.
+
+> [!WARNING]
+> Genel yapılandırma dosyalarını düzenlemek sunucularınızın başlatılmasını engelleyebilir. Değişiklikleri uygulamadan önce her zaman **"Yapılandırmayı Test Et"** aracını kullanın.
+
+### 📖 Sonraki Adımlar
+- [CLI ve Sistem Entegrasyonunu Yönetmeyi Öğrenin](./settings.md)
+- [Gelişmiş Sistem Araçları](./tools.md)
+- [Yaygın Sorunları Giderme](./troubleshooting.md)