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 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)
+39
View File
@@ -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)
+43
View File
@@ -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)
+42
View File
@@ -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)
+43
View File
@@ -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)
+45
View File
@@ -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)
+46
View File
@@ -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.
+40
View File
@@ -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)