KUT 1.0’da desteklenir

Kurulum

PHP 8.1 ortamını hazırlayın, ilk projeyi üretin ve alan adı eşlemesini yapın.

2 dk okumaSon kontrol: KUT 1.0

This article is currently available in Turkish. Its English translation is being prepared.

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, openssl ve uygulamanızın kullandığı veritabanı eklentisi
Apache için mod_rewrite ve AllowOverride 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