Merge branch 'release/4.1.1'

Author: WiktorPacer

CHANGELOG.md

@@ -1,4 +1,10 @@
 # Changelog
+## v.4.1.1
+    - add functions
+        * sum()
+    - add functions to work with cache trait
+        * count()
+        * sum()
 ## v.4.1.0
     - compatibility with PHP version 8.x (updated composer.json file)
     - DateCriteria now accept "column" parameter

README.md

@@ -131,14 +131,15 @@ class ExampleController extends Controller {
 * orWhereHasMorph($relation, $types, $callback, $operator, $count)
 * whereDoesntHaveMorph($relation, $types, $callback)
 * orWhereDoesntHaveMorph($relation, $types, $callback)
+* sum($column)
 
 ##### Additional methods (Laravel only)
 * datatable() - return EloquentDataTable instance for records. In order to user with method,
 you must install suggested "yajra/laravel-datatables-oracle" package, and add "WithDatatable"
 trait in your repository of choice.
 #### Built-in criteria
 List of criteria, provider by default with this package:
-* DateCriteria - search records with given date range (by created_at field)
+* DateCriteria - search records with given date range
 * FindWhereCriteria
 * FindWhereInCriteria
 * FindWhereNotInCriteria
@@ -167,6 +168,8 @@ of choice. Trait will handle cache for methods:
 * findWhereNotIn()
 * paginate()
 * simplePaginate()
+* count()
+* sum()
 
 You can user criteria with this functions, and results will be cached.
 

src/Repositories/CoreRepository.php

@@ -667,6 +667,26 @@ public function count(array $columns = ['*']): int
         return $results;
     }
 
+    /**
+     * Retrieve the sum of the values of a given column.
+     *
+     * @param string $column
+     *
+     * @return mixed
+     *
+     * @author Wiktor Pacer
+     */
+    public function sum(string $column)
+    {
+        $this->applyCriteria();
+
+        $results = $this->getEntity()->sum($column);
+
+        $this->makeEntity();
+
+        return $results;
+    }
+
     /**
      * Paginate results.
      *

src/Repositories/Interfaces/CoreRepositoryInterface.php

@@ -424,6 +424,17 @@ public function chunk(int $limit, callable $callback, array $columns = ['*']): b
      */
     public function count(array $columns = ['*']): int;
 
+    /**
+     * Retrieve the sum of the values of a given column.
+     *
+     * @param string $column
+     *
+     * @return mixed
+     *
+     * @author Wiktor Pacer
+     */
+    public function sum(string $column);
+
     /**
      * Paginate results.
      *

src/Repositories/Traits/WithCache.php

@@ -2,9 +2,11 @@
 
 namespace PacerIT\LaravelRepository\Repositories\Traits;
 
+use Illuminate\Contracts\Container\BindingResolutionException;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Support\Collection;
 use Illuminate\Support\Facades\Cache;
+use PacerIT\LaravelRepository\Repositories\Exceptions\RepositoryEntityException;
 use PacerIT\LaravelRepository\Repositories\Interfaces\CoreRepositoryInterface;
 use ReflectionObject;
 
@@ -534,6 +536,65 @@ function () use ($perPage, $columns, $pageName, $page) {
         );
     }
 
+    /**
+     * Count results.
+     *
+     * @param array $columns
+     *
+     * @throws BindingResolutionException
+     * @throws RepositoryEntityException
+     *
+     * @return int
+     *
+     * @author Wiktor Pacer <[email protected]>
+     *
+     * @since 19/11/2019
+     */
+    public function count(array $columns = ['*']): int
+    {
+        if ($this->skipCache || !$this->cacheActive()) {
+            return parent::count($columns);
+        }
+
+        $cacheKey = $this->getCacheKey(__FUNCTION__, func_get_args());
+
+        // Store or get from cache.
+        return Cache::tags([$this->getTag()])->remember(
+            $cacheKey,
+            $this->getCacheTime(),
+            function () use ($columns) {
+                return parent::count($columns);
+            }
+        );
+    }
+
+    /**
+     * Retrieve the sum of the values of a given column.
+     *
+     * @param string $column
+     *
+     * @return int
+     *
+     * @author Wiktor Pacer
+     */
+    public function sum(string $column)
+    {
+        if ($this->skipCache || !$this->cacheActive()) {
+            return parent::sum($column);
+        }
+
+        $cacheKey = $this->getCacheKey(__FUNCTION__, func_get_args());
+
+        // Store or get from cache.
+        return Cache::tags([$this->getTag()])->remember(
+            $cacheKey,
+            $this->getCacheTime(),
+            function () use ($column) {
+                return parent::sum($column);
+            }
+        );
+    }
+
     /**
      * Try to get actual authenticated user ID.
      *