initial commit

Author: Aris

.gitignore

@@ -0,0 +1,2 @@
+vendor
+composer.lock

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Muhamad Aris
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,88 @@
+# SRC Macro
+
+**SRC Macro** merupakan package yang didalamnya terdapat kumpulan Macro untuk Laravel dan Lumen.
+
+### Cara Install
+
+- `composer require arispati/src-macro`
+
+#### Laravel 
+
+- Otomatis terdaftar oleh `Laravel Package Discovery`
+
+#### Lumen
+
+- Daftarkan service provider di `bootstrap/app.php`
+	```php
+	$app->register(Arispati\SrcMacro\ServiceProvider::class);
+	``` 
+
+### Macro yang tersedia
+
+- **Database - Query Builder**
+	- [onSearch](#dqb-onSearch)
+	- [onSort](#dqb-onSort)
+	- [onFilter](#dqb-onFilter)
+
+### Cara Penggunaan
+
+- <a name="dqb-onSearch"></a> **onSearch**
+
+    Pencarian berdasarkan kolom yang sudah ditetapkan
+
+	```php
+	onSearch(
+		array  $columns  = [],
+		// default query param dari front-end
+		string  $searchParam  =  'search'
+	)
+	```
+
+	contoh:
+	
+    ```php
+	$query = DB::table('namaTabel')->onSearch([
+		'namaTabel.id', 'nama'
+	])
+	```
+
+- <a name="dqb-onSort"></a> **onSort**
+
+    Order hasil query berdasarkan kolom yang sudah ditetapkan
+
+	```php
+	onSort(
+		array  $columns  = [],
+		// default query param dari front-end
+		string  $sortParam  =  'sort',
+		string  $sortTypeParam  =  'sort_type'
+	)
+	```
+
+	contoh:
+	
+    ```php
+	$query = DB::table('namaTabel')->onSort([
+		'id',
+		// dari query param => kolom pada query
+		'nama' => 'namaTabel.nama'
+	])
+	```
+
+- <a name="dqb-onFilter"></a> **onFilter**
+
+    Filter query berdasarkan kolom dan value
+
+	```php
+	onFilter(array  $columns) // kolom harus ditetapkan
+	```
+
+	contoh:
+	
+    ```php
+	$query = DB::table('namaTabel')->onFilter([
+		'id',
+		// dari query param => kolom pada query
+		'nama' => 'namaTabel.nama'
+	])
+	```

composer.json

@@ -0,0 +1,44 @@
+{
+    "name": "arispati/src-macro",
+    "description": "Kumpulan Macro untuk SRC",
+    "license": "MIT",
+    "keywords": [
+        "arispati",
+        "src-macro"
+    ],
+    "authors": [
+        {
+            "name": "Muhamad Aris",
+            "email": "masarispati@gmail.com"
+        }
+    ],
+    "require": {
+        "illuminate/support": ">= 5.8 < 7.0",
+        "illuminate/database": ">= 5.8 < 7.0"
+    },
+    "require-dev": {
+        "squizlabs/php_codesniffer": "3.*"
+    },
+    "suggest": {
+        "spatie/laravel-collection-macros": "A set of useful Laravel collection macros."
+    },
+    "autoload": {
+        "psr-4": {
+            "Arispati\\SrcMacro\\": "src"
+        }
+    },
+    "scripts": {
+        "cs": "phpcs --standard=PSR12 src/"
+    },
+    "config": {
+        "sort-packages": true
+    },
+    "extra": {
+        "laravel": {
+            "providers": [
+                "Arispati\\SrcMacro\\ServiceProvider"
+            ]
+        }
+    },
+    "minimum-stability": "stable"
+}

src/Macros/Database/QueryBuilder/OnFilter.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Arispati\SrcMacro\Macros\Database\QueryBuilder;
+
+use Illuminate\Database\Query\Builder;
+
+Builder::macro('onFilter', function (array $columns) {
+    if (count($columns)) {
+        foreach ($columns as $alias => $column) {
+            if (app('request')->filled($alias)) {
+                $this->where($column, app('request')->get($alias));
+            } elseif (app('request')->filled($column)) {
+                $this->where($column, app('request')->get($column));
+            }
+        }
+    }
+
+    return $this;
+});

src/Macros/Database/QueryBuilder/OnSearch.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace Arispati\SrcMacro\Macros\Database\QueryBuilder;
+
+use Illuminate\Database\Query\Builder;
+
+Builder::macro('onSearch', function (array $columns = [], string $searchParam = 'search') {
+    if (app('request')->filled($searchParam) && count($columns)) {
+        $this->where(function ($query) use ($columns, $searchParam) {
+            foreach ($columns as $column) {
+                $query->orWhere($column, 'like', '%' . app('request')->get($searchParam) . '%');
+            }
+        });
+    }
+
+    return $this;
+});

src/Macros/Database/QueryBuilder/OnSort.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace Arispati\SrcMacro\Macros\Database\QueryBuilder;
+
+use Illuminate\Database\Query\Builder;
+
+Builder::macro('onSort', function (
+    array $columns = [],
+    string $sortParam = 'sort',
+    string $sortTypeParam = 'sort_type'
+) {
+    if (app('request')->filled($sortParam)) {
+        $sortParams = explode(',', app('request')->get($sortParam));
+        $order      = app('request')->filled($sortTypeParam)
+            ? app('request')->get($sortTypeParam)
+            : 'asc';
+
+        foreach ($sortParams as $column) :
+            if (count($columns)) {
+                if (! is_numeric($column) && isset($columns[$column])) {
+                    $this->orderBy($columns[$column], $order);
+                } elseif (in_array($column, $columns)) {
+                    $this->orderBy($column, $order);
+                }
+            } else {
+                $this->orderBy($column, $order);
+            }
+        endforeach;
+    }
+
+    return $this;
+});

src/ServiceProvider.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace Arispati\SrcMacro;
+
+use Illuminate\Support\Collection;
+use Illuminate\Support\ServiceProvider as BaseServiceProvider;
+
+class ServiceProvider extends BaseServiceProvider
+{
+    /**
+     * Register the service provider.
+     *
+     * @return void
+     */
+    public function register()
+    {
+        Collection::make(glob(__DIR__ . '/Macros/Database/QueryBuilder/*.php'))->mapWithKeys(function ($path) {
+            return [$path => pathinfo($path, PATHINFO_FILENAME)];
+        })->each(function ($macro, $path) {
+            require_once $path;
+        });
+    }
+}