Yazılım

Spatie olay kaynaklama kullanarak bir alan oluşturma

Son güncelleme: 19 Temmuz 2026 12:02

teknomers

Paylaş

Paylaş

Event sourcing, uygulama durumunu izlemek için güçlü bir model sunar ve Laravel’de alan odaklı tasarım yönetiminin sağlam bir yolunu sağlar. Ancak, bir event-sourcing alanı kurmak zaman alıcı ve tekrarlayan bir işlem olabilir, özellikle de en iyi uygulamaları izliyorsanız.

<p>Bu süreci hızlandırmak için, Spatie'nin event sourcing kütüphanesini kullanarak event-sourcing alanlarını otomatik olarak oluşturacak bir Laravel paketi geliştirdim. Sadece bir artisan komutu ile, alanınız için gerekli olan tüm templateleri, agregatleri, olayları ve projektörleri otomatik olarak oluşturabilirsiniz.</p>

<p>Bu paket, geliştiricilerin tekrarlayan kurulum görevlerine zaman harcamak yerine iş mantığına odaklanmalarını sağlar. İster finansal sistemler, ister denetim izleri, ister ayrıntılı durum takibi gerektiren karmaşık uygulamalar geliştirin, bu paket, hızlı bir başlangıç yapmanıza yardımcı olabilir.</p>

<p>Kullanımının ne kadar basit olduğunu göz atalım:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>php artisan make:event-sourcing-domain MODEL <span class="nt">--domain</span><span class="o">=</span>DOMAIN

<p>Bu blog yazısında, bu paketi nasıl kullanacağınızı ve ana özelliklerini açıklayacağım, ayrıca Laravel projelerinize event sourcing'i entegre etmek için pratik örnekler sunacağım.</p>

<h2>
    <a name="understanding-the-command" href="#understanding-the-command">
    </a>
    Komutu Anlamak
</h2>

<p>Bu paketin ana komutu şudur:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>php artisan make:event-sourcing-domain MODEL <span class="nt">--domain</span><span class="o">=</span>DOMAIN

<p>Bu komut, Laravel projenizde tamamen işlevsel bir event-sourcing alanı için gerekli olan yapıyı ve dosyaları oluşturur. Şimdi, bunu parçalayalım:</p>

<h3>
    <a name="parameters" href="#parameters">
    </a>
    Parametreler
</h3>

<ol>
    <li>
        <code>MODEL</code>:
    </li>
</ol>
<ul>
    <li>Bu, alanınız için temel varlık ya da agregat kökünü temsil eder.</li>
    <li>Örnek: Eğer bir e-ticaret uygulaması geliştiriyorsanız, bir MODEL Sipariş, Ürün veya Müşteri olabilir.</li>
</ul>

<ol>
    <li>
        <code>--domain=DOMAIN</code>:
    </li>
</ol>
<ul>
    <li>Bu, modelinizin çalıştığı alanı ya da sınırlı bağlamı tanımlar.</li>
    <li>Örnek: Bir Sipariş modeli için, bunu Satış veya Envanter gibi bir alana yerleştirebilirsiniz.</li>
</ul>

<h3>
    <a name="command-usage" href="#command-usage">
    </a>
    Komutun Kullanımı
</h3>

<p>İşte bu komutu nasıl kullanabileceğinize dair bir örnek:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>php artisan make:event-sourcing-domain Order <span class="nt">--domain</span><span class="o">=</span>Sales

<p>Bu komutu çalıştırmak, aşağıdaki yapıyı oluşturacaktır:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight plaintext"><code>app/

└── Domain/
└── Sales/
├── Actions/
│ ├── CreateOrder.php
│ ├── DeleteOrder.php
│ └── UpdateOrder.php
├── Aggregates/
│ └── OrderAggregate.php
├── Events/
│ ├── OrderCreated.php
│ ├── OrderDeleted.php
│ └── OrderUpdated.php
├── Projections/
│ └── Order.php
└── Projectors/
└── OrderProjector.php

<h2>
    <a name="example-workflow" href="#example-workflow">
    </a>
    Örnek İş Akışı
