🧱 Не тащи string $email по всему приложению

Примитив не защищает свои инварианты. string $email может быть пустым, может быть «не email», и каждый метод, который его принимает, обязан валидировать заново или молча доверять.

// ❌ валидность email — на совести каждого вызывающего
public function register(string $email, string $phone): void { ... }
// где-то проверили, где-то забыли, где-то проверили по-другому

Value Object переносит правило внутрь типа: невозможно создать невалидный объект.

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

    public static function fromString(string $raw): self
    {
        $email = filter_var($raw, FILTER_VALIDATE_EMAIL);
        if ($email === false) {
            throw new InvalidArgumentException("Невалидный email: $raw");
        }
        return new self(strtolower($email));
    }
}

// теперь сигнатура — это контракт
public function register(Email $email, Phone $phone): void { ... }

🔵 Что ты получаешь

→ Если в метод пришёл Email, он точно валиден, проверять больше негде и незачем.
→ Нормализация (нижний регистр, тримминг) в одном месте, а не в пятнадцати.
→ readonly гарантирует, что после создания значение не мутирует.
→ Тип говорит за себя: register(Email, Phone) читается без документации.

Value Object уместен везде, где у значения есть правила: деньги, email, телефон, координаты, проценты, диапазоны дат. Везде, где ты ловил баг «а сюда пришла пустая строка», там просился VO.

🐸 Библиотека пхпшника