[PHP] [User Modelling Example] Replace Data Value with Object for Locale final state where all clients call to the new API

Author: JavierCane

examples/php/php-user_modelling-02_value_objects/src/User.php

@@ -9,15 +9,18 @@ final class User
     private Locale $locale;
     private Age $age;
 
-    public function __construct(string $locale, Age $age)
+    private function __construct(Locale $locale, Age $age)
     {
-        $this->locale = new Locale($locale);
+        $this->locale = $locale;
         $this->age    = $age;
     }
 
-    public static function signUp(Locale $locale, Age $age)
+    public static function signUp(Locale $locale, Age $age): User
     {
-        return new self($locale->value(), $age);
+        // …
+        // Any kind of additional logic such as recording domain events, checking overall Aggregate consistency, etc.
+        // …
+        return new self($locale, $age);
     }
 
     public function understandSpanish(): bool

examples/php/php-user_modelling-02_value_objects/tests/UserTest.php

@@ -22,23 +22,23 @@ public function should_detect_spanish_from_spain_as_spanish_language(): void
     /** @test */
     public function should_not_detect_english_from_great_britain_as_spanish_language(): void
     {
-        $user = new User("en_GB", new Age(20));
+        $user = User::signUp(new Locale("en_GB"), new Age(20));
 
         self::assertFalse($user->understandSpanish());
     }
 
     /** @test */
     public function should_detect_underage_users_until_18_years_old(): void
     {
-        $user = new User("en_GB", new Age(17));
+        $user = User::signUp(new Locale("en_GB"), new Age(17));
 
         self::assertTrue($user->isUnderage());
     }
 
     /** @test */
     public function should_not_detect_underage_users_starting_from_18_years_old(): void
     {
-        $user = new User("en_GB", new Age(18));
+        $user = User::signUp(new Locale("en_GB"), new Age(18));
 
         self::assertFalse($user->isUnderage());
     }