PHP?? DDD ?? ?? ??

? ????? PHP? ??? ?? ???(DDD) ?? ?? ??? ???? ?????? ???? ???? ???? ??? ???? ???? ??? ?????. ??? ???(TaxManagerInterface)? ???? ??? ???? ?? ?? ???? ???? TaxPersistUseCase ???? ???????.

? ??? DDD ??? ?????. ? ?? ??? ??? ?? ? ?? ??? ?? ??? ?? ?????, ???? ?? ? ??? ???? ?????.

TaxPersistUseCase? ??

TaxPersistUseCase ???? ?? ??? ??? ???? ??? ?????. ? ?? ??? ??? ??? ??? ?? ?? ?? ???? ???? ????.

??? ??

namespace Domain\Application\UseCase\Order;

use Domain\Application\Entity\Order\Tax;
use Domain\Application\Gateway\Manager\Order\TaxManagerInterface;
use Domain\Application\UseCase\Order\Exception\NotFoundException;
use Domain\Application\UseCase\Order\Interfaces\TaxPersistRequestInterface;
use Domain\Application\UseCase\Order\Interfaces\TaxPersistResponseInterface;
use Domain\Exception\BadRequestException;
use Domain\Exception\FormException;
use Small\CleanApplication\Contract\UseCaseInterface;
use Small\Collection\Collection\StringCollection;
use Small\SwooleEntityManager\EntityManager\Exception\EmptyResultException;

TaxPersistUseCase ???? ?? ???? ???? ?? ?? ?????? ??? ?????. ??? ??? ????.

TaxManagerInterface : ?? ??? ???? ?? ????????.

TaxPersistRequestInterface ? TaxPersistResponseInterface: ?? ??? ?? ? ??? ?? ?????
??: BadRequestException, FormException ? NotFoundException? ?? ??? ??? ??? ??? ???? ? ??? ???.

TaxPersistUseCase ??? ??

namespace Domain\Application\UseCase\Order;

use Domain\Application\Entity\Order\Tax;
use Domain\Application\Gateway\Manager\Order\TaxManagerInterface;
use Domain\Application\UseCase\Order\Exception\NotFoundException;
use Domain\Application\UseCase\Order\Interfaces\TaxPersistRequestInterface;
use Domain\Application\UseCase\Order\Interfaces\TaxPersistResponseInterface;
use Domain\Exception\BadRequestException;
use Domain\Exception\FormException;
use Small\CleanApplication\Contract\UseCaseInterface;
use Small\Collection\Collection\StringCollection;
use Small\SwooleEntityManager\EntityManager\Exception\EmptyResultException;

• ??? ? ??? ??: ???? TaxManagerInterface? ????? ???? TaxPersistUseCase? ?? ??? ???? ?? Tax ??? ???? ? ????? ?????.
• ?? ?? ??: ?? ???? $request ??? TaxPersistRequestInterface? ????? ?????. ??? ?? ??? ??? ?? ??? ????? ???? ????? ?? ??? ??? ?????.
• ?? ?? ??: ??? ??? ?? ?? ???? getTax()? ?? $request?? ?? ??? ???? TaxManagerInterface?? applicationPersist ???? ?????. ? ??? ????? ???? ??? ???? ?? try-catch ?? ?? ??????
• EmptyResultException: ?? ???? ?? ? ?? ?? ? ??? ???? NotFoundException? ???? ??? ????.
• FormException: ?? ??? ??? ???? FormException? ???? ?? ???? StringCollection? ?????.
• ?? ???? ?? ?? ??: ?? ???? TaxPersistResponseInterface? ???? ?? ??? ??? ?????. ???? getTax() ? getMessages() ???? ???? ??? ?? Tax ??? ? ?? ???? ???? ? ????.

?? ?? ?????

?????? ? ?? ??? ???? ?? ??? ???? ?? ? ??? ???? ?????.

?? ??? ?????

? ?????? ?? ? ???? ??? ?? ?? ??? ?????.

class TaxPersistUseCase implements UseCaseInterface
{

    public function __construct(
        protected TaxManagerInterface $taxManager,
    ) {}

    public function execute(mixed $request): TaxPersistResponseInterface
    {

        if (!$request instanceof TaxPersistRequestInterface) {
            throw new BadRequestException(
                self::class . ' accepts only request instance of ' . TaxPersistRequestInterface::class
            );
        }

        $tax = $request->getTax();
        $messages = new StringCollection();

        try {
            $this->taxManager->applicationPersist($tax);
        } catch (EmptyResultException $e) {
            throw new NotFoundException($e->getMessage());
        } catch (FormException $e) {
            $messages = $e->getFormMessages();
        }

        return new class($tax, $messages) implements TaxPersistResponseInterface
        {
            public function __construct(
                protected readonly Tax $tax,
                protected readonly StringCollection $messages,
            ) {}

            public function getTax(): Tax
            {
                return $this->tax;
            }

            public function getMessages(): StringCollection
            {
                return $this->messages;
            }
        };

    }

}

• findById() ? findByName(): ? ???? ???? ID ?? ???? ??? ??? ? ????.
• applicationPersist(): ? ???? ?? ??? ???? ?????.

TaxPersistRequest?????

? ?????? TaxPersistUseCase?? ???? ?? ??? ?????.

interface TaxManagerInterface
{
    public function findById(int $id): Tax;
    public function findByName(string $name): Tax;
    public function applicationPersist(Tax $tax): self;
}

• getTax(): ? ???? ??? ?? ???? ???? ?? ??? ?? ??? ??? ?? ???? ? ??? ???. TaxPersistResponse?????
• ?? ?????? TaxPersistUseCase? ??? ???? ??? ????? ?????.

interface TaxPersistRequestInterface extends RequestInterface
{
    public function getTax(): Tax;
}

• getTax(): ??? ?? ???? ????? ??? ??? ?? null? ?????.
• getMessages(): ?? ??? ??? ?? ?? ???? ??? StringCollection? ?????.

?? ? ?? ??

??? ???? ??? ???? DDD?? ??? ??? ???.

• BadRequestException: ?? ??? ??? ??? ??? ?? ?? ?????.
• NotFoundException: ?? ?? ?? ??? ?? ? ?? ?? ?????.
• FormException: ??? ?? ??? ???? ?? ?????? StringCollection? ?? ???? ???????.

? ??? PHP?? DDD ?? ?? ??? ?? ?????. ??? ??? PHP ??? ????? ?? ?? ??? ?????!