root element

Author: František Mazura

README.md

@@ -25,4 +25,5 @@ PHP Value object for storing valid data.
   - add interface `ValueObjectInterface`
   - remove trait
   - min request PHP 7.4
-  - check null
+  - check null
+  - root element

src/AbstractValueObject.php

@@ -16,6 +16,11 @@
 
 abstract class AbstractValueObject implements ValueObjectInterface
 {
+	/**
+	 * it is used if value object contains single value object
+	 */
+	const ROOT = "root";
+
 	private array $touched = [];
 	private array $ignoredAttrs = ["ignoredAttrs", "touched"];
 
@@ -61,6 +66,9 @@ public function init($data): self
 		foreach ($data as $name => $item) {
 			$setter = "set" . ucfirst($name);
 			$value = $data[$name] ?? null;
+			if ($name == self::ROOT) {
+				$value = $data;
+			}
 			$this->setTouched($name);
 			try {
 				if (method_exists($this, $setter)) {

tests/ValueObjectTest.php

@@ -6,6 +6,7 @@
 use OGSoft\ValueObjects\Exceptions\ValidatorException;
 use PHPUnit\Framework\TestCase;
 use Tests\ValueObjects\CarValueObject;
+use Tests\ValueObjects\TireValueObject;
 
 final class ValueObjectTest extends TestCase
 {
@@ -64,5 +65,14 @@ public function testNull()
 		$car->init($data);
 		$this->assertTrue(true);
 	}
+
+	public function testRoot()
+	{
+		$data = ["winter" => true];
+
+		$tire = new TireValueObject();
+		$tire->init($data);
+		$this->assertEquals($data, $tire->toArray());
+	}
 }
 

tests/ValueObjects/RootValueObject.php

@@ -0,0 +1,31 @@
+<?php
+
+
+namespace Tests\ValueObjects;
+
+
+class RootValueObject
+{
+	/**
+	 * @var TireValueObject
+	 */
+	protected $root;
+
+	/**
+	 * @return TireValueObject
+	 */
+	public function getRoot(): TireValueObject
+	{
+		return $this->root;
+	}
+
+	/**
+	 * @param TireValueObject $root
+	 * @return RootValueObject
+	 */
+	public function setRoot(TireValueObject $root): RootValueObject
+	{
+		$this->root = $root;
+		return $this;
+	}
+}