</h2>

<p>Bu paketin gücünü göstermek için, Laravel uygulamanızda Satış alanı içinde Siparişleri yönetmek için bir alan kurmayı göreceğiz.</p>

<p>Bir migration'ın zaten mevcut olduğunu varsayalım.<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code><span class="c1">// database/migrations/2024_12_20_121314_create_orders_table.php</span>

return new class extends Migration
{
/*
Run the migrations.
*/
public function up(): void
{
Schema::create(‘orders’, function (Blueprint $table) {
$table->uuid()}->primary();
$table->string(‘customer_email’)->index();
$table->string(‘customer_name’);
$table->string(‘status’)->default(‘pending’);
$table->decimal(‘total_amount’, 10, 2);
$table->json(‘items’);
$table->timestamps();
});
}

<span class="c1">// etc.</span>

};

<h3>
    <a name="step-1-generate-the-eventsourcing-domain" href="#step-1-generate-the-eventsourcing-domain">
    </a>
    Adım 1: Event-Sourcing Alanını Oluşturma
</h3>

<p><code>make:event-sourcing-domain</code> komutunu çalıştırın:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>php artisan make:event-sourcing-domain Order <span class="se">\</span>

–domain=Sales \
–aggregate=1

<p>Bu komutu çalıştırmak, aşağıdaki yapıyı oluşturacaktır:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>app/

└── Domain/
└── Sales/
├── Aggregates/
│ └── OrderAggregate.php
├── DataTransferObjects/
│ └── OrderData.php
├── Events/
│ ├── OrderCreated.php
│ ├── OrderUpdated.php
│ └── OrderDeleted.php
├── Projections/
│ └── Order.php
└── Projectors/
└── OrderProjector.php

<h3>
    <a name="step-2-use-it" href="#step-2-use-it">
    </a>
    Adım 2: Kullanım
</h3>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code><span class="kn">use</span> <span class="nc">App\Domain\Sales\Actions\CreateOrder</span><span class="p">;</span>

use App\Domain\Sales\DataTransferObjects\OrderData;
use App\Domain\Sales\Projections\Order;

# Bu, ‘orders’ tablosuna bir kayıt oluşturur, OrderProjector ile
(new CreateOrder)(new OrderData(
customer_email: ‘[email protected]’,
customer_name: ‘John Doe’,
total_amount: 110.2,
items: [
[
‘id’ => 12345, ‘name’ => ‘Whiskey bottle’, ‘quantity’ => 2, ‘price’ => 55.1,
]
],
));

# Kayıt alın
$order = Order::query()->where(’email’, ‘[email protected]’)->first();

<h2>
    <a name="advanced-examples" href="#advanced-examples">
    </a>
    Gelişmiş Örnekler
</h2>

<h3>
    <a name="generate-phpunit-tests" href="#generate-phpunit-tests">
    </a>
    PHPUnit Testleri Oluşturma
</h3>

<blockquote>
    <p><a href="https://github.com/albertoarena/laravel-event-sourcing-generator/blob/main/docs/unit-tests.md" target="_blank" rel="noopener noreferrer">Tam dökümantasyonu burada okuyun</a></p>
</blockquote>

<p>İlgili bir özellik, model için otomatik olarak PHPUnit testleri oluşturma yeteneğidir.</p>

<p><code>make:event-sourcing-domain</code> komutunu çalıştırın:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>php artisan make:event-sourcing-domain Order <span class="se">\</span>

–domain=Sales –unit-test

<h3>
    <a name="generate-notifications" href="#generate-notifications">
    </a>
    Bildirimler Oluşturma
</h3>

<blockquote>
    <p><a href="https://github.com/albertoarena/laravel-event-sourcing-generator/blob/main/docs/advanced-options.md#generate-notifications" target="_blank" rel="noopener noreferrer">Tam dökümantasyonu burada okuyun</a></p>
</blockquote>

<p>Paket, bir seçenek ile bildirimler (mail, Slack ve Teams) oluşturmanıza olanak tanır.</p>

