README

DDD tactical building blocks — the reusable kernel that concrete bounded contexts build on. The core (NetCode\Domain\*) is pure PHP 8.5+ (only ramsey/uuid); a thin, optional Laravel integration layer (NetCode\Domain\Laravel\*) wires the kernel into a Laravel app through an auto-discovered service provider.

Install

composer require net-code/laravel-domain

What's inside

Laravel integration (NetCode\Domain\Laravel)

Usage

Typed identifier

use NetCode\Domain\Identifier\Uuid;

final class OrderId extends Uuid {}

$id = OrderId::random();          // UUIDv7
$id->equals(OrderId::fromString((string) $id)); // true

Aggregate + domain events

use NetCode\Domain\AggregateRoot;

final class Order extends AggregateRoot
{
    public function place(): void
    {
        // ... mutate state ...
        $this->recordThat(new OrderPlaced(/* ... */));
    }
}

$events = $order->releaseEvents(); // hand to your DomainEventPublisher

Business rules via a specification

use NetCode\Domain\Rule\Specification;

Specification::check(
    new OrderMustHaveLines($order),
    new OrderMustBeUnpaid($order),
); // throws BusinessRuleException on the first broken rule

Specification::check() is a static, stateless guard — call it directly from your aggregates. There is no instance to construct, inject, or subclass.

Laravel integration

DomainServiceProvider is auto-discovered, so DomainEventPublisher resolves to LaravelDomainEventPublisher (domain events go through Laravel's dispatcher) with zero wiring. Cast a model's identifier column to its typed value object:

use Illuminate\Database\Eloquent\Model;
use NetCode\Domain\Laravel\IdentifierCast;

final class OrderModel extends Model
{
    /** @return array<string, string> */
    protected function casts(): array
    {
        return ['id' => IdentifierCast::class.':'.OrderId::class];
    }
}

Development

composer check   # pint --test + phpstan (level 8) + phpunit

License

MIT