Laravel uygulaması

Coduva yeni bir Laravel projesini Composer ile kurar, .env dosyasını MariaDB'ye bağlar ve ilk migration'ı çalıştırır. Günlük işler (Artisan komutları, kuyruk, zamanlayıcı, Vite) proje sayfasından yapılır.

Yeni Laravel projesi

1. Projeler → Yeni proje düğmesine tıklayın (veya Ctrl+K → Yeni proje oluştur).
2. Şablon olarak Laravel seçin.
3. Proje adı girin, ör. panel. Adres panel.test olur.
4. Konum satırında projenin klasörü yazar (C:\Coduva\www\panel). Başka bir üst klasör için Değiştir düğmesini kullanın.
5. İsterseniz PHP sürümü seçin ve HTTPS kullan kutusunu işaretleyin.
6. Oluştur düğmesine tıklayın.

İnternet gerekir

Laravel paketleri Composer ile internetten indirilir. Bağlantı hızına göre kurulum birkaç dakika sürebilir. İlerleme canlı olarak görünür.

Kurulum şu adımlardan oluşur:

1. composer create-project laravel/laravel panel komutu çalışır.
2. Projeye özel bir veritabanı oluşturulur. Adı proje adından gelir; tireler alt çizgiye çevrilir.
3. .env dosyası MariaDB'ye bağlanacak şekilde güncellenir.
4. php artisan migrate --force çalışır ve tablolar oluşturulur.

Kurulum başarısız olursa Coduva bu işlemde oluşturduğu klasörü ve veritabanını geri alır.

Composer "Permission denied" hatası

Windows'ta virüs taraması, Composer'ın yeni yazdığı geçici dosyaları kilitleyebilir. Coduva bu durumda kurulumu kendiliğinden bir kez daha dener. Sorun sürerse Sorun giderme sayfasındaki Defender önerisine bakın.

.env ayarları

Coduva .env dosyasında şu değerleri ayarlar:

APP_URL=http://panel.test
DB_CONNECTION=mariadb
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=panel
DB_USERNAME=root
DB_PASSWORD=

HTTPS açıksa APP_URL https:// ile başlar. Web sunucusu veya MariaDB varsayılan dışında bir portta çalışıyorsa adres ve port buna göre yazılır.

Laravel'in web kökü public klasörüdür; Coduva bunu kendisi ayarlar.

Artisan komutları

Proje sayfasını açın (Projeler ekranında projenin kartına tıklayın; sol menüdeki Laravel araçları yalnızca Laravel projelerini listeler) ve Araçlar sekmesine geçin. Hızlı komutlar kartında sık kullanılan Artisan komutları düğme olarak durur; çıktı kartın altında canlı görünür:

Düğme	Ne zaman
artisan migrate	Yeni migration ekledikten sonra
artisan optimize:clear	Önbellek, yapılandırma, rota ve görünüm önbelleklerini temizlemek için
artisan key:generate	.env içinde APP_KEY yoksa
artisan storage:link	public/storage bağlantısını oluşturmak için
artisan route:list	Tanımlı rotaları görmek için
artisan about	Uygulama ve ortam özeti için

Başka bir komut için Komutlar sekmesine geçin. Araç olarak artisan seçin, komutu yazın (ör. make:model Post -m) ve Çalıştır düğmesine tıklayın. Aynı sekmede composer ve npm araçları da vardır; hızlı komut satırında Artisan düğmelerinin yanında composer install, composer dump-autoload, npm install ve npm run build bulunur.

Komutlar projenin PHP sürümüyle çalışır. Çıktı canlı görünür ve bitince çıkış kodu yazar.

Süreçler

Süreçler sekmesinde uzun süre çalışan üç süreci başlatıp durdurabilirsiniz:

Süreç	Komut
Kuyruk işçisi	php artisan queue:work
Zamanlayıcı	php artisan schedule:work
Vite geliştirme sunucusu	npm run dev

Her süreç için durum (Çalışıyor ve ne kadar süredir çalıştığı, Durdu veya Kapandı ve çıkış kodu) görünür. Günlükler düğmesi sürecin çıktısını açar. Aynı üç süreci Araçlar sekmesindeki Süreçler kartından da başlatıp durdurabilirsiniz. Projeler ekranında, süreci çalışan projenin kartında kaç sürecin çalıştığı yazar.

Süreçler Coduva'ya bağlıdır

Süreçler Coduva açıkken çalışır. Pencereyi kapatmak onları durdurmaz, çünkü Coduva tepside çalışmaya devam eder. Coduva'dan tamamen çıktığınızda ise proje süreçleri durdurulur.

Vite için Node.js gerekir. Coduva'nın Node'u kurulu değilse sistemdeki Node kullanılır. Bkz. Terminal, Composer ve Node.js.

Günlükler

Günlükler sekmesinde şu kaynakları seçebilirsiniz:

• Nginx hata günlüğü — bu projenin web sunucusu hataları
• Uygulama günlüğü — storage/logs/laravel.log
• Çalışan veya çalışmış süreçlerin çıktıları

Sekme açıkken günlük birkaç saniyede bir kendiliğinden yenilenir; Yenile düğmesi hemen yeniden okur. Dosyanın tam yolu günlüğün üstünde yazar.

Sık karşılaşılan hatalar

Hata	Çözüm
No application encryption key has been specified	Araçlar → artisan key:generate
SQLSTATE[HY000] [2002]	MariaDB çalışmıyor; Kontrol merkezinden başlatın. .env içindeki DB_PORT değerini kontrol edin
SQLSTATE[HY000] [1049]	Veritabanı yok; DB_DATABASE değerini kontrol edin veya Veritabanı ekranından oluşturun
Class "..." not found	Komutlar → composer install veya composer dump-autoload

Coduva bu hataları günlüklerde kendisi de tanır. Bkz. Hata teşhisi kuralları.

Başlangıç kitleri (0.3.0)

Coduva 0.3.0 ile Yeni proje penceresinde Laravel'i seçtiğinizde Başlangıç kiti alanı görünür. Laravel'in resmî kitlerinden birini seçebilirsiniz: React, Vue ya da Livewire. Kitlerde oturum açma, kayıt ve panel sayfaları hazır gelir.

Kit seçtiğinizde Coduva, Laravel'i kurduktan sonra ön yüzü de hazırlar (npm install ve npm run build). Bunun için Node.js gerekir; kurulu değilse PHP ve Node ekranından kurun. Node.js yoksa proje yine oluşturulur, ancak sayfalar ön yüz derlenene kadar hata verir; kurulum günlüğü ne yapmanız gerektiğini yazar.

Geliştirirken değişikliklerin anında görünmesi için proje sayfasının Süreçler sekmesinden Vite'ı başlatın.

Sonraki adım: Projeye özel PHP sürümü seçmek için PHP sürümleri ve ayarları.