Domain-Driven Design and

API Platform 3

@matarld
@chalas_r

Mathias Arlaud

@matarld
mtarld
les-tilleuls.coop

Robin Chalas

@chalas_r
les-tilleuls.coop
chalasr

DDD is not prescriptive.

@matarld
@chalas_r

DDD ≠ RAD

Domain-Driven Design is not a fast way to build software.

However, it is able to ease your life when you have to deal with complex business expectations​.”

@matarld
@chalas_r
└──   src
      ├──   Provider
      │
      ├──   Processor
      │
      ├──   Entity
      │     └──   Book.php
      │
      └──   Repository
            └──   BookRepository.php
@matarld
@chalas_r

Directory structure

Directory structure

Directory structure

@matarld
@chalas_r
└──   src
      └──   BookStore
            ├──   Application
            │     ├──   Command
            │     │     ├──   DiscountBookCommand.php
            │     │     └──   DiscountBookCommandHandler.php
            │     └──   Query
            ├──   Domain
            │     ├──   Model
            │     │     └──   Book.php
            │     └──   Repository
            │           └──   BookRepository.php
            └──   Infrastructure
                  ├──   ApiPlatform
                  └──   Doctrine

Directory structure

Directory structure

Directory structure

Domain

Models, Value objects, Events, Repositories 

Application

Application services, DTOs, Commands, Queries

Infrastructure

Controllers, Databases, Caches, Vendors
@matarld
@chalas_r

Hexagonal architecture

Domain integrity is preserved

Code is more testable

Technological decisions can be deferred

Domain is agnostic to the outside world

@matarld
@chalas_r

Hexagonal architecture

GET /books
GET /books/cheapests
PATCH /books/{id}
DELETE /books/{id}
POST /books/anonymize
POST /books/{id}/discount
[...]
namespace App\BookStore\Domain\Model;

final class Book
{
    public readonly BookId $id;

    public function __construct(
        public BookName $name,
        public BookDescription $description,
        public Author $author,
        public Price $price,
    ) {
        $this->id = new BookId();
    }
}
@matarld
@chalas_r

Reading is dreaming with open eyes...

namespace App\BookStore\Domain\Model;

final class Book
{
    public readonly BookId $id;

    public function __construct(
        public BookName $name,
        public BookDescription $description,
        public Author $author,
        public Price $price,
    ) {
        $this->id = new BookId();
    }
}
11 warnings
7  errors
#[ApiResource(operations: [
    new Get(),
    new Post('/books/{id}/discount'),
])]
final class Book
{
    public function __construct(
        #[Groups(['book:create'])]
        #[Assert\NotBlank]
        public ?BookId $id = null;
        
        #[Groups(['book:create', 'book:update'])]
        #[Assert\Positive]
        public ?Price $price = null,

        // ...
    ) {
        $this->id = $id ?? new BookId();
    }
}
@matarld
@chalas_r

Simple as sugar cookies?

namespace App\BookStore\Infrastructure\ApiPlatform\Resource;

#[ApiResource(operations: [new Get(), new Post('...')])]
final class BookResource
{
    public function __construct(
        #[ApiProperty(identifier: true)]
        #[Groups(['book:create'])]
        #[Assert\NotBlank]
        public ?Uuid $id = null;

        // ...
    ) {
    }
}
namespace App\BookStore\Domain\Model;

final class Book
{
    public readonly BookId $id;

    public function __construct(
        public BookName $name,
        public BookDescription $description,
        public Author $author,
        public Price $price,
    ) {
        // ...
    }
}

Model

@matarld
@chalas_r

From API Platform to the Domain

API Resource

@matarld
@chalas_r

The Application Layer

Command/Query bus

Application layer
@matarld
@chalas_r

Command/Query pattern

Model

Domain layer

API resource

Infrastructure layer
@matarld
@chalas_r

Find the

cheapest books.

Use case #1
@matarld
@chalas_r

Query and QueryHandler

namespace App\BookStore\Application\Query;

final class FindCheapestBooksQueryHandler
{
  public function __construct(
      private BookRepositoryInterface $bookRepository
  ) {
  }

  public function __invoke(FindCheapestBooksQuery $query)
  {
    return $this->bookRepository
      ->withCheapestsFirst()
      ->withPagination(1, $query->size);
  }
}

QueryHandler

namespace App\BookStore\Application\Query;

final class FindCheapestBooksQuery
{
    public function __construct(
        public readonly int $size = 10,
    ) {
    }
}

Query

GET /books/cheapest
@matarld
@chalas_r

API Platform providers

FindCheapestBooksQuery
Provider
new GetCollection('/books/cheapest')

Operation

@matarld
@chalas_r

Let's hold the query in the operation!

API Platform providers

GET /books/cheapest
FooProvider
CheapestBooksProvider
BarProvider
new QueryOperation(
 '/books/cheapest',
 FindCheapestBooksQuery::class,
)

"Query" operation

new GetCollection('/books/cheapest')

Operation

@matarld
@chalas_r

Can we

do better?

Spoiler: yes
@matarld
@chalas_r

Let's hold the provider in the operation!

Providers - the new way

GET /books/cheapest
FooProvider
CheapestBooksProvider
BarProvider
new GetCollection(
 '/books/cheapest',
 provider: CheapestBooksProvider::class,
)

Operation

new GetCollection('/books/cheapest')

Operation

@matarld
@chalas_r

Domain

Query providers' content

