Aimeos ile Beş Dakikada Çalışan Bir Laravel Mağazası

Laravel uygulamanıza bir mağaza eklemek genellikle çok zaman alır. Bir sepet kütüphanesi seçer, bir ödeme geçidi entegre eder, kimsenin istemediği bir yönetici paneli oluşturursunuz ve ardından ürün modelinizin varyantlar, paketler veya katmanlı fiyatlarla başa çıkamadığını öğrenirsiniz. E-ticaret kısmı zaman planını yiyip bitirir; asıl sorun Laravel değil.

Aimeos bunun tersine bir yaklaşım sergiliyor. Bu, Laravel için bir paket olup, mağaza ön yüzü, yönetici arka uç, ön uç için bir JSON:API, yönetim için bir GraphQL API ve varyantlar, paketler, abonelikler ve blok fiyatlandırma için oluşturulmuş bir ürün modelini içerir. Laravel’deki diğer paketleri kurduğunuz gibi kurarsınız ve kahveniz soğumadan çalışan bir mağazaya sahip olursunuz.

İnsanların buna inanmadığı kısım: tam kurulum yaklaşık beş dakika sürer. Temiz bir başlangıç yapıyorsanız veya zaten elinizde bir uygulama varsa, iki yol vardır.

Yol 1: Bağımsız bir mağaza

Eğer henüz bir uygulamanız yoksa, dağıtım her şeyi sizin için ayarlar. PHP 8.2+ ve bir veritabanına (MySQL, MariaDB, PostgreSQL veya SQL Server) ihtiyacınız var.

composer create-project aimeos/aimeos myshop

Kurulum sırasında veritabanı kimlik bilgilerinizi, e-posta ayarlarınızı ve yönetici hesabı için e-posta ve şifre girmenizi ister. Aynı adımda şema kurulumunu gerçekleştirir ve gösterim verilerini hazırlar; bu yüzden kurulum işlemi bittiğinde, dolu bir katalog elde edersiniz, boş bir şelale değil.

Ayrıca, dolaşmak için yerleşik sunucuyla başlatın:

cd myshop
php artisan serve

Mağaza ön yüzü http://127.0.0.1:8000 adresinde, yönetici arka ucu ise http://127.0.0.1:8000/admin adresindedir. Henüz oluşturduğunuz hesapla giriş yapın. Katalog, sepetler, ödeme, siparişler ve gösterge paneli zaten mevcut.

Hosting için, vhost belgesi üzerindeki kök dizini myshop/public/ olarak ayarlayın ve .env dosyasındaki APP_URL‘yu alan adınıza ayarlayın. Bu, dağıtımla ilgili tek değişikliktir.

Yol 2: Mevcut bir Laravel uygulamasına ekleme

Zaten bir uygulamanız var ve onun içine bir mağaza eklemek mi istiyorsunuz? Paketi ekleyin:

composer require aimeos/aimeos-laravel:~2025.10

Yapılandırmayı ve varlıkları yayınlayın, göç işlemini çalıştırın ve Aimeos’un tablolarını kurmasına izin verin:

php artisan vendor:publish --tag=config --tag=public
php artisan migrate
php artisan aimeos:setup

Demo verisiyle birlikte kurulum yapmak istiyorsanız, aimeos:setup komutuna --option=setup/default/demo:1 ekleyin; üretim için bırakın.

Arka uç için bir süper kullanıcı oluşturun:

php artisan aimeos:account --super [email protected]

Parola sormanızı isteyecektir. Mağaza artık uygulamanızın yolları altında yer alır, aynı Laravel oturumu, kimlik doğrulama ve yapılandırmayı paylaşır. Ön yüz / üzerinden, arka uç ise /admin üzerinden çalışır, uygulamanızın sunduğu diğer yollarla birlikte.

Gerçekten Neler Elde Ediyorsunuz

Kurulum kısa sürüyor çünkü paket tamamlanmış bir başlangıç noktası değil; özelleştirilebilir bir yapıdır. Kutudan çıktığı gibi:

• Katalog filtreleri, arama, sepet, çok adımlı ödeme ve müşteri hesapları ile bir mağaza ön yüzü.
• Ürünler, siparişler, müşteriler, fiyatlandırma ve pazarlama için bir gösterge paneli ile tam bir yönetici arka uç.
• Json-api.org’yu takip eden bir JSON:API, böylece paketlenmiş görüntüleri bırakarak onu React, Vue veya yerel bir uygulamadan yönlendirebilirsiniz.
• Veri yönetimini programatik olarak yapmak istiyorsanız bir GraphQL API.
• Varyantlar, paketler, kuponlar, sanal ve yapılandırılabilir ürünler ile birlikte abonelikleri, tekrarlayan ödemeleri ve blok/katmanlı fiyatlandırmayı yöneten bir ürün modeli — şemada değişiklik yapmadan.
• Omnipay aracılığıyla 100’den fazla ödeme geçidi entegrasyonu.
• 30’dan fazla dile çevrili, çok dilli yönlendirme, çok satıcılı ve çok depolu destek.

Katalog büyüdükçe hızlı kalacak şekilde tasarlandı, birkaç üründen milyonlarca ürüne kadar. Bu, bir mağazanın ikinci yılına hayatta kalıp kalamayacağını belirleyen unsurlardan biridir.

Fork Etmeden Özelleştirme

Her katman, Laravel’in kendi kuralları aracılığıyla değiştirilebilir. Yapılandırma config/shop.php dosyasında bulunur. Şablonlar, resources/views/vendor/shop/ dizinine kopyalayarak geçersiz kılabileceğiniz standart Blade görünümleridir. İş mantığı, yapılandırmada kaydettiğiniz dekoratörlerde yer alır, böylece davranışları sarmalayarak değiştirirsiniz, bir sonraki güncellemenin üzerine yazacağı tedarikçi kodunu düzenleyerek değil. Çok dilli yönlendirmeyi, çok satıcı modunu veya satıcılar için kendine kayıt seçeneğini tek bir .env bayrağıyla açabilirsiniz:

SHOP_MULTILOCALE=true
SHOP_MULTISHOP=true
SHOP_REGISTRATION=true

Deneyin

Samimi test, bunu kendiniz çalıştırmaktır. composer create-project aimeos/aimeos myshop komutunu uygulayın, istemleri yanıtlayın, php artisan serve ile başlatın ve tarayıcıyı açın. Elde ettiğiniz sonucu görmek istiyorsanız, ön yüz demo ve yönetici demo canlıdır.

Belgeler aimeos.org/docs/latest/laravel adresinde yer almaktadır; eğer başsız veya PWA ön yüzü oluşturuyorsanız, Aimeos başsız dağıtımı API yalnızca JWT kimlik doğrulamasıyla birlikte gelir.

Çalışan bir mağaza için beş dakika. Geri kalan çeyrek sizin.