Ekranlar

Bu sayfa önce Coduva penceresinin ortak parçalarını, sonra kenar çubuğundaki her ekranı anlatır. Arayüz Türkçe ve İngilizcedir; dil Ayarlar ekranından, durum çubuğundaki dil düğmesinden veya komut paletinden değişir.

Pencere düzeni

Coduva penceresi Windows'un standart çerçevesini kullanmaz. Pencerede yukarıdan aşağıya başlık çubuğu, solda kenar çubuğu, sağda seçili ekran ve en altta durum çubuğu bulunur. Durum bilgisi her 5 saniyede bir yenilenir.

Başlık çubuğu

• Solda: Coduva logosu, adı ve sürümü (ör. v0.2.0).
• Ortada: Ara veya komut çalıştır… kutusu. Tıklayınca komut paleti açılır; kısayolu Ctrl+K'dir.
• Sağda: küçült, ekranı kapla / önceki boyut ve kapat düğmeleri.

Pencere başlık çubuğundan tutularak taşınır. Kapat düğmesi Coduva'yı kapatmaz; düğmenin ipucunda da yazdığı gibi Coduva arka planda çalışmaya devam eder. Bkz. Sistem tepsisi.

Kenar çubuğu

Ekranlar dört grupta toplanır:

Grup	Ekranlar
Genel	Kontrol merkezi, Projeler (yanında proje sayısı)
Geliştirme	PHP ve Node, Veritabanı, WordPress araçları, Laravel araçları, Geliştirici araçları
Ağ ve güvenlik	Yerel adresler, Yerel HTTPS
Sistem	Hata teşhisi, Ayarlar

Kenar çubuğunun altındaki Servisler bölümünde Nginx ve MariaDB satırları her zaman görünür. Her satırda durum noktası, port ve bir güç düğmesi vardır:

Nokta	Anlamı
Yeşil	Çalışıyor
Gri	Durdu
Kırmızı	Port dolu veya engelli
Boş halka	Kurulu değil

Güç düğmesi servis çalışıyorsa durdurur, durmuşsa başlatır. Servis kurulu değilse, portu doluysa veya başka bir işlem sürüyorsa düğme devre dışıdır.

Durum çubuğu

Pencerenin en altındaki ince çubuk. Öğelerine tıklanınca ilgili ekran açılır.

Öğe	Gösterdiği	Tıklayınca
Genel durum	Tüm servisler çalışıyor, Bazı servisler durdu, Servisler durdu, Port çakışması veya Bileşenler kurulu değil	Kontrol merkezi
Nginx :80	Web sunucusunun portu	Kontrol merkezi
MariaDB :3306	Veritabanının portu	Veritabanı
PHP 8.4	Varsayılan PHP sürümü	PHP ve Node
Güncelleme: <sürüm>	Yalnızca yeni bir Coduva sürümü bulunduysa	Ayarlar › Güncellemeler
<n> proje	Proje sayısı	Projeler
TR / EN	Arayüz dili	Dili değiştirir
Coduva <sürüm>	Kurulu sürüm	—

Komut paleti

Ctrl+K ile veya başlık çubuğundaki arama kutusuna tıklanarak açılır. Arama kutusunda Sayfa, proje veya eylem ara… yazar. Sonuçlar üç grupta listelenir:

• Eylemler: Yeni proje oluştur, Klasörü proje olarak ekle, Tüm servisleri başlat, Tüm servisleri durdur, Tüm servisleri yeniden başlat, localhost'u tarayıcıda aç, phpMyAdmin'i aç, Coduva terminalini aç, Sağlık raporu oluştur ve Dili değiştir: English.
• Projeler: Her proje, adresiyle birlikte. Seçilen projenin ayrıntı ekranı açılır.
• Sayfalar: Kenar çubuğundaki bütün ekranlar, kısa açıklamalarıyla.

Arama büyük/küçük harfe ve Türkçe karakterlere duyarlı değildir: yerel https ile YEREL HTTPS aynı sonucu verir. Birden çok kelime yazılırsa hepsini içeren sonuçlar kalır.