namespace App\BookStore\Infrastructure\ApiPlatform\State\Provider;

final class CheapestBooksProvider implements ProviderInterface
{
  /** @return list<BookResource> */
  public function provide(...): object|array|null
  {
    /** @var iterable<Book> $models */
    $models = $this->queryBus->ask(new FindCheapestBooksQuery());

    $resources = [];
    foreach ($models as $m) {
      $resources[] = BookResource::fromModel($m);
    }

    return $resources;
  }
}

Appli

Infra

@matarld
@chalas_r

Applying

a discount.

Use case #2
@matarld
@chalas_r

Command and CommandHandler

namespace App\BookStore\Application\Command;

final class DiscountBookCommandHandler
{
  public function __construct(
    private BookRepositoryInterface $bookRepository,
  ) {
  }

  public function __invoke(DiscountBookCommand $command)
  {
    // my super complex logic
  }
}

CommandHandler

namespace App\BookStore\Application\Command;

final class DiscountBookCommand
{
    public function __construct(
        public readonly Uuid $id,
        public readonly int $amount,
    ) {
    }
}

Command

@matarld
@chalas_r

Processors - the new way

POST /books/{id}/discount
DiscountBookProcessor
new Post(
  '/books/{id}/discount',
  input: DiscountBookPayload::class,
  provider: BookItemProvider::class,
  processor: DiscountBookProcessor::class,
)

Operation

new Post(
  '/books/{id}/discount',
  input: DiscountBookPayload::class,
  provider: BookItemProvider::class,
)

Operation

@matarld
@chalas_r

Domain

Command processors' content

namespace App\BookStore\Infrastructure\ApiPlatform\State\Provider;

final class DiscountBookProcessor implements ProcessorInterface
{
  /**
   * @var DiscountBookPayload $data
   * @return BookResource
   */
  public function process(...): mixed
  {
    $this->commandBus->dispatch(new DiscountBookCommand(
      id: $context['previous_data']->id,
      discountPercentage: $data->discountPercentage,
    ));
    
    $model = $this->queryBus->ask(new FindBookQuery($command->id));

    return BookResource::fromModel($model);
  }
}

Appli

Infra

@matarld
@chalas_r

Subscribing to

new books.

Use case #3
@matarld
@chalas_r

Bounded contexts

Subscription
BookStore
Payment

Hexagonal

RAD

@matarld
@chalas_r

RAD API Platform CRUD

namespace App\Subscription\Entity;

#[ApiResource(operations: [new GetCollection(), new Post()])]
#[ORM\Entity]
class Subscription
{
    public function __construct(
        #[ApiProperty(identifier: true)]
        #[ORM\Id]
        #[ORM\Column(type: 'uuid', unique: true)]
        public ?Uuid $id = null,

        #[Assert\NotBlank(groups: ['create'])]
        #[Assert\Email(groups: ['create', 'Default'])]
        #[ORM\Column(name: 'name', nullable: false)]
        public ?string $email = null,
    ) {
    }
}
@matarld
@chalas_r
├──   BookStore
│   ├──   Application
│   │   ├──   Command
│   │   │   ├──   CreateSubscriptionCommand.php
│   │   │   ├──   CreateSubscriptionCommandHandler.php
│   │   │   ├──   DiscountBookCommand.php
│   │   │   ├──   DiscountBookCommandHandler.php
│   │   │   └── ...
│   │   └──   Query
│   │       ├──   FindBookQuery.php
│   │       ├──   FindBookQueryHandler.php
│   │       ├──   FindCheapestBooksQuery.php
│   │       ├──   FindCheapestBooksQueryHandler.php
│   │       └── ...
│   ├──   Domain
│   └──   Infrastructure
└──   Subscription
├──   BookStore
│   ├──   Application
│   ├──   Domain
│   │   ├──   Model
│   │   │   ├──   Book.php
│   │   │   └──   Subscription.php
│   │   └──   Repository
│   │       ├──   BookRepositoryInterface.php
│   │       └──   SubscriptionRepositoryInterface.php
│   └──   Infrastructure
└──   Subscription
├──   BookStore
└──   Subscription
    └──   Entity
        └──   Subscription.php
├──   BookStore
│   ├──   Application
│   ├──   Domain
│   └──   Infrastructure
│       └──   ApiPlatform
│           ├──   Payload
│           │   └──   DiscountBookPayload.php
│           ├──   Resource
│           │   └──   BookResource.php
│           └──   State
│               ├──   Processor
│               │   ├──   AnonymizeBooksProcessor.php
│               │   └──   DiscountBookProcessor.php
│               └──   Provider
│                   ├──   BookItemProvider.php
│                   └──   CheapestBooksProvider.php
└──   Subscription

Wrap it up

Domain

Application

Infrastructure

RAD

@matarld
@chalas_r

Wrap it up

Business hexagonal

#[ApiResource(
  operations: [
    new GetCollection(
      '/books/cheapest',
      provider: CheapestBooksProvider::class,
    ),
    new Post(
      '/books/{id}/discount',
      input: DiscountBookPayload::class,
      provider: BookItemProvider::class,
      processor: DiscountBookProcessor::class,
    ),
  ],
)]
final class BookResource

Hexagonal business

RAD CRUD

#[ApiResource(
  operations: [new Get(), new Post()],
)]
final class Subscription

@matarld
@chalas_r

And it just works!

Thanks!

[APIP Con] DDD & API-P 3

By Robin Chalas

[APIP Con] DDD & API-P 3

  • 262