Kurulum
PHP 8.1 ortamını hazırlayın, ilk projeyi üretin ve alan adı eşlemesini yapın.
KUT Framework, çekirdek ve gerekli bağımlılıklarıyla tek bir uygulama tabanı olarak çalışır. Framework kökünü ve System/Vendor dizinini birlikte yayınlayın.
Gereksinimler
- PHP 8.1 veya üzeri
mbstring,json,opensslve uygulamanızın kullandığı veritabanı eklentisi- Apache için
mod_rewriteveAllowOverride All - Konsol komutları için PHP CLI
İlk projeyi oluşturma
cd /proje/dizini/KUT
php buyruk project:create Blog
Komut, güncel varsayılan proje şablonunu Projects/Blog altına çıkarır ve projeye özgü anahtarı üretir.
Projeyi alan adına bağlama
Settings/Projects.php içindeki proje ayarını düzenleyin:
'directory' =>
[
'default' => Kut\Base::project('Blog'),
'others' =>
[
'blog.example.com' => 'Blog'
]
]
Yazma izinleri
Web sunucusu, çalıştırılan projedeki Storage/ dizinine yazabilmelidir. Rendering önbelleği Storage/Renders altında otomatik üretilir.
Canlı ortam: Uygulamayı yüklerken
System/Vendor dizinini unutmayın. Bağımlılıkların eksik olması framework daha controller’a ulaşmadan hataya neden olur.Üçüncü taraf bağımlılık ekleme
KUT iki ayrı autoloader yükler ve bu ikisi karıştırılmamalıdır:
| Autoloader | Kapsam | Bakım |
|---|---|---|
System/Loader/* | Yalnız KUT paketleri (System/Packages, Common, Projects) | Elle. autoload_psr4.php + autoload_static.php birlikte güncellenir; composer dump-autoload bu haritaları üretmez, siler. |
System/Vendor/autoload.php | Üçüncü taraf Composer bağımlılıkları (ör. dompdf, Google, iyzico) | Otomatik. Standart Composer vendor autoloader'ıdır; composer require ile kendiliğinden güncellenir. |
Yeni bir üçüncü taraf kütüphane eklemek yalnızca şudur — elle harita düzenlemesi yoktur:
composer require dompdf/dompdf
Ayrım: §2.4'teki “
composer dump-autoload çalıştırmayın” kuralı yalnız System/Loader altındaki elle bakımlı KUT paket haritalarını korur. Üçüncü taraf bağımlılıkların System/Vendor altındaki autoload üretimi bu kuralın dışındadır ve normal Composer akışıyla çalışır.Dağıtımda üçüncü taraf paket eklerken hem
System/Vendor/<paket> dizinlerini hem yeniden üretilen System/Vendor/composer/autoload_*.php dosyalarını (ve composer.json/lock) birlikte yükleyin; eksik biri “class not found” üretir.Kurulumu doğrulama
php -v
php buyruk
php buyruk --project=Blog render:compile