Where and how to handle command (superficial) and domain validation? about php-ddd HOT 6 OPEN

    /**
     * @var int $cents
     * @Assert\NotNull()
     * @Assert\Min(min="2)
     */
    private $cents;

<?php

namespace Acme\PersonnelManagement\Application\Service\Person;

use Acme\Common\Domain\Model\BirthName;
use Acme\Common\Domain\Model\PlaceOfBirth;
use Acme\Common\Domain\Model\DateOfBirth;
use Acme\Common\Domain\Model\FirstName;
use Acme\Common\Domain\Model\LastName;
use Acme\Common\Domain\Model\PersonalName;
use Acme\Common\Domain\Model\PersonalName\NamePolicy;
use Acme\Common\Domain\Model\SocialSecurityNumber;
use Acme\Common\Domain\Model\Title;
use Acme\Common\Domain\Model\Address;
use Acme\PersonnelManagement\Domain\Model\BiographicInformation;
use Acme\Common\Domain\Model\ContactInformation;
use Acme\PersonnelManagement\Domain\Model\Person\PersonId;
use Symfony\Component\Validator\Constraints as Assert;

final class AddPerson
{
    /**
     * @var PersonId $personId
     * @Assert\NotNull()
     * @Assert\Uuid()
     */
    private $personId;

    /**
     * @var Title $title
     * @Assert\NotNull
     * @Assert\NotBlank
     * @Assert\Type(type="string")
     */
    private $title;

    /**
     * @var FirstName
     * @Assert\NotNull
     * @Assert\NotBlank
     * @Assert\Type(type="string")
     * @Assert\Regex(pattern=NamePolicy::ALLOWED_PATTERN, normalizer="trim")
     * @Assert\Regex(pattern=NamePolicy::FORBIDDEN_PATTERN, normalizer="trim", match=false)
     */
    private $firstName;

    /**
     * @var LastName $lastName
     * @Assert\NotNull
     * @Assert\NotBlank
     * @Assert\Type(type="string")
     * @Assert\Regex(pattern=NamePolicy::ALLOWED_PATTERN, normalizer="trim")
     * @Assert\Regex(pattern=NamePolicy::FORBIDDEN_PATTERN, normalizer="trim", match=false)
     */
    private $lastName;

    /**
     * @var BiographicInformation
     * @Assert\NotNull
     * @Assert\Type(type="array")
     * @Assert\Collection(
     *  fields = {
     *      "birthName" = {
     *          @Assert\NotBlank(allowNull=true),
     *          @Assert\Type(type="string")
     *      },
     *      "dateOfBirth" = {
     *          @Assert\DateTime(format="Y-m-d")
     *      },
     *      "placeOfBirth" = {
     *          @Assert\NotBlank(allowNull=true),
     *          @Assert\Type(type="string")
     *      },
     *  })
     */
    private $biographicInformation;

    /**
     * @var SocialSecurityNumber|null
     * @Assert\Type(type="string")
     */
    private $socialSecurityNumber;

    /**
     * @var ContactInformation $contactInformation
     * @Assert\NotNull,
     * @Assert\Type(type="array"),
     * @Assert\Collection(
     *  fields = {
     *      "email" = {
     *          @Assert\NotBlank(allowNull=true),
     *          @Assert\Email,
     *      },
     *      "phone" = {
     *          @Assert\NotBlank(allowNull=true),
     *          @Assert\Type(type="string")
     *      },
     *      "mobile" = {
     *          @Assert\NotBlank(allowNull=true),
     *          @Assert\Type(type="string")
     *      },
     *      "fax" = {
     *          @Assert\NotBlank(allowNull=true),
     *          @Assert\Type(type="string")
     *      },
     *  }
     * )
     */
    private $contactInformation;

