Version 3

.github/workflows/run-tests.yml

@@ -12,32 +12,13 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest]
-        php: [8.0, 8.1, 8.2, 8.3, 8.4, 8.5]
-        laravel: ['8.*', '9.*', '10.*', '11.*', '12.*']
+        php: [8.3, 8.4, 8.5]
+        laravel: ['12.*']
         coverage: [none]
         dependency-version: [prefer-stable]
         include:
-          - laravel: 10.*
-            testbench: 8.*
-          - laravel: 9.*
-            testbench: 7.*
-          - laravel: 8.*
-            testbench: 6.*
-          - laravel: 11.*
-            testbench: 9.*
           - laravel: 12.*
             testbench: 10.*
-        exclude:
-          - laravel: 10.*
-            php: 8.0
-          - laravel: 11.*
-            php: 8.0
-          - laravel: 11.*
-            php: 8.1
-          - laravel: 12.*
-            php: 8.0
-          - laravel: 12.*
-            php: 8.1
 
     name: P${{ matrix.php }} - L${{ matrix.laravel }} - ${{ matrix.os }} - ${{ matrix.dependency-version }}
 
@@ -65,11 +46,7 @@ jobs:
 
       - name: Install dependencies
         run: |
-          if [ "${{ matrix.laravel }}" = "11.*" ] && [ "${{ matrix.php }}" = "8.5" ]; then
-          composer require "phpunit/phpunit:^12" "laravel/framework:${{ matrix.laravel }}" "orchestra/testbench:${{ matrix.testbench }}" --no-interaction --no-update
-          fi
           composer require "laravel/framework:${{ matrix.laravel }}" "orchestra/testbench:${{ matrix.testbench }}" --no-interaction --no-update
-
           composer update --${{ matrix.dependency-version }} --prefer-dist --no-interaction --no-suggest
 
       - name: Execute tests

README.md

@@ -32,10 +32,17 @@ Therefore, if you decide to use my packages, please kindly consider making a don
 
 ## Requirements:
 