Tuş	İşlev
↑ / ↓	Sonuçlar arasında gezinir
Enter	Seçili sonucu açar veya eylemi çalıştırır
Esc	Paleti kapatır (Ctrl+K da kapatır)

Bildirim balonları

İşlemlerin sonucu pencerenin sağ alt köşesinde kısa bir balonla bildirilir. Örnekler: Servisler başlatıldı, magaza.test hazır, Panoya kopyalandı. Bir işlem başarısız olursa İşlem tamamlanamadı başlığıyla nedeni yazar. Balonlar kendiliğinden kaybolur; çarpı düğmesiyle de kapatılabilir.

Arka plan denetimi yeni bir sürüm bulduğunda Coduva <sürüm> yayınlandı balonu görünür: "Ayarlar › Güncellemeler bölümünden yükleyebilirsiniz." Bkz. Coduva'yı güncel tutmak.

Kontrol merkezi

Açılışta gösterilen ekran: web sunucusu ve veritabanının durumu. Ekranın üstünde yenileme düğmesi, Tümünü durdur ve Tümünü başlat düğmeleri bulunur.

Bildirimler. Gerektiğinde ekranın üstünde gösterilir:

• Coduva arka planda çalışır: Pencereyi kapatınca Coduva'nın ve servislerin kapanmadığını, tepsi menülerinin ne işe yaradığını anlatır. Anladım ile bir kez kapatılır.
• Başka bir yerel sunucu algılandı: Yalnızca WampServer, XAMPP veya Laragon çalışıyorsa gösterilir; 80 ve 3306 portlarında çakışma olabileceğini hatırlatır. Coduva bu programlara dokunmaz.
• Bileşen dizini ASCII dışı karakter içeriyorsa uyarı.

Bileşenler kurulu değil. İlk açılışta indirilecek bileşenlerin listesi, her birinin boyutu ve Toplam indirme ile birlikte Bileşenleri kur düğmesi gösterilir. Kurulum sırasında her satırın kendi ilerleme çubuğu ve aşaması olur: İndiriliyor, Doğrulanıyor, Açılıyor, Kuruldu (veya Başarısız). Bkz. Kurulum.

Genel durum şeridi. Ortamın tek cümlelik özeti:

Başlık	Ne zaman
Her şey yolunda	Web sunucusu ve veritabanı çalışıyor
Bazı servisler durdu	Servislerden biri çalışmıyor
Servisler durdu	Hiçbir servis çalışmıyor
Port çakışması var	Bir port başka bir program tarafından kullanılıyor
Kuruluma hazır	Bileşenler henüz kurulmadı

Şeridin sağında localhost, phpMyAdmin ve Terminal düğmeleri vardır. localhost servislerden biri çalışırken, phpMyAdmin ikisi birden çalışırken etkindir.

Göstergeler. Dört kutu:

Gösterge	Değer	Alt satır
Projeler	Proje sayısı	WordPress 1 · Laravel 1 · PHP 1 gibi tür dağılımı
Bellek kullanımı	Nginx, PHP ve MariaDB süreçlerinin toplam belleği	Süreç sayısı
Çalışma süresi	En uzun süredir çalışan servisin süresi	Genel durum
PHP sürümleri	Kurulu PHP sürümü sayısı	Varsayılan sürüm

Servis kartları. Nginx (Web sunucusu · PHP FastCGI) ve MariaDB (Veritabanı). Her kartta:

