Laravel Blaze: Ne Yapar, Ne Zaman Kullanılmalı ve Ne Zaman Uygulamanızı Kırar

Kaynak: hafiz.dev

Blade bileşenleriniz düşündüğünüzden daha yavaş.

Bunun nedeni kötü kod yazmış olmanız değil. Renderlama pipeline’ı kendisi, her iç içe geçen bileşen ile birlikte ek yük taşır. Tek başına mikro saniyeler alan bir buton bileşeni, bir kontrol paneli üzerinde 500’ü render ettiğinizde gerçekten bir darboğaz haline gelir. Caleb Porzio bu problemi 2025 Laracon US etkinliğinden beri gündemde tutuyor: önbelleklenmiş Blade bileşenleri, düz PHP’den hala 10 kat daha yavaş. Dün, Laravel Dünya Genel Toplantısı’nda, Blaze’i tanıttı ve canlı olarak benchmark yaptı: 25,000 bileşen 17ms’nin altında render edildi.

İşte Blaze’in çözmeye çalıştığı problem bu.

Blaze, Livewire ekibinin (livewire/blaze) yeni bir paketidir ve Blade bileşenlerinizi optimize edilmiş PHP fonksiyonlarına önceden derler, standart renderlama pipeline’ını tamamen atlar. GitHub README’inden alınan veriler göz ardı edilemeyecek kadar çarpıcı: 500ms, aynı 25,000 bileşen için 13ms’ye düştü. Bu, renderlama yükünü %97 oranında azaltmak demektir.

Fakat çoğu kişinin gözden kaçıracağı bir nokta var. Blaze üç farklı optimizasyon katmanına sahiptir ve en saldırgan olanı, nasıl çalıştığını anlamazsanız sessizce uygulamanızı bozabilir. composer require yapmadan önce ihtiyacınız olan bu bilgilere bir göz atmalısınız.

Blaze Nedir (ve Nedir Değildir)

Blaze’in ne yaptığını netleştirmek önemlidir. Blade bileşenlerinin renderlama pipeline’ını optimize eder. Veritabanı sorgularınızı, API çağrılarınızı veya iş mantığınızı optimize etmez. Sayfanız yavaşsa ve sebep bir 2 saniyelik Eloquent sorgusuysa, Blaze size yardımcı olmayacaktır. Bunun için sorgu düzeyinde optimizasyonlara başvurmalısınız.

Blaze, her anonim Blade bileşeni için ek yükü hedef alır. Her biri için birden fazla aşamadan geçer: görünüm dosyasını bulma, özellikleri çözümleme, öznitelikleri birleştirme, slotları işleme, şablonu derleme ve çıktıyı renderlama. Tek bir buton için bu yüke dikkat etmeyebilirsiniz fakat yüzlerce satır içeren bir veri tablosu için? İşte o noktada milisaniyeler birikir.

Blaze bu pipeline’ı doğrudan PHP fonksiyon çağrıları ile değiştirir. Şablonunuz bir kez optimize edilmiş bir fonksiyona derlenir ve sonraki tüm renderlamalarda sadece o fonksiyon çağrılır. Görünüm çözümlemesi yok. Pipeline üst yükü yok.

Önemli bir not: Blaze şu anda sadece anonim Blade bileşenleriyle çalışmaktadır. Kendi PHP sınıfına sahip olan sınıf tabanlı bileşenlerinizi (dedike PHP sınıfları olanlar) optimize etmez. Anonim bileşenler, resources/views/components dizininizde karşılık gelen bir sınıfı olmayan .blade.php dosyalarıdır.

Kurulum ve Temel Ayar

Başlamak yaklaşık 30 saniye sürüyor:

composer require livewire/blaze:^1.0@beta

Hepsi bu kadar. Yayınlanacak bir yapılandırma dosyası yok. Kaydedecek bir hizmet sağlayıcı yok. Blaze kendini otomatik olarak keşfeder ve kaydeder.

