first version

kirby/src/Cms/Structure.php

@@ -0,0 +1,59 @@
+<?php
+
+namespace Kirby\Cms;
+
+use Kirby\Exception\InvalidArgumentException;
+
+/**
+ * The Structure class wraps
+ * array data into a nicely chainable
+ * collection with objects and Kirby-style
+ * content with fields. The Structure class
+ * is the heart and soul of our yaml conversion
+ * method for pages.
+ *
+ * @package   Kirby Cms
+ * @author    Bastian Allgeier <bastian@getkirby.com>
+ * @link      http://getkirby.com
+ * @copyright Bastian Allgeier
+ */
+class Structure extends Collection
+{
+
+    /**
+     * Creates a new Collection with the given objects
+     *
+     * @param array $objects
+     * @param object $parent
+     */
+    public function __construct($objects = [], $parent = null)
+    {
+        $this->parent = $parent;
+        $this->set($objects);
+    }
+
+    /**
+     * The internal setter for collection items.
+     * This makes sure that nothing unexpected ends
+     * up in the collection. You can pass arrays or
+     * StructureObjects
+     *
+     * @param string $id
+     * @param array|StructureObject $object
+     */
+    public function __set(string $id, $props)
+    {
+        if (is_a($props, StructureObject::class) === true) {
+            $object = $props;
+        } else {
+            $object = new StructureObject([
+                'content'    => $props,
+                'id'         => $props['id'] ?? $id,
+                'parent'     => $this->parent,
+                'structure'  => $this
+            ]);
+        }
+
+        return parent::__set($object->id(), $object);
+    }
+}