Core/Render/Handlers — veri hazırlayıcılar ve üç güvenlik kapısı

Doğrulanan kod tabanı: c23b431f · Tarih: 2026-10-05 · Yayın: 0.9.7 = bu commit + sonrası; belge yalnız doğrulama anındaki kodu anlatır
Kaynak klasör: Core/Render/Handlers/ — 7 *.php = 4 kök + UI/ altında 3.
Envanter: 7 dosyanın 7'si anlatıldı.
Doğrulama platformu: Windows + PHP 8.3, TemplateExpressionGuard ve RawHtmlGate gerçekten çalıştırılarak.

1. Ne işe yarar, kim kullanır

İki farklı iş bir arada:

• UI/ altındaki 3 sınıf (Handler adı yanıltıcı): bunlar veri hazırlamaz,
  BaseRender::prepare() sözleşmesini boş doldurur — RenderService::prepareContext()
  her render'da $this->handler($type)->prepare(...) çağırır, UI handler'ları
  $data'ya kendiliğinden ekleme yapar ve veriyi olduğu gibi döndürür.
• Kök 3 sınıf: güvenlik kapıları. TemplateExpressionGuard derleme
  zamanında ifade denetler, RawHtmlGate çalışma zamanında ham HTML'i
  temizler, SchemaPreset şema ön ayarını uygular.

2. Klasör/dosya envanteri (7/7)

3. Akış — TemplateExpressionGuard (derleme zamanı kapısı)

ViewEngine::parse() her {{ }} ve {!! !!} ifadesi için
$guard->assertSafe($m[1], $dosyaAdi) çağırır (ViewEngine.php:181, :190).

ViewEngine::parse()
  └─ TemplateExpressionGuard::assertSafe($ifade, $dosyaAdi)   Handlers/TemplateExpressionGuard.php:114
     ├─ boş ifade → RuntimeException                                   :117-121
     ├─ statik önbellek: self::$sonucOnbellegi[$ifade]                 :123-129
     └─ denetle($ifade, $baglam)                                       :141-197
        1. DENIED_PATTERNS — '`', '<?', '?>', '/*', '$$', '${'         :143-149
        2. DENIED_STATEMENTS — include/require (word-boundary)           :152-159
        3. DENIED_FUNCTIONS — 60+ islev, `islev\s*\(` deseni           :164-171
        4. DENIED_KEYWORDS — new/echo/print/exit/…                      :175-182
        5. değişken-fonksiyon: yalnız $\GLOBALS…( gibi sistem çağrısı   :187-196

3.1 Ölçülen sınırlar (17 ifade, DOC-AGAC-3-dogrula3.php V2)

Tuzak (tasarım, kod yorumu :20-26): Bu izin listesi değil, yasaklı-yapı
listesidir. Korpusta meşru değişken-fonksiyon çağrıları var; yasaklama onları
kırardı. Sonuç: guard, "bu ifade güvenli mi" değil "bu ifade bu yasaklı kalıplardan
birini içeriyor mu" sorusuna cevap verir. DENIED_FUNCTIONS listesinde
file_exists/is_dir varken, listedeki file_get_contents de var — yani
bir şablon diskteki dosya varlığını bile yoklayamaz.

Önbellek sınırı yok: self::$sonucOnbellegi (:106) yalnız
onbellegiTemizle() ile temizlenir (:215). Uzun süreli süreçlerde (cron kervanı)
bellek sınırsız büyür; TemplateExpressionGuard.php:213 yorumu bunu kabul eder.

4. Akış — RawHtmlGate (çalışma zamanı kapısı)

FrontendProvider::safeSnippet() DB'den gelen 4 snippet'i bu kapıdan geçirir
(Providers/UI/FrontendProvider.php:124): google_analytics_code,
google_adsense_code, head_scripts, body_scripts.

RawHtmlGate::sanitize($html)      Handlers/RawHtmlGate.php:61
  ├─ EVENT_ATTR_PATTERN  → on*=="..." nitelikleri kaldırılır     :42, :65-98
  ├─ URI_ATTR_PATTERN    → href/src/action/… değerleri denetlenir :50, :115-137
  │    └─ DANGEROUS_SCHEMES eşleşirse 'about:blank#rbn-blocked' :53
  └─ dongusuzUygula() — özyineleme yok, tek geçiş (bounded)      :138

Ölçülen çıktı (V9):

Bulgu (yeni, ölçüldü): hasDangerousMarkup() ve sanitize() <script>
etiketini hiç ele almıyor — DANGEROUS_SCHEMES yalnız URI şemaları
(javascript:, vbscript:, livescript:, mocha:, data:text/html,
data:application/xhtml, data:image/svg+xml — :53) ve olay niteliklerini
kapsıyor. Meşru snippet'lerde <script> olmalıdır (analytics/AdSense tam
olarak <script> ile gelir), bu yüzden kaldırılamaz; ancak <script>alert(1)</script>
gibi ham <script> gövdesi de geçiyor. sanitize() yalnız on*= ve şema
taraması yaptığı için inline script içeriği korunur — bu, FrontendProvider
yorumunda (:111-123) bilinçli bir seçimdir ("meşru snippet'ler AYNEN korunur")
ama XSS yüzeyi on*= dışında kapatmaz.
Ayrıntı: acik-sorular.md §1.9.