Flux UI’yi (Flux UI) kullanıyorsanız, başka bir şey yapmanıza gerek yok. Tüm uygun Flux bileşenleri zaten @blaze ile işaretlenmiştir. Paketi yükleyin ve Flux bileşenleriniz otomatik olarak hızlanır.

Kendi bileşenleriniz için iki yaklaşım vardır.

Seçenek A: Bileşene Özgü Direktif

Her bileşen dosyasının en üstüne @blaze ekleyin:

{{-- resources/views/components/button.blade.php --}}

@blaze

@props(['variant' => 'primary'])

Seçenek B: Tüm Dizinleri Optimize Etmek

Hizmet sağlayıcınızda dizinleri kaydedin:

use Livewire\Blaze\Blaze;

public function boot(): void
{
    Blaze::optimize()
        ->in(resource_path('views/components/ui'))
        ->in(resource_path('views/components/icons'));
}

Birlikte karıştırabilirsiniz. Belirli dizinlerle başlayın ve uyumluluğu doğruladıktan sonra kapsama alanını genişletin.

Blaze’i etkinleştirdikten sonra, derlenmiş görsellerinizi temizleyin:

php artisan view:clear

Bu, Blaze’in her şeyi optimize edilmiş pipeline ile yeniden derlemesini sağlar. Derlenmiş çıktının aslında nasıl göründüğünü merak ediyorsanız, önce ve sonra farklılıkları karşılaştırabilirsiniz storage/framework/views dizininizde. Blaze’in arka planda ne yaptığını anlama konusunda sezgi geliştirmek için iyi bir yol.

Üç Optimizasyon Katmanı

Burada ilginç bir nokta var. Blaze sadece bir optimizasyon stratejisi sunmaz. Üç stratejisi vardır, her biri daha saldırgan. Farklılıkları anlamak kritik öneme sahiptir çünkü yanlış katmanı yanlış bileşen için seçerseniz hatalarla karşılaşabilirsiniz.

Katman 1: Optimize Edilmiş Derleyici (Varsayılan)

Bu, @blaze eklediğinizde veya Blaze::optimize() kullandığınızda elde ettiğiniz şeydir. Blade şablonlarınız optimize edilmiş PHP fonksiyonlarına derlenir ve standart renderlama pipeline’ından geçmez.

Hiçbir yapılandırma gerekmez. Şablonlarınızda bir değişiklik yoktur. Çoğu anonim bileşenle çalışan bir yerleştirme değişikliğidir.

Performans kazanımı: %97’ye kadar yük azaltma.

Risk seviyesi: Çok düşük. Bu katman, standart Blade ile neredeyse tam özellik eşdeğerliliği sağlar. Kenar durumları hakkında endişelenmeden çoğu bileşene güvenle uygulayabilirsiniz.

En iyisi: Her şey. Buradan başlayın ve özel bir sebep yoksa burada kalın.

Katman 2: Memoizasyon (Opsiyonel)

Memoizasyon, bir bileşenin render edilmiş çıktısını önbelleğe alır. Eğer aynı bileşen sayfada aynı özelliklerle birden fazla kez görünüyorsa, bir kez render edilir ve çıktısı yeniden kullanılır.

200 durum simgesi barındıran bir kontrol panelini düşünün. Memoizasyon olmadan, her tam render döngüsünden geçer. Memoizasyon ile bir kez render edilir ve gerisi önbellekten gelir.

@blaze(memo: true)

@props(['name'])

Önemli sınırlama: Memoizasyon sadece slot içermeyen bileşenlerde çalışır. Eğer bileşeniniz {{ $slot }} içeriyorsa, kullanılan slot içeriği her kullanımda farklılık göstereceği için memo uygulanamaz.

En iyisi: Simge, avatarlar, rozeti ve aynı özelliklerle birçok kez görünen her bileşen.

Katman 3: Derleme Zamanında Katlama (Opsiyonel)

Bu nükleer bir seçenektir. Bunu hem “son derece güçlü” hem de “son derece dikkatli kullanılmalı” anlamında söylüyorum.

Katlama, bileşeninizi derleme zamanında önceden render eder ve doğrudan ana şablona ham HTML olarak gömer. Bileşen çalışma zamanında yok olur. Hiçbir fonksiyon çağrısı. Hiçbir değişken çözümü. Hiçbir üst yük yok.

