docs: add README.md for project documentation

2026-03-30 08:36:53 +03:00
parent 57f85fe2a2
commit c9eea9319a
1 changed files with 67 additions and 0 deletions
@@ -0,0 +1,67 @@
+# Multi-PHP Server (Electron)
+
+**Multi-PHP Server**, modern web geliştiricileri için tasarlanmış, Windows tabanlı, taşınabilir (portable) ve yüksek performanslı bir yerel sunucu yönetim aracıdır. XAMPP veya Laragon gibi geleneksel araçlara modern bir alternatif olarak, **Electron** ve **React** teknolojileriyle geliştirilmiştir.
+
+## 🚀 Projenin Amacı
+
+Web geliştirme sürecinde farklı projeler, farklı PHP versiyonları ve veritabanı konfigürasyonları gerektirebilir. Multi-PHP Server, bu karmaşayı ortadan kaldırarak:
+- Aynı anda birden fazla PHP versiyonunu yönetmeyi,
+- Nginx tabanlı yüksek performanslı yönlendirmeyi,
+- Güvenli ve izole MySQL instance'larını,
+- Modern frameworklerin (Laravel, vb.) alt dizinlerde (alias) sorunsuz çalışmasını sağlamayı amaçlar.
+
+## ✨ Temel Özellikler
+
+### 🛠 Gelişmiş Sunucu Yönetimi
+- **Multi-Version PHP**: PHP 5.6'dan 8.x'e kadar farklı versiyonları tek tıkla kurun ve projenize özel atayın.
+- **Güçlü Nginx Yapılandırması**: Framework uyumlu, "Holy Grail" Nginx Alias şablonu ile `/monofiber/login` gibi alt rotalar sorunsuz çalışır.
+- **Hızlı MySQL İşlemleri**: Veritabanı yedeklerini (`.sql`, `.sql.gz`, `.zip`) sürükle-bırak mantığıyla içe aktarın (Import) veya dışa aktarın (Dump).
+
+### 🎨 Pro-UX Arayüzü
+- **Akıllı Nginx Hata Yönetimi**: Nginx ayarlarınızda bir hata olduğunda, uygulama hatayı analiz eder ve sizi doğrudan hatanın bulunduğu dosya ve satıra yönlendirir (**Düzeltmeye Git**).
+- **Gelişmiş Kod Editörü**: Nginx ve PHP yapılandırma dosyalarını, **PrismJS** destekli syntax-highlighting ile uygulama içinden düzenleyin.
+- **Kalıcı Ayar Koruması**: Manuel düzenlediğiniz Nginx ayarları, uygulama tarafından asla üzerine yazılmaz (`# MANUAL_EDIT` koruması).
+
+### 📦 Entegre Araçlar
+- **PhpMyAdmin**: Tek tıklamayla veritabanı yönetimine erişim.
+- **Log Görüntüleyici**: Nginx, PHP ve MySQL loglarını gerçek zamanlı olarak takip edin.
+- **Taşınabilir Mimari**: Proje klasörünü istediğiniz yere taşıyın; tüm yollar (`alias`, `root`, vb.) dinamik olarak kendini günceller.
+
+## 💻 Kurulum ve Geliştirme
+
+Projeyi yerel ortamınızda çalıştırmak için:
+
+```bash
+# Bağımlılıkları yükleyin
+npm install
+
+# Geliştirme modunda başlatın
+npm run dev
+
+# Uygulamayı paketleyin (Windows)
+npm run build:win
+```
+
+## 📂 Dosya Yapısı
+
+- `bin/`: PHP, Nginx ve MySQL binary dosyalarının bulunduğu dizin.
+- `config/`: Sunucu yapılandırma şablonları (`.template`).
+- `generated_configs/`: Çalışma anında üretilen dinamik konfigürasyonlar.
+- `src/main/`: Electron ana süreç (IPC, Servis Yönetimi) kodları.
+- `src/renderer/`: React tabanlı modern kullanıcı arayüzü.
+
+## 🛠 Kullanılan Teknolojiler
+
+- **Core**: Electron, Vite
+- **UI**: React, Material UI (MUI)
+- **Editor**: PrismJS, React Simple Code Editor
+- **Notifications**: SweetAlert2
+- **Utilities**: Axios, i18next (Çoklu Dil Desteği)
+
+## 🤝 Katkıda Bulunanlar
+
+- **Geliştirici**: Trunçgil
+- **Vizyon**: Hızlı, modern ve sorunsuz bir Windows yerel sunucu deneyimi.
+
+---
+*Bu proje, geliştirici deneyimini (DX) en üst düzeye çıkarmak için tasarlanmıştır.*