• Servisin adı, sürümü ve durum rozeti: Kurulu değil, Durdu, Çalışıyor, Port dolu, Port engelli.
• Ölçüm satırı: Port, HTTPS (yalnızca Nginx), Bellek, Süre.
• Nginx kartında varsayılan PHP sürümünün havuzu: "PHP 8.4 · FastCGI süreçleri" ve havuzdaki dört sürecin her biri için bir çubuk, yanında çalışan süreç sayısı (ör. 4/4).
• Port doluysa portu kimin tuttuğu: Windows HTTP sunucusu (http.sys, IIS), WampServer, XAMPP, Laragon veya başka bir program (adı ve PID'i ile). HTTPS portu da doluysa ayrıca uyarılır. Bkz. Portlar.
• Düğmeler: servis çalışıyorsa Durdur, Yeniden başlat ve Nginx kartında localhost, MariaDB kartında phpMyAdmin. Servis durmuşsa Başlat; başlatılamayacak durumdaysa nedeni yazar ("Başlatmak için önce bileşenleri kurun." veya "Başlatmak için portu boşaltın veya Ayarlar'dan başka bir port seçin.").

Başlatma, durdurma veya yeniden başlatma sırasında bir hata olursa nedeni (ör. servis günlüğünün son satırları) sağ alttaki İşlem tamamlanamadı bildiriminde gösterilir; olay Etkinlik akışına da düşer.

Son projeler. En son eklenen beş proje: adı, adresi, PHP sürümü, HTTPS kilidi ve tarayıcıda açma düğmesi. Tümünü gör Projeler ekranını açar. Henüz proje yoksa Yeni proje düğmesi gösterilir.

Etkinlik. Son 12 olay (servis başlatma, proje ekleme, bileşen kurulumu, güncelleme bulunması vb.), renkli bir noktayla (bilgi, uyarı, hata) ve "az önce", "5 dk" gibi göreli zamanla. Tam kayıt Ayarlar ekranındadır.

Projeler

Yerel sitelerin listesi. Ekranın üstünde Klasör ekle ve Yeni proje düğmeleri bulunur.

Araç çubuğu:

• Projelerde ara…: proje adında, adresinde ve klasör yolunda arar.
• Tür filtresi: Tümü, WordPress, Laravel, PHP; her birinin yanında proje sayısı.
• Izgara görünümü / Liste görünümü. Seçim hatırlanır.

Izgara görünümünde her kartta proje adı, adresi (tıklayınca tarayıcıda açılır) ve kart menüsü (⋯) bulunur. Kartın altında tür rozeti (PHP, WordPress, Laravel), PHP sürümü, HTTPS açıksa HTTPS, bağlı veritabanının adı ve çalışan proje süreci sayısı yer alır. Karta tıklamak proje ayrıntısını açar.

Liste görünümü sütunları: Proje, Tür, Adres, PHP, Konum ve kart menüsü.

Kart menüsü: Siteyi aç, Klasör, Editör, Terminal, Adresi kopyala, Ayrıntılar.

• Yeni proje: Şablon seçilir (Boş PHP, WordPress, Laravel), ardından Proje adı, Konum, PHP sürümü ve HTTPS kullan ayarlanır. Kurulumun her adımı canlı olarak gösterilir. Bitince Siteyi aç düğmesi çıkar. WordPress için WordPress yönetici hesabı (kullanıcı ve parola) yalnızca bu ekranda bir kez gösterilir.
• Klasör ekle: Var olan bir klasör seçilir; Algılanan tür ve Web kökü gösterilir, proje adı klasör adından önerilir. Eklenince "<ad>.test hazır" bildirimi görünür.

Proje klasörü silinmiş veya taşınmışsa kartta Proje klasörü bulunamadı yazar. Henüz proje yoksa ekranda İlk projenizi oluşturun başlığıyla iki düğme gösterilir. Kurallar ve algılama mantığı: Proje türleri.

Proje ayrıntısı

Bir projeye tıklandığında ayrıntı ekranı açılır. Üstte Projeler › <ad> yolu, projenin adı, adresi (yanında kopyalama düğmesi), tür, PHP, HTTPS ve veritabanı rozetleri ile Klasör, Editör, Terminal ve Siteyi aç düğmeleri bulunur. Altında sekmeler yer alır:

Sekme	İçerik
Genel	PHP sürümü ve Node.js sürümü seçimi, HTTPS kullan anahtarı, Proje klasörü, Web kökü (Değiştir), bağlı Veritabanı, Projeyi kaldır
Araçlar	Yalnızca WordPress ve Laravel projelerinde. WordPress ve Laravel araçları (aşağıda)
Komutlar	Serbest komut alanı (wp, artisan, composer, npm) ve Hızlı komutlar; çıktı canlı akar, sonunda Çıkış kodu yazar
Süreçler	Uzun süre çalışan proje süreçleri: Vite geliştirme sunucusu (npm run dev); Laravel'de ayrıca Kuyruk işçisi (queue:work) ve Zamanlayıcı (schedule:work)
Günlükler	Nginx hata günlüğü, Uygulama günlüğü (wp-content\debug.log veya storage\logs\laravel.log) ve süreç günlükleri

Node.js sürümü varsayılan olarak Otomatik (.nvmrc / en yeni) seçilidir: projede .nvmrc veya package.json içinde engines.node varsa ona uyan sürüm, yoksa kurulu en yeni sürüm kullanılır.

Hızlı komutlar proje türüne göre değişir:

Tür	Hızlı komutlar
Laravel	artisan migrate, optimize:clear, key:generate, storage:link, route:list, about
WordPress	wp plugin list, theme list, cache flush, core version, core update
Tümü	composer install, composer dump-autoload, npm install, npm run build

Süreçler Coduva açıkken çalışır; Coduva'dan çıkınca durdurulur. Projeyi kaldır projeyi Coduva'dan çıkarır, dosyalara ve veritabanına dokunmaz.

PHP ve Node

Çalışma zamanlarının yönetimi.

• PHP sürümleri ve Node.js sürümleri tabloları: Sürüm, Durum (Kurulu, Kurulu değil, Varsayılan, Desteklenmiyor), Kullanan projeler. Satırlarda Kur, Kaldır ve Varsayılan yap düğmeleri bulunur.
• PHP ayarları (tüm PHP sürümleri için geçerli):

Ayar	php.ini anahtarı	Varsayılan
Bellek sınırı	memory_limit	512M
Yükleme boyutu	upload_max_filesize (ve post_max_size)	128M
Çalışma süresi, saniye	max_execution_time	300
Saat dilimi	date.timezone	Europe/Istanbul
Hataları sayfada göster	display_errors	Açık

Boyutlar 512M, 1G veya sınırsız için -1 biçiminde yazılır; çalışma süresi 1–3600 saniye arasındadır.

• Eklentiler: Seçili PHP sürümünün ext klasöründe bulunan eklentiler listelenir; işaretliler yüklenir. Varsayılan açık eklentiler: bz2, curl, exif, fileinfo, gd, gettext, intl, mbstring, mysqli, openssl, pdo_mysql, pdo_sqlite, sodium, sqlite3, zip. OPcache her zaman açıktır.

Kaydedince çalışan PHP süreçleri yeni ayarlarla yeniden başlar. Node.js kurulu değilse proje terminalinde ve npm komutlarında sistemdeki Node kullanılır.

Yerel adresler

Projelerin .test adresleri ve hosts dosyasının durumu.

• Durum kartı: hosts dosyası güncel. veya hosts dosyası projelerle eşleşmiyor. Altında hosts dosyasının yolu ve kopyalama düğmesi bulunur.
• hosts dosyasını eşitle (ekranın üstünde): Eksik satırları ekler, artık olanları kaldırır. Windows yönetici izni ister (UAC). Değişiklik gerekmiyorsa izin istenmez ve Değişiklik gerekmiyordu. yazar.
• Liste: Her projenin adresi (tıklayınca tarayıcıda açılır), adı ve hosts satırı (127.0.0.1 magaza.test), yanında hosts'ta var veya hosts'ta yok rozeti. Başlıkta kaç adresin hosts dosyasında olduğu yazar (ör. 3/3).

.test uzantısı yerel kullanım için ayrılmıştır (RFC 6761) ve gerçek bir alan adıyla çakışmaz. Coduva yalnızca .test adresleri üretir.

Yerel HTTPS

Coduva'ya özel yerel sertifika otoritesi (CA) ve proje sertifikaları.

• Coduva yerel sertifika otoritesi: Durum (Windows tarafından güvenilir veya Güvenilir değil: tarayıcı uyarı gösterir) ve Parmak izi (SHA-1), yanında kopyalama düğmesi. CA henüz yoksa bir projede HTTPS açıldığında oluşturulur.
• Güvenilir yap: CA'yı Windows'un kullanıcı kök sertifika deposuna ekler. Windows bir güvenlik onayı penceresi gösterir; yönetici izni gerekmez.
• Güvenilenlerden kaldır: CA'yı depodan çıkarır.
• Projeler: Bütün projeler, her birinin yanında HTTPS anahtarıyla. Anahtar açılınca proje sertifikası üretilir ve adres https:// olur. Başlıkta kaç projede HTTPS'in açık olduğu yazar (ör. 2/3 HTTPS).

Firefox kendi sertifika deposunu kullanabilir; uyarı görürseniz Firefox'ta about:config → security.enterprise_roots.enabled = true yapın. Ayrıntılar: Güvenlik ve gizlilik.

Veritabanı

MariaDB veritabanları. MariaDB çalışmıyorsa MariaDB çalışmıyor. yazar ve MariaDB'yi başlat düğmesi gösterilir.

• Tablo: Ad, Boyut, Tablo sayısı, bağlı Proje. Sistem veritabanları (mysql, information_schema, performance_schema, sys) listelenmez.
• Veritabanı oluştur: Ad harf, rakam ve alt çizgiden oluşur (en fazla 64 karakter).
• Dışa aktar: C:\Coduva\backups\db\<ad>-<zaman>.sql dosyasına yazar.
• İçe aktar: Bir .sql dosyası seçilir; veritabanı yoksa oluşturulur.
• Sil: Geri alınamaz; onay için veritabanı adının aynen yazılması gerekir.
• phpMyAdmin ve Yedek klasörü düğmeleri.

Ekranın altında bağlantı bilgisi yazar: 127.0.0.1:<port>, kullanıcı root, parola boş. Bkz. MariaDB ve phpMyAdmin.

WordPress araçları

Projeler ekranının yalnızca WordPress projelerini gösteren hâlidir: arama, ızgara/liste görünümü ve kart menüsü aynıdır, tür filtresi yoktur. Bir projeye tıklayınca ayrıntı ekranı açılır; araçlar Araçlar sekmesindedir:

• Hata ayıklama (WP_DEBUG): Açıkken hatalar wp-content\debug.log dosyasına yazılır, sayfada gösterilmez.
• Yönetici olarak giriş yap: Tek kullanımlık, 2 dakika geçerli bir giriş bağlantısı tarayıcıda açılır.
• Adres değiştir (ara-değiştir): Veritabanında Eski metin yerine Yeni metin yazar; serileştirilmiş veriler korunur. Önce Dene (değiştirme) ile kaç değişiklik olacağı görülür, sonra Uygula.

WP-CLI komutları Komutlar sekmesinden çalıştırılır. Henüz WordPress projesi yoksa İlk projenizi oluşturun başlığının altında "Bu türde proje yok." yazar; Klasör ekle ve Yeni proje düğmeleri gösterilir.

Laravel araçları

Projeler ekranının yalnızca Laravel projelerini gösteren hâlidir. Bir projeye tıklayınca ayrıntı ekranı açılır. Araçlar sekmesinde Artisan için Hızlı komutlar ve proje süreçleri bulunur:

• Kuyruk işçisi (queue:work)
• Zamanlayıcı (schedule:work)
• Vite geliştirme sunucusu (npm run dev)

Her süreç Başlat / Durdur ile yönetilir; çalışma süresi ve çıkış kodu gösterilir, günlüğü Günlükler sekmesinde izlenir. Serbest Artisan komutları Komutlar sekmesinden çalışır.

Geliştirici araçları

• Coduva terminali → Terminali aç: PHP, Composer, WP-CLI ve Node, Coduva'nın sürümleriyle PATH'te hazır olarak açılır. Bir projeden açılan terminal o projenin PHP ve Node sürümünü kullanır.
• Projeler: Her proje için Editör, Terminal ve Klasör düğmeleri.
• Sistemdeki araçlar: Git, Node.js, npm, Composer, WP-CLI, CodVS ve Visual Studio Code için bulunduğu yol veya Bulunamadı; başlıkta kaçının bulunduğu yazar (ör. 5/7).

Editör düğmesi projeyi önce CodVS ile açar. CodVS kurulu değilse Visual Studio Code (PATH'teki code komutu), o da yoksa Dosya Gezgini kullanılır. Terminal ortamının ayrıntıları: Dizinler ve dosyalar.

Hata teşhisi

Ortam kontrolleri ve günlük çözümlemesi. Ekran açılınca kontroller kendiliğinden çalışır; üstteki Kontrolleri çalıştır düğmesi yeniden çalıştırır, Sağlık raporu oluştur sonuçları dosyaya kaydeder.

• Özet: Sorun yoksa Ortam sağlıklı ("<n> kontrolün tamamı sorunsuz geçti."), varsa Dikkat gerektiren <n> konu var ("<ok>/<toplam> kontrol sorunsuz. Önerilen düzeltmeler aşağıda."). Yanında Son çalıştırma saati, altında düzeylere göre renkli bir dağılım çubuğu ve dört sayaç: Sorun yok, Bilgi, Uyarı, Hata.
• Kontroller: Visual C++, bileşenler, PHP komut satırı, portlar, hosts, CA, diğer yerel sunucular, disk ve Windows Defender. Sorunlu kontroller listenin başında gösterilir. Her satırda kontrolün adı, düzeyi, sorunun açıklaması ve ayrıntısı (port ve süreç adı, eksik adresler gibi) yazar.
• Düzeltme düğmeleri: Sorunlu kontrollerde sunulur: Bileşenleri kur, hosts dosyasını eşitle, Güvenilir yap, Portları değiştir, Visual C++ indir.
• Günlük bulguları: Kuralın başlığı, kaç kez görüldüğü, açıklaması, önerilen çözüm, eşleşen son satır ve günlük dosyasının yolu. Bulgu yoksa Günlüklerde bilinen bir hata kalıbı bulunmadı.
• Sağlık raporu oluştur: Sonuçları Markdown dosyası olarak %APPDATA%\Coduva\reports klasörüne kaydeder.

Kontrollerin, düzeltmelerin ve kuralların tamamı: Hata teşhisi kuralları.

Ayarlar

Kenar çubuğunun Sistem grubundadır. Yukarıdan aşağıya:

• Uygulama kartı: Coduva, sürüm (ör. v0.2.0), Kararlı kanal rozeti ve coduva.dev düğmesi.
• Güncellemeler: Durum (Coduva güncel veya Coduva <sürüm> hazır), Güncellemeleri denetle veya Yükle ve yeniden başlat düğmesi, varsa Sürüm notları; altında Kurulu sürüm, Kanal ve Son denetim, en altta Güncellemeleri otomatik denetle anahtarı. Ayrıntılar: Coduva'yı güncel tutmak.
• Genel:
  • Arayüz dili: Türkçe / English. Arayüz hemen değişir; tepsi menüsü yeni dile Coduva yeniden açıldığında geçer.
  • Windows açılışında başlat: Açıksa Coduva oturum açıldığında pencere göstermeden sistem tepsisinde başlar.
• Ağ: Nginx HTTP portu ve MariaDB portu, her biri Kaydet düğmesiyle. Servis çalışıyorsa satırda Çalışıyor rozeti ve "Servis çalışıyor; değiştirmek için önce durdurun." yazar. Bkz. Portlar.
• Depolama: Bileşen dizini, Uygulama verisi, Ayar veritabanı (yanında şema sürümü) ve Servis günlükleri; her birinin yolu, Yolu kopyala ve Klasörü aç düğmeleri. Henüz oluşmamış klasörlerde Henüz oluşturulmadı yazar.
• Son olaylar: Servis başlatma/durdurma, port değişikliği, proje ekleme, bileşen kurulumu, güncelleme gibi olayların kaydı. Kayıtlardaki parola ve jeton değerleri maskelenir.