Merge pull request #43 from GeneaLabs/laravel-5.5

Laravel 5.5

Author: mikebronner

.travis.yml

@@ -3,18 +3,18 @@ language: php
 php:
     - 7.0
     - 7.1
+    - 7.2
 
 before_script:
     - travis_retry composer self-update
     - travis_retry composer install --no-interaction --prefer-source --dev
 
 script:
-  - ./vendor/bin/phpunit --coverage-text --coverage-clover ./build/logs/clover.xml
+    - mkdir -p ./build/logs
+    - ./vendor/bin/phpunit --coverage-text --coverage-clover ./build/logs/clover.xml
 
-after_script:
-  - php vendor/bin/coveralls
-  - wget https://scrutinizer-ci.com/ocular.phar
-  - php ocular.phar code-coverage:upload --format=php-clover ./build/logs/clover.xml
+after_success:
+    - travis_retry php vendor/bin/php-coveralls -v
 
 notifications:
   webhooks:

CHANGELOG.md

@@ -4,6 +4,10 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [0.2.13] - 28 Dec 2017
+### Added
+- ability to define custom cache store in `.env` file.
+
 ## [0.2.12] - 14 Dec 2017
 ### Added
 - chainable method to disable caching of queries.

README.md

@@ -27,6 +27,22 @@ relationships. This package is the attempt to address those requirements.
 -   PHP >= 7.0.0
 -   Laravel 5.5
 
+## Installation
+```
+composer require genealabs/laravel-model-caching
+```
+
+## Configuration
+### Optional Custom Cache Store
+If you would like to use a different cache store than the default one used by
+your Laravel application, you may do so by setting the `MODEL_CACHE_STORE`
+environment variable in your `.env` file to the name of a cache store configured
+in `config/cache.php` (you can define any custom cache store base on your
+specific needs there). For example:
+```
+MODEL_CACHE_STORE=redis
+```
+
 ## Usage
 For best performance a taggable cache provider is recommended (redis,
 memcached). While this is optional, using a non-taggable cache provider will
@@ -56,7 +72,7 @@ extends `Illuminate\Foundation\Auth\User`. Overriding that would break functiona
 Not only that, but it probably isn't a good idea to cache the user model anyway,
 since you always want to pull the most up-to-date info on it.
 
-### Disabling Caching of Queries
+### Optional Disabling Caching of Queries
 **Recommendation: add this to all your seeder queries to avoid pulling in
 cached information when reseeding multiple times.**
 You can disable a given query by using `disableCache()` in the query chain, and

composer.json

@@ -9,17 +9,18 @@
         }
     ],
     "require": {
-        "php": ">=7.0.0",
         "illuminate/cache": "5.5.*",
-        "illuminate/database": "5.5.*"
+        "illuminate/database": "5.5.*",
+        "php": ">=7.0.0"
     },
     "require-dev": {
+        "codedungeon/phpunit-result-printer": "^0.4.4",
         "fzaninotto/faker": "~1.4",
         "laravel/laravel": "5.5.*",
         "mockery/mockery": "0.9.*",
         "phpmd/phpmd": "^2.6",
         "phpunit/phpunit": "5.7.*",
-        "satooshi/php-coveralls" : "*",
+        "php-coveralls/php-coveralls" : "*",
         "sebastian/phpcpd": "*"
     },
     "autoload": {
@@ -34,5 +35,12 @@
         "psr-4": {
             "GeneaLabs\\LaravelModelCaching\\Tests\\": "tests/"
         }
+    },
+    "extra": {
+        "laravel": {
+            "providers": [
+                "GeneaLabs\\LaravelModelCaching\\Providers\\Service"
+            ]
+        }
     }
 }

config/laravel-model-caching.php

@@ -0,0 +1,5 @@
+<?php
+
+return [
+    'store' => env('MODEL_CACHE_STORE'),
+];

phpunit.xml

@@ -1,14 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<phpunit backupGlobals="false"
+<phpunit
+    backupGlobals="false"
     backupStaticAttributes="false"
+    bootstrap="vendor/autoload.php"
     colors="true"
     convertErrorsToExceptions="true"
     convertNoticesToExceptions="true"
     convertWarningsToExceptions="true"
+    printerClass="Codedungeon\PHPUnitPrettyResultPrinter\Printer"
     processIsolation="false"
     stopOnFailure="false"
     syntaxCheck="false"
-    bootstrap="vendor/autoload.php"
 >
 <testsuites>
     <testsuite name="Feature">

src/CachedBuilder.php