<p><code>make:event-sourcing-domain</code> komutunu çalıştırın:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>php artisan make:event-sourcing-domain Order <span class="se">\</span>

–domain=Sales \
–aggregate=1 \
–notifications=mail,slack

<p>Bu komut, aşağıdaki yapıyı oluşturacaktır:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight plaintext"><code>app/

└── Domain/
└── Sales/
├── Aggregates/
│ └── OrderAggregate.php
├── DataTransferObjects/
│ └── OrderData.php
├── Events/
│ ├── OrderCreated.php
│ ├── OrderUpdated.php
│ └── OrderDeleted.php
├── Notifications/
│ ├── Concerns/
│ │ └── HasDataAsArray
│ ├── OrderCreated.php
│ ├── OrderUpdated.php
│ └── OrderDeleted.php
├── Projections/
│ └── Order.php
└── Projectors/
└── OrderProjector.php

<h2>
    <a name="whats-next" href="#whats-next">
    </a>
    Sonraki Adımlar
</h2>

<p>Bazı Blueprint sütun türleri henüz desteklenmiyor. Desteklenmeyen sütun türlerinin listesini bulabilirsiniz: <a href="https://github.com/albertoarena/laravel-event-sourcing-generator/blob/main/docs/migrations.md#unsupported-column-types" target="_blank" rel="noopener noreferrer">bu bağlantıda</a>.</p>

<p><del>Güncelleme migrations'ları henüz kullanılamıyor, yalnızca oluşturma migrations'ları kullanılabilir.</del></p>

<p>👉 <strong><em>Bu artık mevcut!</em></strong> <a href="#notes">(*)</a></p>

<p><del>Son olarak, paket PHP 8.3 ile düzgün bir şekilde test edilmeli ve o sürüm için yayınlanmalıdır.</del></p>

<p>👉 <strong><em>Bunu yaptım!</em></strong>  <a href="#notes">(*)</a></p>

<h2>
    <a name="conclusion" href="#conclusion">
    </a>
    Sonuç
</h2>

<p>Event sourcing, uygulamalarınızı sağlam durum yönetimi ve net bir denetim kaydı ile inşa etmek için dönüştürücü bir yaklaşımdır. Spatie event sourcing kütüphanesinden yararlanarak ve bu Laravel paketini kullanarak, event-sourcing alanlarını kurarken harcanan zamanı önemli ölçüde azaltabilirken tutarlılık ve en iyi uygulamaları da sağlamış olursunuz.</p>

<p>Tek bir artisan komutuyla, alanınız için gerekli tüm dosya ve yapıları oluşturabilirsiniz, bu da uygulamanızın özgün yönlerini inşa etmeye odaklanmanızı sağlar.</p>

<p>Geliştirme iş akışınızı hızlandırmaya ve event sourcing'e dalmaya hazırsanız, hemen paketi deneyin:</p>

<p>👉 <a href="https://github.com/albertoarena/laravel-event-sourcing-generator" target="_blank" rel="noopener noreferrer">Paketi GitHub'dan kontrol edin!</a></p>

<p>Repository'yi yıldızlayabilir, sorunları bildirebilir veya geliştirilmesine katkıda bulunabilirsiniz. Geribildirimleriniz ve katkılarınız, paketin daha da güçlenmesi için çok değerlidir.</p>

<h2>
    <a name="notes" href="#notes">
    </a>
    Notlar
</h2>

<p>31 Aralık 2024'te PHP 8.3 desteğini ekledim.</p>

<p>16 Şubat 2025'te güncelleme migrations'ları desteğini ekledim. 👉 <a href="https://github.com/albertoarena/laravel-event-sourcing-generator/blob/main/docs/migrations.md#generate-a-domain-using-update-migration" target="_blank" rel="noopener noreferrer">Dökümantasyonu burada okuyun</a>.</p>

<p>30 Haziran 2026'da, bu paket Packagist'te 10.000 indirme sayısını geçti — <a href="https://albertoarena.it/posts/laravel-event-sourcing-generator-10k/" target="_blank" rel="noopener noreferrer">retrospektifi okuyun</a>.</p>