DTO usage example

1-Simple-dto.md

<?php

declare(strict_types=1);

namespace App\Application\Query\Article\Cms;

use App\Application\Query\QueryInterface;

class ArticleQuery implements QueryInterface
{
    /** @var int */
    private $offset;

    /** @var int */
    private $size;

    /** @var null|string */
    private $category;

    /** @var null|string */
    private $publishDate;

    /** @var bool */
    private $published;

    /** @var null|string */
    private $searchTerm;

    public function __construct(
        int $offset,
        int $size,
        ?string $category,
        ?string $publishDate,
        bool $published,
        ?string $searchTerm
    ) {
        $this->offset = $offset;
        $this->size = $size;
        $this->category = $category;
        $this->publishDate = $publishDate;
        $this->published = $published;
        $this->searchTerm = $searchTerm;
    }

    public function getOffset(): int
    {
        return $this->offset;
    }

    public function getSize(): int
    {
        return $this->size;
    }

    public function getCategory(): ?string
    {
        return $this->category;
    }

    public function getPublishDate(): ?string
    {
        return $this->publishDate;
    }

    public function isPublished(): bool
    {
        return $this->published;
    }

    public function getSearchTerm(): ?string
    {
        return $this->searchTerm;
    }
}

2-php74-dto.md

<?php

declare(strict_types=1);

namespace App\Application\Query\Article\Cms;

use App\Application\Query\QueryInterface;

class ArticleQuery implements QueryInterface
{
    private int $offset;
    private int $size;
    private ?string $categoryId;
    private ?string $publishDate;
    private bool $published;
    private ?string $searchTerm;

    public function __construct(
        int $offset,
        int $size,
        ?string $categoryId,
        ?string $publishDate,
        bool $published,
        ?string $searchTerm
    ) {
        $this->offset = $offset;
        $this->size = $size;
        $this->categoryId = $categoryId;
        $this->publishDate = $publishDate;
        $this->published = $published;
        $this->searchTerm = $searchTerm;
    }


    public function getOffset(): int
    {
        return $this->offset;
    }

    public function getSize(): int
    {
        return $this->size;
    }

    public function getCategory(): ?string
    {
        return $this->category;
    }

    public function getPublishDate(): ?string
    {
        return $this->publishDate;
    }

    public function isPublished(): bool
    {
        return $this->published;
    }

    public function getSearchTerm(): ?string
    {
        return $this->searchTerm;
    }
}

3-php74-immutable-dto.md

<?php

declare(strict_types=1);

namespace App\Application\Query\Article\Cms;

use App\Application\Query\QueryInterface;

/** @psalm-immutable */
class ArticleQuery implements QueryInterface
{
    public int $offset;
    public int $size;
    public ?string $categoryId;
    public ?string $publishDate;
    public bool $published;
    public ?string $searchTerm;

    public function __construct(
        int $offset,
        int $size,
        ?string $categoryId,
        ?string $publishDate,
        bool $published,
        ?string $searchTerm
    ) {
        $this->offset = $offset;
        $this->size = $size;
        $this->categoryId = $categoryId;
        $this->publishDate = $publishDate;
        $this->published = $published;
        $this->searchTerm = $searchTerm;
    }
-
-    public function getOffset(): int
-    {
-        return $this->offset;
-    }
-
-    public function getSize(): int
-    {
-        return $this->size;
-    }
-
-    public function getCategory(): ?string
-    {
-        return $this->category;
-    }
-
-    public function getPublishDate(): ?string
-    {
-        return $this->publishDate;
-    }
-
-    public function isPublished(): bool
-    {
-        return $this->published;
-    }
-
-    public function getSearchTerm(): ?string
-    {
-        return $this->searchTerm;
-    }
}