docs: add README.md for project documentation
This commit is contained in:
@@ -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.*
|
||||||
Reference in New Issue
Block a user