5. Akış — UI handler'ları

RenderService::prepareContext() (Services/RenderService.php:68) her render'da
$this->handler($type)->prepare($type, $view, $data) çağırır:

RenderService::prepareContext('frontend', 'home', $data)
  └─ handler('frontend') → FrontendHandler::prepare('frontend','home',$data)  UI/FrontendHandler.php:20
     └─ $data döner (BaseRender::prepare varsayılanı ile aynı)

• Frontend (49 satır): yalnız sözleşme; gerçek veri toplama
  FrontendProvider::render() içinde yapılır (settings okuma, SEO, asset).
• Auth (94 satır): AuthIdentity üzerinden oturumdaki kimliği $data'ya
  bağlar. Panel/frontend BaseRender::bootHarmony()'de kullanıcı verisini zaten
  enjekte eder (Core/Base/Web/BaseRender.php:79); bu handler kimlik
  nesnesi tarafını tamamlar.
• Panel (131 satır): PanelIdentity + ConfigMap ile panel öneki ve panel
  kimliğini çözer.

Tuzak: Bu üç sınıf BaseRender'ı genişletir, BaseComponent'i değil; bu
yüzden provider()/resolver() yardımcıları da kullanılabilir.

6. Yapılandırma

Handlers/ altında sabit tanımlayan Config sınıfı yoktur — güvenlik
listeleri sınıf içi private const'tur:

7. Örnek (gerçek koddan)

// Core/Render/Handlers/UI/PanelHandler.php:25
public function prepare(string $type, ?string $view, array $options = []): array

// Ölçülen çıktı — guard'ın meşru değişken-fonksiyon çağrısını geçirmesi
(new TemplateExpressionGuard)->isSafe('$getEmoji($url)')   // true
(new TemplateExpressionGuard)->isSafe('system("ls")')       // false

8. Dark/light tema — destek tanımı ve neyin basıldığı (ColorSchemePolicy)

Tanım (tek yer): sitenin Core/Config/project-routemap.php view_mapping[<proje_anahtarı>] bloğunda

'color_schemes' => ['light', 'dark'],

Site tema düğmesini ancak hem light hem dark listelenmişse destekler (büyük/küçük harf ve boşluk önemsiz). Anahtar yok, tek şema, metin ('light,dark'), bilinmeyen ad ve true = desteksiz. Panel/admin ve auth bağlamı bu kararı kullanmaz.

Koşul FrontendHandler::prepare() içinde bir kez hesaplanır; head_state partial'ı yalnız $themeToggle değişkenini okur, yapılandırmaya bakmaz. rbnDom.js tema kodu taşımaz. Not: Config view_mapping değerlerini project-settings üstüne tam anahtar olarak yazar (bkz. 02-yapilandirma §4.2); color_schemes yalnız route-map'te tanımlanır.

9. İlgili belgeler

• Core/Render genel · Builders · Providers
• Core/Base/Web.md (BaseRender::prepare/bootHarmony) ·
  Core/System/Kernel.md (panic/RBN_PANIC_ACTIVE) ·
  Core/Support/Exceptions.md
• Açık sorular §1.9 (RawHtmlGate <script> kapsamı)