Paket Geliştirme

Paketler çekirdeğe doğrudan dosya kopyalamamalı; kendi klasörü, hook sistemi, storage alanı ve izin sistemi üzerinden çalışmalıdır.

install.php, update.php ve uninstall.php dosyaları resmi paketlerde önerilir.

Paketler packages/ klasörü altında veya zip yükleme sistemiyle kurulur. Paketler Omurga'ya ek özellik kazandırır.

Örnek yapı:
packages/ornek-paket/
- package.json
- package.php
- admin.php
- install.php
- update.php
- uninstall.php
- assets/
- views/

Temel dosyalar:
- package.json: paket kimliği ve uyumluluk bilgisi
- package.php: paketin ana çalışma dosyası
- admin.php: yönetim paneli sayfası varsa kullanılır
- install.php: ilk kurulum işlemleri
- update.php: sürüm güncelleme işlemleri
- uninstall.php: kaldırma işlemleri

Paket çekirdeği değiştirmemelidir. Özellikler hook, route, admin page, storage ve API mantığıyla eklenmelidir.

package.json paketin kimlik ve uyumluluk dosyasıdır.

Temel alanlar:
- name: Paket adı
- slug: Paket klasör adı
- version: Paket sürümü
- description: Açıklama
- author: Geliştirici
- min_php: Minimum PHP sürümü
- min_omurga: Minimum Omurga sürümü
- main: Ana dosya
- permissions: Paket izinleri
- admin_pages: Yönetim paneli sayfaları

Örnek:
{
"name": "Örnek Paket",
"slug": "ornek-paket",
"version": "1.0.0",
"min_php": "8.1",
"min_omurga": "1.1.0-beta",
"main": "package.php"
}

İzinler:
Paket ihtiyacı olmayan izinleri talep etmemelidir. Örneğin sadece katalog verisi okuyacak bir paket database yazma izni istememelidir.

Sürüm uyumluluğu:
min_omurga değeri yanlış düşük yazılırsa eski çekirdekte hata çıkarabilir. Yanlış yüksek yazılırsa gereksiz uyumsuz görünür.

Paket geliştirirken temel güvenlik kuralları:
- Kullanıcı girdileri doğrulanmalı ve temizlenmelidir.
- Admin işlemlerinde yetki kontrolü yapılmalıdır.
- CSRF koruması kullanılmalıdır.
- Dosya yükleme işlemleri güvenli olmalıdır.
- Zip dosyalarında path traversal kontrolü yapılmalıdır.
- Çekirdek, admin ve install dosyalarına izinsiz yazılmamalıdır.
- eval, shell_exec, system, passthru gibi riskli fonksiyonlardan kaçınılmalıdır.
- Harici URL'den kod indirip çalıştırılmamalıdır.

Storage kullanımı:
Paket verileri mümkünse kendi storage alt dizininde tutulmalıdır. Örnek: storage/omurga-merkez/

Kaldırma davranışı:
uninstall.php kullanıcı verilerini doğrudan silmemelidir. Silme opsiyonel olmalı veya yedek bırakılmalıdır.