Laravel ile modern, tek sayfa uygulamaları (SPA) geliştirmek isteyenler için Inertia.js, geleneksel API tabanlı yaklaşımlara alternatif olarak oldukça kullanışlı bir araç sunar. Peki, Laravel ve Inertia.js entegrasyonunu ilk kez kurarken nelere dikkat etmek gerekir? İşte detaylı ve adım adım bir kurulum rehberi.
İlk aşamada, Laravel projesini yeni oluşturmak veya mevcut bir projeye entegre etmek gerekebilir. Laravel 8 ve üzeri sürümler, Inertia.js ile uyumlu olduğu için, öncelikle uygun Laravel sürümünü kullanmanız önemlidir. Ardından, npm ve Composer güncellemelerini yapıp, projeye Inertia.js ve ilgili bağımlılıkları eklemek gerekir.
İşte temel adımlar:
Laravel Projesi Kurulumu:
Eğer yeni proje başlatıyorsanız, terminalde
1composer create-project --prefer-dist laravel/laravel projeAdi
komutunu çalıştırabilirsiniz.
Gerekli Bağımlılıkların Yüklenmesi:
Inertia.js ve Vue 3 gibi ön yüz kütüphanelerini kullanmak için, öncelikle npm ve Laravel Mix veya Vite yapılandırmasını kullanmanız gerekir.
Örneğin, npm ile bağımlılıkları yükleyebilirsiniz:
1npm install @inertiajs/inertia @inertiajs/inertia-vue3 vue@next
Vue 3 Entegrasyonu:
Vue 3’ü ve Inertia’yi projeye entegre etmek için, resources/js/app.js dosyasını uygun şekilde yapılandırmanız gerekir.
Örneğin,:
1234567891011import { createApp, h } from 'vue'
import { createInertiaApp } from '@inertiajs/inertia-vue3'
createInertiaApp({
resolve: name => require([icode]./Pages/${name}[/icode]),
setup({ el, app, props, plugin }) {
createApp({ render: () => h(app, props) })
.use(plugin)
.mount(el)
},
})
Blade Şablonunun Güncellenmesi:
resources/views/app.blade.php dosyasını Inertia uyumlu hale getirerek, şu yapıya sahip olmalı:
Ve, uygun Vue ve Inertia bileşenlerini yükledikten sonra, projeyi derlemeye hazır hale getirirsiniz.
Son olarak, npm run dev veya npm run build komutlarıyla projeyi derleyip çalışan hale getirmek gerekir.
Bu adımlar, Laravel ve Inertia.js entegrasyonunun temelini oluşturur. Sisteminizin ihtiyaçlarına göre, ek yapılandırmalar veya özel ayarlamalar gerekebilir.
Inertia.js, Laravel ile modern ve dinamik uygulamalar geliştirmeyi oldukça kolaylaştırır ve hem geliştirici deneyimini artırır hem de performansı optimize eder.