-- PHP 8.0.2 or higher
-- Laravel 8.40.0 or higher
+- PHP 8.3 or higher
+- Laravel 12 or higher
 
 
+To install LaraCache on older Laravel/PHP versions, consult the compatibility table below to determine which LaraCache release to use:
+
+| Laravel Version | PHP Version   | LaraCache Version                                           |
+|-----------------|---------------|-------------------------------------------------------------|
+| 8.40.0 — 12.x   | 8.0.2 — 8.5   | [2.5.2](https://github.com/mostafaznv/laracache/tree/2.5.2) |
+| 12.x            | 8.3 or higher | master (3.x)                                                |
+
 ## Installation
 
 1. ##### Install the package via composer:

composer.json

@@ -26,14 +26,13 @@
     "minimum-stability": "dev",
     "prefer-stable": true,
     "require": {
-        "php": "^8.0.2",
-        "laravel/framework": "^8.40.0|^9.0|^10.0|^11.0|^12.0"
+        "php": "^8.3",
+        "laravel/framework": "^12.0"
     },
     "require-dev": {
-        "phpunit/phpunit": "^9.5.10|^10.0|^11.5.3|^12.4.4",
-        "orchestra/testbench": "^6.0|^7.0|^8.0|^9.0|^10.0",
-        "pestphp/pest": "^1.20|^2.34|^3.7|^4.1",
-        "spatie/pest-plugin-test-time": "^1.0|^2.1"
+        "orchestra/testbench": "^10.0",
+        "pestphp/pest": "^3.7|^4.1",
+        "spatie/pest-plugin-test-time": "^2.1"
     },
     "autoload": {
         "psr-4": {

config/config.php

@@ -6,10 +6,9 @@
     | Cache Driver
     |--------------------------------------------------------------------------
     |
-    | The default mechanism for handling cache storage.
-    |
-    | If you keep this option null, LaraCache will use the default cache
-    | storage from config/cache.php
+    | Defines the cache driver to be used by LaraCache.
+    | If set to null, LaraCache will fall back to the application's default
+    | cache store configured in `config/cache.php`.
     |
     */
 
@@ -20,8 +19,9 @@
     | Cache List Key
     |--------------------------------------------------------------------------
     |
-    | LaraCache uses a separate list to store name of all entities. using these
-    | keys, we can perform some actions to all entities (such as update or delete them)
+    | Key used by LaraCache to maintain a registry of entity names. This list
+    | enables operations across all registered entities (for example, bulk
+    | updates or deletions).
     |
     */
 
@@ -32,8 +32,8 @@
     | First Day of Week
     |--------------------------------------------------------------------------
     |
-    | In some regions, saturday is first day of the week and in another regions
-    | it may be different
+    | Specifies the first day of the week. This value may vary by region.
+    | Uses a Carbon constant for clarity and consistency.
     |
     */
 
@@ -44,8 +44,8 @@
     | Last Day of Week
     |--------------------------------------------------------------------------
     |
-    | In some regions, friday is last day of the week and in another regions
-    | it may be different
+    | Specifies the last day of the week. Adjust this value to match your
+    | regional or business conventions.
     |
     */
 
@@ -56,7 +56,8 @@
     | Queue
     |--------------------------------------------------------------------------
     |
-    | Sometimes caching process is very heavy, so you have to queue the process and do it in background.
+    | Configuration for background processing. Use queues to offload heavy or
+    | long-running cache operations. Set `status` to true to enable queuing.
     |
     */
 
@@ -71,7 +72,9 @@
     | Debounce
     |--------------------------------------------------------------------------
     |
-    | If you want to debounce the cache refresh process, you can enable this option.
+    | Debounce settings control deferred refresh behavior to prevent frequent
+    | or redundant cache refreshes. `wait` is specified in seconds. Debounce
+    | can be processed via a dedicated queue configuration below.
     |
     */
 
@@ -90,9 +93,9 @@
     | Groups
     |--------------------------------------------------------------------------
     |
-    | You can group some entities and perform some actions on them.
+    | Define logical groups of entities to perform collective operations.
+    | Example structure:
     |
-    | Example:
     | 'groups' => [
     |    'group-1' => [
     |        [

src/Actions/DeleteCacheAction.php

@@ -4,6 +4,8 @@
 
 use Mostafaznv\LaraCache\Actions\Support\UpdateDeleteCache;
 use Mostafaznv\LaraCache\DTOs\CommandData;
+use Mostafaznv\LaraCache\Traits\LaraCache;
+
 
 class DeleteCacheAction extends UpdateDeleteCache
 {
@@ -24,7 +26,7 @@ public function run(CommandData $data): void
     }
 
     /**
-     * @param \Mostafaznv\LaraCache\Traits\LaraCache $model
+     * @param LaraCache $model
      * @return void
      */
     private function deleteAll(string $model): void
@@ -39,7 +41,7 @@ private function deleteAll(string $model): void
     }
 
     /**
-     * @param \Mostafaznv\LaraCache\Traits\LaraCache $model
+     * @param LaraCache $model
      * @param array $entities
      * @return void
      */

src/Actions/DeleteGroupCacheAction.php

@@ -4,6 +4,7 @@
 
 use Mostafaznv\LaraCache\Actions\Support\UpdateDeleteCache;
 
+
 class DeleteGroupCacheAction extends UpdateDeleteCache
 {
     public function run(string $group): void

src/Actions/Support/UpdateDeleteCache.php

@@ -8,6 +8,7 @@
 use Mostafaznv\LaraCache\Exceptions\CacheGroupNotExist;
 use Mostafaznv\LaraCache\Exceptions\CacheGroupValueIsNotValid;
 
+
 abstract class UpdateDeleteCache
 {
     public function __construct(protected ?Command $console) {}

src/Actions/UpdateCacheAction.php

@@ -4,6 +4,8 @@
 
 use Mostafaznv\LaraCache\Actions\Support\UpdateDeleteCache;
 use Mostafaznv\LaraCache\DTOs\CommandData;
+use Mostafaznv\LaraCache\Traits\LaraCache;
+
 
 class UpdateCacheAction extends UpdateDeleteCache
 {
@@ -24,7 +26,7 @@ public function run(CommandData $data): void
     }
 
     /**
-     * @param \Mostafaznv\LaraCache\Traits\LaraCache $model
+     * @param LaraCache $model
      * @return void
      */
     private function updateAll(string $model): void
@@ -39,7 +41,7 @@ private function updateAll(string $model): void
     }
 
     /**
-     * @param \Mostafaznv\LaraCache\Traits\LaraCache $model
+     * @param LaraCache $model
      * @param array $entities
      * @return void
      */

src/Actions/UpdateGroupCacheAction.php

@@ -4,6 +4,7 @@
 
 use Mostafaznv\LaraCache\Actions\Support\UpdateDeleteCache;
 
+
 class UpdateGroupCacheAction extends UpdateDeleteCache
 {
     public function run(string $group): void

src/Cache.php

@@ -3,15 +3,17 @@
 namespace Mostafaznv\LaraCache;
 
 use Mostafaznv\LaraCache\DTOs\CacheData;
-use Mostafaznv\LaraCache\DTOs\CacheEvent;
+use Mostafaznv\LaraCache\Enums\CacheEvent;
 use Mostafaznv\LaraCache\Jobs\RefreshCache;
 use Mostafaznv\LaraCache\Traits\InteractsWithCache;
 use Mostafaznv\LaraCache\Utils\RefreshDebouncer;
 
+
 class Cache
 {
     use InteractsWithCache;
 
+
     public function get(string $name, bool $withCacheData = false): mixed
     {
         $cache = $this->retrieve($name);
@@ -35,10 +37,7 @@ public function updateAll(): void
         $this->updateLaraCacheModelsList();
 
         foreach ($this->model::cacheEntities() as $entity) {
-            $this->updateCacheEntity(
-                name: $entity->name,
-                entity: $entity
-            );
+            $this->updateCacheEntity($entity->name, entity: $entity);
         }
     }
 
@@ -61,22 +60,26 @@ public function refresh(CacheEvent $event): void
 
             foreach ($this->model::cacheEntities() as $entity) {
                 if ($entity->debounce) {
-                    $this->initCache($entity, $entity->getTtl());
-
-                    RefreshDebouncer::dispatch(
-                        model: $this->model,
-                        name: $entity->name,
-                        queueConnection: $entity->queueConnection,
-                        queueName: $entity->queueName,
-                        wait: $entity->debounceWaitTime
-                    );
+                    if ($this->entityIsCallable($entity, $event)) {
+                        $this->initCache($entity, $entity->getTtl());
+
+                        RefreshDebouncer::dispatch(
+                            model: $this->model,
+                            name: $entity->name,
+                            queueConnection: $entity->queueConnection,
+                            queueName: $entity->queueName,
+                            wait: $entity->debounceWaitTime
+                        );
+                    }
                 }
                 else if ($entity->isQueueable) {
-                    $this->initCache($entity, $entity->getTtl());
+                    if ($this->entityIsCallable($entity, $event)) {
+                        $this->initCache($entity, $entity->getTtl());
 
-                    RefreshCache::dispatch($this->model, $entity->name, $event)
-                        ->onConnection($entity->queueConnection)
-                        ->onQueue($entity->queueName);
+                        RefreshCache::dispatch($this->model, $entity->name)
+                            ->onConnection($entity->queueConnection)
+                            ->onQueue($entity->queueName);
+                    }
                 }
                 else {
                     $this->updateCacheEntity($entity->name, $event, $entity);