รูปแบบโมเดลโดเมน

ภาพรวม

รูปแบบโดเมนโมเดลแสดงถึงแนวคิดทางธุรกิจ กฎเกณฑ์ และตรรกะของแอปพลิเคชันของคุณ ในการพัฒนาโมดูล XOOPS โมเดลโดเมนจะสรุปองค์กรธุรกิจหลักและพฤติกรรมของพวกเขา

เอนทิตีและออบเจ็กต์มูลค่า

เอนทิตี

เอนทิตีมีเอกลักษณ์และวงจรชีวิต:

<?php

declare(strict_types=1);

namespace XoopsModules\MyModule\Entity;

use XoopsModules\MyModule\ValueObject\ArticleId;

final class Article
{
    private bool $isNew = true;

    public function __construct(
        private ArticleId $id,
        private string $title,
        private string $content,
        private int $authorId,
        private int $categoryId,
        private ArticleStatus $status,
        private \DateTimeImmutable $createdAt,
        private ?\DateTimeImmutable $updatedAt = null
    ) {}

    public static function create(
        string $title,
        string $content,
        int $authorId,
        int $categoryId
    ): self {
        return new self(
            id: ArticleId::generate(),
            title: $title,
            content: $content,
            authorId: $authorId,
            categoryId: $categoryId,
            status: ArticleStatus::DRAFT,
            createdAt: new \DateTimeImmutable()
        );
    }

    public function publish(): void
    {
        if ($this->status === ArticleStatus::PUBLISHED) {
            throw new \DomainException('Article is already published');
        }

        $this->status = ArticleStatus::PUBLISHED;
        $this->updatedAt = new \DateTimeImmutable();
    }

    public function updateContent(string $title, string $content): void
    {
        $this->title = $title;
        $this->content = $content;
        $this->updatedAt = new \DateTimeImmutable();
    }

    // Getters...
    public function getId(): ArticleId { return $this->id; }
    public function getTitle(): string { return $this->title; }
    public function getContent(): string { return $this->content; }
    public function getStatus(): ArticleStatus { return $this->status; }
    public function isNew(): bool { return $this->isNew; }

    public function markAsPersisted(): void
    {
        $this->isNew = false;
    }
}

วัตถุอันทรงคุณค่า

วัตถุค่าไม่เปลี่ยนรูปและเปรียบเทียบตามมูลค่า:

<?php

declare(strict_types=1);

namespace XoopsModules\MyModule\ValueObject;

final class ArticleId
{
    private function __construct(
        private readonly string $value
    ) {}

    public static function generate(): self
    {
        return new self(\Xmf\Ulid::generate());
    }

    public static function fromString(string $value): self
    {
        if (empty($value)) {
            throw new \InvalidArgumentException('ArticleId cannot be empty');
        }
        return new self($value);
    }

    public function toString(): string
    {
        return $this->value;
    }

    public function equals(self $other): bool
    {
        return $this->value === $other->value;
    }
}

มวลรวม

มวลรวมเป็นกลุ่มของวัตถุโดเมนที่ถือเป็นหน่วยเดียว:

final class Category
{
    private array $articles = [];

    public function __construct(
        private CategoryId $id,
        private string $name,
        private ?CategoryId $parentId = null
    ) {}

    public function addArticle(Article $article): void
    {
        if ($article->getCategoryId() !== $this->id->toInt()) {
            throw new \DomainException('Article does not belong to this category');
        }
        $this->articles[] = $article;
    }

    public function getArticleCount(): int
    {
        return count($this->articles);
    }
}

กิจกรรมโดเมน

บันทึกเหตุการณ์โดเมนที่สำคัญ:

final class ArticlePublishedEvent
{
    public function __construct(
        public readonly ArticleId $articleId,
        public readonly int $authorId,
        public readonly \DateTimeImmutable $publishedAt
    ) {}
}

Enums สำหรับสถานะ

ใช้ PHP 8.2+ enums สำหรับค่าสถานะประเภทปลอดภัย:

enum ArticleStatus: string
{
    case DRAFT = 'draft';
    case PENDING_REVIEW = 'pending';
    case PUBLISHED = 'published';
    case ARCHIVED = 'archived';

    public function canTransitionTo(self $newStatus): bool
    {
        return match($this) {
            self::DRAFT => in_array($newStatus, [self::PENDING_REVIEW, self::ARCHIVED]),
            self::PENDING_REVIEW => in_array($newStatus, [self::DRAFT, self::PUBLISHED]),
            self::PUBLISHED => $newStatus === self::ARCHIVED,
            self::ARCHIVED => false,
        };
    }
}

ค่าคงที่

ปกป้องกฎโดเมนภายในเอนทิตี:

final class Article
{
    public function setTitle(string $title): void
    {
        if (strlen($title) < 5) {
            throw new \DomainException('Title must be at least 5 characters');
        }
        if (strlen($title) > 255) {
            throw new \DomainException('Title cannot exceed 255 characters');
        }
        $this->title = $title;
    }

    public function archive(): void
    {
        if ($this->status === ArticleStatus::DRAFT) {
            throw new \DomainException('Cannot archive a draft article');
        }
        $this->status = ArticleStatus::ARCHIVED;
    }
}

แนวทางปฏิบัติที่ดีที่สุด

1. Rich Domain Model - ใส่พฤติกรรมในเอนทิตี ไม่ใช่บริการ
2. วัตถุมูลค่าที่ไม่เปลี่ยนรูป - วัตถุมูลค่าไม่ควรเปลี่ยนแปลง
3. วิธีการของโรงงาน - ใช้วิธีการของโรงงานแบบคงที่สำหรับการก่อสร้างที่ซับซ้อน
4. Guard Clauses - ตรวจสอบอินพุตที่ขอบเขตเอนทิตี
5. เหตุการณ์โดเมน - บันทึกการเปลี่ยนแปลงสถานะที่สำคัญ
6. ภาษาที่แพร่หลาย - ใช้คำศัพท์ทางธุรกิจในโค้ด

เอกสารที่เกี่ยวข้อง

• Service-Layer - บริการแอพพลิเคชั่น
• ชั้นเก็บข้อมูล - ความคงอยู่
• DTO-รูปแบบ - การถ่ายโอนข้อมูล
• เหตุการณ์-ระบบ - กิจกรรมโดเมน