first version

2019-01-13 23:17:34 +01:00
commit 01277f79f2
595 changed files with 82913 additions and 0 deletions
--- a/kirby/src/Api/Collection.php
+++ b/kirby/src/Api/Collection.php
@@ -0,0 +1,124 @@
+<?php
+
+namespace Kirby\Api;
+
+use Closure;
+use Exception;
+use Kirby\Toolkit\Str;
+
+/**
+ * The Collection class is a wrapper
+ * around our Kirby Collections and handles
+ * stuff like pagination and proper JSON output
+ * for collections in REST calls.
+ */
+class Collection
+{
+    protected $api;
+    protected $data;
+    protected $model;
+    protected $select;
+    protected $view;
+
+    public function __construct(Api $api, $data = null, array $schema)
+    {
+        $this->api   = $api;
+        $this->data  = $data;
+        $this->model = $schema['model'];
+        $this->view  = $schema['view'] ?? null;
+
+        if ($data === null) {
+            if (is_a($schema['default'] ?? null, 'Closure') === false) {
+                throw new Exception('Missing collection data');
+            }
+
+            $this->data = $schema['default']->call($this->api);
+        }
+
+        if (isset($schema['type']) === true && is_a($this->data, $schema['type']) === false) {
+            throw new Exception('Invalid collection type');
+        }
+    }
+
+    public function select($keys = null)
+    {
+        if ($keys === false) {
+            return $this;
+        }
+
+        if (is_string($keys)) {
+            $keys = Str::split($keys);
+        }
+
+        if ($keys !== null && is_array($keys) === false) {
+            throw new Exception('Invalid select keys');
+        }
+
+        $this->select = $keys;
+        return $this;
+    }
+
+    public function toArray(): array
+    {
+        $result = [];
+
+        foreach ($this->data as $item) {
+            $model = $this->api->model($this->model, $item);
+
+            if ($this->view !== null) {
+                $model = $model->view($this->view);
+            }
+
+            if ($this->select !== null) {
+                $model = $model->select($this->select);
+            }
+
+            $result[] = $model->toArray();
+        }
+
+        return $result;
+    }
+
+    public function toResponse(): array
+    {
+        if ($query = $this->api->requestQuery('query')) {
+            $this->data = $this->data->query($query);
+        }
+
+        if (!$this->data->pagination()) {
+            $this->data = $this->data->paginate([
+                'page'  => $this->api->requestQuery('page', 1),
+                'limit' => $this->api->requestQuery('limit', 100)
+            ]);
+        }
+
+        $pagination = $this->data->pagination();
+
+        if ($select = $this->api->requestQuery('select')) {
+            $this->select($select);
+        }
+
+        if ($view = $this->api->requestQuery('view')) {
+            $this->view($view);
+        }
+
+        return [
+            'code'       => 200,
+            'data'       => $this->toArray(),
+            'pagination' => [
+                'page'   => $pagination->page(),
+                'total'  => $pagination->total(),
+                'offset' => $pagination->offset(),
+                'limit'  => $pagination->limit(),
+            ],
+            'status' => 'ok',
+            'type'   => 'collection'
+        ];
+    }
+
+    public function view(string $view)
+    {
+        $this->view = $view;
+        return $this;
+    }
+}