Better Definition construct from array

Author: phpfui

Tests/HydrateTest.php

@@ -0,0 +1,55 @@
+<?php
+
+/**
+ * This file is part of the PHPFUI\ConstantContact package
+ *
+ * (c) Bruce Wells
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE.md file that was distributed with this source
+ * code
+ */
+class HydrateTest extends \PHPUnit\Framework\TestCase
+	{
+	public function testHydration() : void
+		{
+		$json = '{
+    "contacts": [
+        {
+            "contact_id": "d5e4dc88-9dbf-11ef-9af2-fa163e4d7501",
+            "email_address": {
+                "address": "xxxx@mailinator.com",
+                "permission_to_send": "explicit",
+                "created_at": "2024-11-08T10:54:32Z",
+                "updated_at": "2024-11-08T10:54:32Z",
+                "opt_in_source": "Contact",
+                "opt_in_date": "2024-11-08T10:54:32Z",
+                "confirm_status": "off"
+            },
+            "first_name": "Petr",
+            "last_name": "Pavel",
+            "create_source": "Contact",
+            "created_at": "2024-11-08T10:54:32Z",
+            "updated_at": "2024-11-08T10:54:32Z"
+        }
+    ]
+}';
+		$this->assertJson($json);
+		$dataArray = \json_decode($json, true);
+		$this->assertIsArray($dataArray);
+		$this->assertIsArray($dataArray['contacts']);
+		$this->assertEquals('Petr', $dataArray['contacts'][0]['first_name']);
+		$this->assertIsArray($dataArray['contacts'][0]['email_address']);
+		$this->assertEquals('xxxx@mailinator.com', $dataArray['contacts'][0]['email_address']['address']);
+		$contacts = new \PHPFUI\ConstantContact\Definition\Contacts($dataArray);
+		$this->assertIsArray($contacts->contacts);
+		$this->assertEquals('d5e4dc88-9dbf-11ef-9af2-fa163e4d7501', $contacts->contacts[0]->contact_id);
+		$this->assertEquals('xxxx@mailinator.com', $contacts->contacts[0]->email_address->address);
+		$this->assertEquals('xxxx@mailinator.com', $contacts->contacts[0]->email_address->address);
+		$this->assertEquals('2024-11-08T10:54:32Z', $contacts->contacts[0]->created_at);
+		$newJson = $contacts->getJSON();
+		$this->assertJson($newJson);
+		$newDataArray = $contacts->toArray();
+		$this->assertEquals($dataArray, $newDataArray);
+		}
+	}

composer.json

@@ -23,7 +23,7 @@
         "roave/security-advisories": "dev-latest",
         "friendsofphp/php-cs-fixer": "^3.0",
         "symfony/yaml": "^7.0",
-        "phpstan/phpstan": "^1.8"
+        "phpstan/phpstan": "^2.0"
     },
     "autoload": {
         "psr-4": {"PHPFUI\\ConstantContact\\": "src/ConstantContact/"}

src/ConstantContact/Definition/Base.php

@@ -5,15 +5,15 @@
 abstract class Base
 	{
 	/**
-	 * @var array indexed by field name containing field type.
+	 * @var array<string, string | array> $fields indexed by field name containing field type.
 	 *
 	 * Valid types are:
 	 * - bool
 	 * - float
 	 * - int
 	 * - string
 	 * - FQN (fully qualified name) PHP class
-	 * - array&lt;FQN&gt;
+	 * - array<FQN>
 	 * - array of case sensitive string or integer enums
 	 */
 	protected static array $fields = [];
@@ -183,6 +183,13 @@ public function __set(string $field, mixed $value)
 				{
 				throw new \PHPFUI\ConstantContact\Exception\InvalidType(static::class . "::{$actualField} is of type {$type} but should be type {$expectedType}");
 				}
+			elseif (\str_starts_with($expectedType, 'PHPFUI'))
+				{
+				if (\is_array($value))
+					{
+					$value = new $expectedType($value);
+					}
+				}
 			}
 
 		if (isset(static::$minLength[$field]))