@@ -10,8 +10,6 @@ class CachedBuilder extends EloquentBuilder
 {
     use Cachable;
 
-    protected $isCachable = true;
-
     public function avg($column)
     {
         if (! $this->isCachable) {
@@ -56,13 +54,6 @@ public function delete()
         return parent::delete();
     }
 
-    public function disableCache()
-    {
-        $this->isCachable = false;
-
-        return $this;
-    }
-
     /**
      * @SuppressWarnings(PHPMD.ShortVariable)
      */
@@ -155,16 +146,4 @@ public function sum($column)
                 return parent::sum($column);
             });
     }
-
-    protected function makeCacheKey(array $columns = ['*'], $idColumn = null) : string
-    {
-        return (new CacheKey($this->eagerLoad, $this->model, $this->query))
-            ->make($columns, $idColumn);
-    }
-
-    protected function makeCacheTags() : array
-    {
-        return (new CacheTags($this->eagerLoad, $this->model))
-            ->make();
-    }
 }

src/CachedModel.php

@@ -1,6 +1,7 @@
 <?php namespace GeneaLabs\LaravelModelCaching;
 
 use GeneaLabs\LaravelModelCaching\CachedBuilder as Builder;
+use GeneaLabs\LaravelModelCaching\Traits\Cachable;
 use Illuminate\Cache\CacheManager;
 use Illuminate\Cache\TaggableStore;
 use Illuminate\Cache\TaggedCache;
@@ -12,6 +13,8 @@
 
 abstract class CachedModel extends Model
 {
+    use Cachable;
+
     public function newEloquentBuilder($query)
     {
         if (session('genealabs-laravel-model-caching-is-disabled')) {
@@ -46,30 +49,6 @@ public static function boot()
         });
     }
 
-    public function cache(array $tags = [])
-    {
-        $cache = cache();
-
-        if (is_subclass_of($cache->getStore(), TaggableStore::class)) {
-            array_push($tags, str_slug(get_called_class()));
-            $cache = $cache->tags($tags);
-        }
-
-        return $cache;
-    }
-
-    public function disableCache() : self
-    {
-        session(['genealabs-laravel-model-caching-is-disabled' => true]);
-
-        return $this;
-    }
-
-    public function flushCache(array $tags = [])
-    {
-        $this->cache($tags)->flush();
-    }
-
     public static function all($columns = ['*'])
     {
         $class = get_called_class();

src/Providers/Service.php

@@ -0,0 +1,14 @@
+<?php namespace GeneaLabs\LaravelModelCaching\Providers;
+
+use Illuminate\Support\ServiceProvider;
+
+class Service extends ServiceProvider
+{
+    protected $defer = false;
+
+    public function boot()
+    {
+        $configPath = __DIR__ . '/../../config/laravel-model-caching.php';
+        $this->mergeConfigFrom($configPath, 'laravel-model-caching');
+    }
+}

src/Traits/Cachable.php

@@ -1,17 +1,55 @@
 <?php namespace GeneaLabs\LaravelModelCaching\Traits;
 
+use GeneaLabs\LaravelModelCaching\CacheKey;
+use GeneaLabs\LaravelModelCaching\CacheTags;
+use GeneaLabs\LaravelModelCaching\CachedModel;
 use Illuminate\Cache\TaggableStore;
 
 trait Cachable
 {
+    protected $isCachable = true;
+
     protected function cache(array $tags = [])
     {
         $cache = cache();
 
+        if (config('laravel-model-caching.store')) {
+            $cache = $cache->store(config('laravel-model-caching.store'));
+        }
+
         if (is_subclass_of($cache->getStore(), TaggableStore::class)) {
+            if (is_a($this, CachedModel::class)) {
+                array_push($tags, str_slug(get_called_class()));
+            }
+
             $cache = $cache->tags($tags);
         }
 
         return $cache;
     }
+
+    public function disableCache()
+    {
+        session(['genealabs-laravel-model-caching-is-disabled' => true]);
+        $this->isCachable = false;
+
+        return $this;
+    }
+
+    public function flushCache(array $tags = [])
+    {
+        $this->cache($tags)->flush();
+    }
+
+    protected function makeCacheKey(array $columns = ['*'], $idColumn = null) : string
+    {
+        return (new CacheKey($this->eagerLoad, $this->model, $this->query))
+            ->make($columns, $idColumn);
+    }
+
+    protected function makeCacheTags() : array
+    {
+        return (new CacheTags($this->eagerLoad, $this->model))
+            ->make();
+    }
 }