- Added some SearchRequest attributes ; now it's even simpler to add searchable fields

- Began decoupling of QueryBuilder from native MySQL method ; some works needs to be done on for the Repository object splitting also.

src/SearchRequest/Attribute/SearchEqual.php

@@ -0,0 +1,6 @@
+<?php
+
+namespace Ulmus\SearchRequest\Attribute;
+
+#[\Attribute(\Attribute::TARGET_PROPERTY)]
+class SearchEqual extends SearchWhere {}

src/SearchRequest/Attribute/SearchGroupBy.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Ulmus\SearchRequest\Attribute;
+
+use Ulmus\SearchRequest\SearchMethodEnum;
+
+#[\Attribute(\Attribute::TARGET_PROPERTY)]
+class SearchGroupBy extends SearchParameter
+{
+    public function __construct(
+        public ? string $parameter = null,
+        public ? string $field = null,
+        public bool $toggle = false,
+        public SearchMethodEnum $method = SearchMethodEnum::GroupBy,
+    ) {}
+}

src/SearchRequest/Attribute/SearchLike.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Ulmus\SearchRequest\Attribute;
+
+use Ulmus\SearchRequest\SearchMethodEnum;
+
+#[\Attribute(\Attribute::TARGET_PROPERTY)]
+class SearchLike extends SearchParameter
+{
+    public function __construct(
+        public ? string $parameter = null,
+        public ? string $field = null,
+        public bool $toggle = false,
+        public SearchMethodEnum $method = SearchMethodEnum::Like,
+    ) {}
+}

src/SearchRequest/Attribute/SearchOrderBy.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Ulmus\SearchRequest\Attribute;
+
+use Ulmus\SearchRequest\SearchMethodEnum;
+
+#[\Attribute(\Attribute::TARGET_PROPERTY)]
+class SearchOrderBy extends SearchParameter
+{
+    public function __construct(
+        public ? string $parameter = null,
+        public ? string $field = null,
+        public bool $toggle = false,
+        public SearchMethodEnum $method = SearchMethodEnum::OrderByAsc,
+    ) {}
+}

src/SearchRequest/Attribute/SearchParameter.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Ulmus\SearchRequest\Attribute;
+
+use Ulmus\SearchRequest\SearchMethodEnum;
+
+#[\Attribute(\Attribute::TARGET_PROPERTY)]
+class SearchParameter
+{
+    public function __construct(
+        public ? string $parameter = null,
+        public ? string $field = null,
+        public bool $toggle = false,
+        public SearchMethodEnum $method = SearchMethodEnum::Manual,
+    ) {}
+}

src/SearchRequest/Attribute/SearchRequestParameter.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace Ulmus\SearchRequest\Attribute;
+
+use Ulmus\SearchRequest\SearchMethodEnum;
+
+#[\Attribute(\Attribute::TARGET_CLASS)]
+class SearchRequestParameter
+{
+    public function __construct(
+        public string $class,
+    ) {}
+}

src/SearchRequest/Attribute/SearchWhere.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Ulmus\SearchRequest\Attribute;
+
+use Ulmus\SearchRequest\SearchMethodEnum;
+
+#[\Attribute(\Attribute::TARGET_PROPERTY)]
+class SearchWhere extends SearchParameter
+{
+    public function __construct(
+        public ? string $parameter = null,
+        public ? string $field = null,
+        public bool $toggle = false,
+        public SearchMethodEnum $method = SearchMethodEnum::Where,
+    ) {}
+}

src/SearchRequest/SearchMethodEnum.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace Ulmus\SearchRequest;
+
+enum SearchMethodEnum
+{
+    case Manual;
+    case Where;
+    case Like;
+    case LikeLeft;
+    case LikeRight;
+    case OrderByAsc;
+    case OrderByDesc;
+    case GroupBy;
+}

src/SearchRequest/SearchRequest.php

@@ -0,0 +1,41 @@
+<?php
+
+namespace Ulmus\SearchRequest;
+
+use Psr\Http\Message\ServerRequestInterface;
+use Ulmus\Repository;
+
+class SearchRequest implements SearchRequestInterface
+{
+    use SearchRequestPaginationTrait, SearchRequestFromRequestTrait;
+
+    public function filter(Repository $repository) : Repository
+    {
+        return $repository;
+    }
+
+    public function wheres() : iterable
+    {
+        return array_filter($this->wheres + [
+        ], fn($i) => ! is_null($i) ) + [ ];
+    }
+
+    public function likes(): iterable
+    {
+        return array_filter($this->likes + [
+        ], fn($i) => ! is_null($i) ) + [];
+    }
+
+    public function groups(): iterable
+    {
+        return array_filter($this->groups + [
+        ], fn($e) => ! is_null($e)  && $e !== "" );
+    }
+
+    public function orders(): iterable
+    {
+        return array_filter($this->orders + [
+        ], fn($e) => ! is_null($e)  && $e !== "" );
+    }
+
+}

src/SearchRequest/SearchRequestFromRequestTrait.php

@@ -0,0 +1,83 @@
+<?php
+
+namespace Ulmus\SearchRequest;
+
+use Psr\Http\Message\ServerRequestInterface;
+use Ulmus\SearchRequest\Attribute\SearchParameter;
+use Ulmus\SearchRequest\Attribute\SearchWhere;
+
+trait SearchRequestFromRequestTrait
+{
+    protected array $wheres = [];
+
+    protected array $likes = [];
+
+    protected array $groups = [];
+
+    protected array $orders = [];
+
+    public function fromRequest(ServerRequestInterface $request)
+    {
+        $get = new \ArrayObject(array_filter($request->getQueryParams(), function($i) { return $i !== ""; }));
+
+        $this->page = $get->offsetExists('page') ? $get['page'] : 1;
+
+        $classReflection = new \ReflectionClass($this);
+
+        foreach($classReflection->getProperties() as $property) {
+
+            foreach($property->getAttributes() as $attributeReflection) {
+                $attribute = $attributeReflection->newInstance();
+
+                # We can't simply pass this class as first arguments of getAttributes() since it do not check for inheritance
+                if (! $attribute instanceof Attribute\SearchParameter) {
+                    continue;
+                }
+
+                $propertyName =  $property->getName();
+                $fieldName =  $attribute->field ?? $property->getName();
+                $queryParamName = $attribute->parameter ?? $property->getName();
+
+                if ($attribute->toggle) {
+                    $this->$propertyName = $get->offsetExists('rental');
+                } else {
+                    $this->$propertyName = $get->offsetExists($queryParamName) ? $get[$queryParamName] : null;
+                }
+
+                $field = (string) $fieldName;
+
+                switch ($attribute->method) {
+                    case SearchMethodEnum::Where:
+                        $this->wheres[$field] = $this->$propertyName;
+                        break;
+
+                    case SearchMethodEnum::Like:
+                        $this->likes[$field] = "%{$this->$propertyName}%";
+                        break;
+
+                    case SearchMethodEnum::LikeLeft:
+                        $this->likes[$field] = "%{$this->$propertyName}";
+                        break;
+
+                    case SearchMethodEnum::LikeRight:
+                        $this->likes[$field] = "{$this->$propertyName}%";
+                        break;
+
+                    case SearchMethodEnum::OrderByAsc:
+                        $this->orders[$field] = "ASC";
+                        break;
+
+                    case SearchMethodEnum::OrderByDesc:
+                        $this->orders[$field] = "DESC";
+                        break;
+
+                    case SearchMethodEnum::GroupBy:
+                        $this->groups[$field] = "DESC";
+                        break;
+                }
+            }
+        }
+
+        return $this;
+    }
+}