@blaze(fold: true)

@props(['variant' => 'primary'])

Bu düğmeyi statik özelliklerle kullanırsanız:

Kaydet

Blaze, bileşeni çalışma zamanında render etmez. Çıktıyı gerçekten şablonunuza derleme sırasında yerleştirir:

Çalışma zamanı maliyeti sıfırdır. Bileşen doğrudan HTML haline gelir.

Fakat burada dikkat edilmesi gereken bir nokta var. Katlama yalnızca Blaze, derleme zamanında tüm değerleri belirleyebildiğinde çalışır. Eğer dinamik bir değişken geçerseniz:

Kaydet

Blaze, bunun ne olduğunu bilemeyeceğinden katlama yapamaz. Otomatik olarak işlev derleyici (Katman 1) ile geri döner. Hata yok, çökme yok. Sadece katlama avantajı yok.

Performans kazancı: Çalışma zamanı üst yükünün tamamen ortadan kaldırılması. Render zamanı, bileşen sayısından bağımsız olarak sabit hale gelir.

Risk seviyesi: Yüksek. İşte burada sorunlarla karşılaşabilirsiniz.

Blaze Ne Zaman Uygulamanızı Bozar

Bu bölümde biraz daha fazla zaman harcıyorum çünkü Blaze belgelerinde birçok uyarı bulunuyor ve bunun iyi bir nedeni var. Katlama, insanlar tarafından en heyecan verici özellik olarak görülüyor ve aynı zamanda en çok gizli, tanınması zor hataları yaratma potansiyeline sahip.

Purite Testi

Katlama etkin olduğunda @blaze eklemeden önce, bileşeniniz ile ilgili kendinize şu beş soruyu sorun:

Tüm kullanıcılar için aynı şekilde çalışıyor mu? (no @auth, no auth()->user())
Her istekte aynı şekilde çalışıyor mu? (no request(), no @csrf)
Herhangi bir zamanda aynı şekilde çalışıyor mu? (no now(), no Carbon::now())
Yalnızca geçirdiğiniz öznitelikleri mi kullanıyor? (no session(), no config(), no DB sorguları)
Tüm alt bileşenler de katlanabilir mi?

Eğer bu sorulardan birine hayır yanıtı verdiyseniz, o bileşende katlamayı kullanmamalısınız.

Blaze belgeleri, bunu “saf fonksiyon” zihinsel model olarak adlandırıyor. @blaze bileşenleriniz, programlamada saf fonksiyonlar gibi olmalıdır: aynı girdi her zaman aynı çıktıyı verir; yan etkisi yoktur.

Gizli Hatalar

Katlamanın tehlikeli olmasının nedenidir. Bu desenler masum görünmesine rağmen, hataları üretir:

Ortamlar arasında değişen yapılandırma değerleri:

{{-- Bu buton URL'si derleme zamanında yerleştirilecektir --}}
@blaze


    Kontrol Merkezi

Üretimde görselleri derlediğinizde, config('app.url') derleme zamanındaki değeri olarak yerleşir. Eğer daha sonra .env dosyanızı değiştirirseniz, bağlantı güncellenmez, derlenmiş görselleri temizleyene kadar. Kolaylıkla gözden kaçırabilirsiniz.

CSRF token’ları içeren bileşenler:

{{-- @csrf içeren formlar için asla @blaze kullanmayın --}}
@blaze

CSRF token’ı oturum başına değişir. Katlama, bir token’ı sürekli olarak yerleştirir. Her form gönderimi başarısız olur.

Zaman bağımlı içerik:

@blaze


    © {{ date('Y') }} Şirketim

1 Ocak’ta, bu altbilgi hala geçen yılın tarihini gösterecek, görüşleri temizlemeden.

Katlanamaz çocukları içeren bileşenler:

@blaze


      {{-- Eğer bu auth() kullanıyorsa, ana bileşen de kırılır --}}
    {{ $slot }}

Katlama tersine bulaşıcılık taşır. Bir ebeveyn, eğer herhangi bir zorunlu çocuğu çalışma zamanı durumuna dayanıyorsa güvenle katlanamaz.

Blaze Neyi Yakalar (Neyi Yakalamaz)

Blaze, sizi korumaya çalışır. Eğer bir katlanmış bileşenin içinde auth(), session() veya request() gibi küresel durum kullanımı tespit ederse bir istisna fırlatır. Ancak belgeler net: her şeyi yakalayamaz. Bir yardımcı fonksiyonu sorgulayan bir sorguda veya çalışma zamanında çözülen bir Blade direktifinin kullanımı gibi desenler kaybolabilir.

Genel kural: Eğer bileşenin güvenli olup olmadığından emin değilseniz, katlama yapmayın. Varsayılan Katman 1 derleyici zaten %97 üst yük azaltma sağlıyor. Bu yeterli olabilir.

Yerleşik Profiler

Blaze, alev grafikleri ve her bileşenin zaman kırılımını oluşturan bir profiler ile birlikte gelir. Bu, hangi bileşenlerin optimizasyondan en çok faydalandığını belirlemede gerçekten kullanışlıdır.

Aktifleştirmek için:

Blaze::debug();

Bu, sayfalarınıza bir debug üst katmanı ekler ve “Profili Aç” düğmesini gösterir. Profiler, istek sırasında render edilen her bileşeni, süresini, iç içe geçme derinliğini ve hangi optimizasyon stratejisinin kullanıldığını gösterir (derlenmiş, katlanmış, memoize edilmiş veya standart Blade).

Profiler, uygulamanızın varsayılan önbellek deposunda verileri depolar, bu yüzden geliştirme aşamasında array önbellek sürücüsünü kullanmadığınızdan emin olun. Redis veya dosya tabanlı önbellekleme iyi bir şekilde çalışır.

Blaze’e yaklaşmanın doğru yolu: önce profili etkinleştirin, en ağır bileşenlerinizi belirleyin ve ardından optimizasyonları stratejik bir şekilde uygulayın, her şeye @blaze eklemek yerine.

Blaze ve Standart Performans Optimizasyonu

Burada beklentileri dürüstçe belirtmek istiyorum. Blaze, çok özel bir sorunu çözer: Blade bileşenleri renderlama üst yükü. Çoğu Laravel uygulaması için bu ana darboğazınız değildir.

Uygulamanız yavaşsa, genellikle, veritabanı sorguları, harici API çağrıları ve optimize edilmemiş varlık yükleme gibi yaygın sebepler vardır. Bunları kapsayan yedi hızlı performans kazancı yazdım ve dürüst olmak gerekirse, çoğu uygulama Blaze’den daha fazla uygun indeksleme ve sorgu optimizasyonundan fayda sağlar.

Blaze’in başarılı olduğu yer, bileşenlere dayalı uygulamalardadır. Yeniden kullanılabilir Blade bileşenleri ile bir tasarım sistemi inşa ettiyseniz veya karmaşık tablo görünümleri render eden bir Filament yönetim paneline sahipseniz, üst yük azalması gerçekten anlamlıdır.

Blaze, Livewire uygulamaları için de özellikle ilgili. Her Livewire yeniden render’ı, Blade bileşenleri render etmeyi tetikler, bu nedenle o üst yükü azaltmak etkileşim üzerindeki etkisi katlanarak artar. Karmaşık Livewire tabloları veya kontrol panelleri render ediyorsanız, Blaze hızlı bir arayüz ile yavaş bir arayüz arasındaki farkı yaratabilir.

Önerim

Tam kaynak ve belgeleri okuduktan sonra, işte görüşüm:

Yükleyin. Katman 1 derleyici neredeyse her proje için yeterince güvenlidir. Risk-kazanç oranı, kazanç lehine oldukça eğimli. Laravel 10, 11 veya 12 üzerinde iseniz ve anonim Blade bileşenleri kullanıyorsanız (ki neredeyse kesinlikle kullanıyorsunuz), Blaze’i eklememek için fazla bir neden yok.

Öncelikle Katman 1 ile başlayın. Katlama yapmadan direkt olarak atlamayın. Optimize edilmiş derleyiciden elde edilecek %97 yük azaltma zaten önemli. Bileşen dizinlerinize @blaze veya Blaze::optimize() uygulayın ve etkinin boyutunu görmek için profili çalıştırın.

Mekanoizasyonu seçici bir şekilde kullanın. Eğer profil, bir bileşenin aynı özelliklerle birçok kez render edildiğini gösteriyorsa (simge gibi klasik bir örnek), memo: true ekleyin. Fakat bunu her bileşende uygulamayın.

Katlamaya dikkatle yaklaşın. Sadece kişisel olarak saf olduklarını doğruladığınız bileşenleri katlayın. Şüpheci olduğunuzda, geçin. Katman 1 ile Katman 3 arasındaki fark, aşırı ölçek (sayfa başına binlerce bileşen) durumunda daha çok önemlidir ve çoğu uygulama bu eşiği geçmez.

Bir şey daha. Paket, erken aşama beta olarak işaretlenmiştir (v1.0.0@beta). API değişebilir ve hala çalışılması gereken kenar durumları vardır. Kullanın, ancak kapsamlı bir şekilde test edin ve GitHub sorunlarını takip edin.

Sıkça Sorulan Sorular

Blaze, Livewire bileşenleriyle çalışır mı?

Blaze, doğrudan Livewire bileşenleri için tasarlanmış anonim Blade bileşenleri içindir. Ama Livewire bileşenleri içindeki Blade şablonlarını optimize ettiğiniz için Livewire genel performansında olumlu bir etkisi vardır.

Blaze mevcut Blade kurulumumla çelişir mi?

Hayır. Katman 1 derleyici, standart Blade ile özellik eşdeğerliliğini koruyan bir yerleştirmedir. Herhangi bir problemle karşılaşırsanız, @blaze direktifini kaldırabilir veya paketi tamamen kaldırabilirsiniz ve her şey normale döner.

Blaze uygulamamı gerçekten yardımcı olup olmadığını nasıl anlayabilirim?

Yerleşik profili kullanın (Blaze::debug()). Bu, her bileşenin zamanını gösterir ve her bileşene uygulanan optimizasyon stratejisini gösterir. Blaze ile ve olmadan render sürelerini karşılaştırarak belirli uygulamanız üzerindeki gerçek etkiyi ölçebilirsiniz.

Blaze, Laravel 10 ile çalışır mı?

Evet. Blaze, Laravel 10, 11 ve 12’yi destekler ve PHP 8.1 veya daha yüksek gerektirir.

Blaze’i üretimde kullanmalı mıyım?

Katman 1 optimize edilmiş derleyicisi üretim için güvenlidir. Paket beta olarak işaretlenmiştir, ancak temel derleme stratejisi iyi bir şekilde test edilmiştir. Katlama (Katman 3) üretime geçmeden önce daha dikkatli doğrulama gerektirir. Öncelikle bir aşama ortamında kapsamlı test edin.

Son Düşünceler

Blaze, çoğu Laravel geliştiricisinin bilmediği bir problemi ele alıyor. Blade’in bileşen renderlama üst yükü, yeterince bileşeniniz olduğunda görünmez hale gelir ve o noktada genellikle başka bir şeyin suçunu üstlenirsiniz.

Tek satırlık bir kurulum ile hemen fayda (Katman 1) sağlanması ve ihtiyacınız olduğunda kullanabileceğiniz seçenekli gelişmiş özellikler (memoizasyon, katlama), bunu kolay bir öneri haline getiriyor. Ancak katlama hakkında aşırı heyecanlanmadan önce, etkilerini anlamanız önemlidir.

Eğer bileşen ağırlıklı bir şey inşa ediyorsanız ve performans önemliyse, Blaze’i deneyin. Laravel uygulamanızın performansını sadece renderlama katmanının ötesinde optimize etmek için yardıma ihtiyacınız varsa, iletişime geçelim.

Kaynak: Orijinal Makale

Contents