    /**
     * @var Address
     * @Assert\NotNull,
     * @Assert\Type(type="array"),
     * @Assert\Collection(
     *  fields = {
     *      "street" = {
     *          @Assert\NotBlank(allowNull=true),
     *          @Assert\Type(type="string")
     *      },
     *      "postcode" = {
     *          @Assert\NotBlank(allowNull=true),
     *          @Assert\Type(type="string")
     *      },
     *      "city" = {
     *          @Assert\NotBlank(allowNull=true),
     *          @Assert\Type(type="string")
     *      },
     *      "countryCode" = {
     *          @Assert\NotBlank(allowNull=true),
     *          @Assert\Type(type="string"),
     *          @Assert\Length(min="2")
     *      },
     *  }
     * )
     */
    private $address;

    public function __construct(array $payload)
    {
        $this->personId = $payload['personId'];
        $this->title = $payload['title'];
        $this->firstName = $payload['firstName'];
        $this->lastName = $payload['lastName'];
        $this->biographicInformation = $payload['biographicInformation'];
        $this->socialSecurityNumber = $payload['socialSecurityNumber'];
        $this->contactInformation = $payload['contactInformation'];
        $this->address = $payload['address'];
    }

    public function personId(): PersonId
    {
        return PersonId::fromString($this->personId);
    }

    public function title(): Title
    {
        return Title::fromString($this->title);
    }

    public function personalName(): PersonalName
    {
        return new PersonalName(
            FirstName::fromString($this->firstName),
            null,
            LastName::fromString($this->lastName)
        );
    }

    public function biographicInformation(): BiographicInformation
    {
        return new BiographicInformation(
            null !== $this->biographicInformation['birthName'] ? BirthName::fromString($this->biographicInformation['birthName']) : null,
            null !== $this->biographicInformation['dateOfBirth'] ? DateOfBirth::fromString($this->biographicInformation['dateOfBirth']) : null,
            null !== $this->biographicInformation['placeOfBirth'] ? PlaceOfBirth::fromString($this->biographicInformation['placeOfBirth']) : null
        );
    }

    public function socialSecurityNumber(): ?SocialSecurityNumber
    {
        return null !== $this->socialSecurityNumber ? SocialSecurityNumber::fromString($this->socialSecurityNumber) : null;
    }

    public function contactInformation(): ContactInformation
    {
        return ContactInformation::fromArray($this->contactInformation);
    }

    public function address(): Address
    {
        return Address::fromArray($this->address);
    }
}

<?php

namespace Acme\Common\Domain\Model\PersonalName;

final class NamePolicy
{
    public const ALLOWED_PATTERN = "/^[\p{L}\-\.\s\']+$/u";
    public const FORBIDDEN_PATTERN = "/[\p{Lu}]{2,}/u";

    public static function isSatisfiedBy(string $name): bool
    {
        if (empty($name)) {
            return false;
        }
        // Allowed are unicode letters only and `.`, `-`, `'`, no numbers.
        if (1 !== preg_match(self::ALLOWED_PATTERN, $name)) {
            return false;
        }

        // Continuous uppercase letters are not allowed.
        if (1 === preg_match(self::FORBIDDEN_PATTERN, $name)) {
            return false;
        }

        return true;
    }
}

<?php

namespace Acme\Common\Domain\Model;

use ReflectionClass;
use Acme\Common\Domain\Model\PersonalName\Exception\NameContainsIllegalCharacters;
use Acme\Common\Domain\Model\PersonalName\NamePolicy;
use Acme\Common\Domain\Model\PersonalName\NameNormalizer;

final class FirstName
{
    /** @var string $name */
    private $name;

    private function __construct(string $aName)
    {
        $name = NameNormalizer::withString($aName);

        if (!NamePolicy::isSatisfiedBy($name)) {
            throw new NameContainsIllegalCharacters();
        }

        $this->name = $name;
    }

    public static function fromString(string $name): FirstName
    {
        return new self($name);
    }

    public static function fromPayload(string $name): FirstName
    {
        $firstNameRef = new ReflectionClass(\get_called_class());

        /** @var FirstName $firstName */
        $firstName = $firstNameRef->newInstanceWithoutConstructor();
        $firstName->name = $name;

        return $firstName;
    }

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