Feature Fix

CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to `laravel-docuware` will be documented in this file.
 
+## [Unreleased]
+
+### Laravel 12 Compatibility
+- Updated cache configuration to use `CACHE_STORE` instead of deprecated `CACHE_DRIVER` for Laravel 12 compatibility
+- This ensures DocuWare cache uses the same store as the application, preventing MAC invalid errors when using encrypted cache values
+- Maintains backward compatibility with Laravel 9-11 by falling back to `CACHE_DRIVER` if `CACHE_STORE` is not available
+
 ## 2.0.0 pre-release
 ### General
 - Dropped support below PHP 8.1

README.md

@@ -1702,7 +1702,7 @@ return [
     |
     */
 
-    'cache_driver' => env('DOCUWARE_CACHE_DRIVER', env('CACHE_DRIVER', 'file')),
+    'cache_driver' => env('DOCUWARE_CACHE_DRIVER', env('CACHE_STORE', env('CACHE_DRIVER', 'file'))),
 
     /*
     |--------------------------------------------------------------------------
@@ -1765,7 +1765,7 @@ return [
             'additional_result_fields' => [],
         ],
         'cache' => [
-            'driver' => env('DOCUWARE_CACHE_DRIVER', env('CACHE_DRIVER', 'file')),
+            'driver' => env('DOCUWARE_CACHE_DRIVER', env('CACHE_STORE', env('CACHE_DRIVER', 'file'))),
             'lifetime_in_seconds' => env('DOCUWARE_CACHE_LIFETIME_IN_SECONDS', 60),
         ],
     ],

config/laravel-docuware.php

@@ -7,10 +7,11 @@
     | Cache driver
     |--------------------------------------------------------------------------
     | You may like to define a different cache driver than the default Laravel cache driver.
+    | In Laravel 12+, CACHE_STORE is used instead of CACHE_DRIVER.
     |
     */
 
-    'cache_driver' => env('DOCUWARE_CACHE_DRIVER', env('CACHE_DRIVER', 'file')),
+    'cache_driver' => env('DOCUWARE_CACHE_DRIVER', env('CACHE_STORE', env('CACHE_DRIVER', 'file'))),
 
     /*
     |--------------------------------------------------------------------------
@@ -73,7 +74,7 @@
             'additional_result_fields' => [],
         ],
         'cache' => [
-            'driver' => env('DOCUWARE_CACHE_DRIVER', env('CACHE_DRIVER', 'file')),
+            'driver' => env('DOCUWARE_CACHE_DRIVER', env('CACHE_STORE', env('CACHE_DRIVER', 'file'))),
             'lifetime_in_seconds' => env('DOCUWARE_CACHE_LIFETIME_IN_SECONDS', 60),
         ],
         'request' => [

src/DTO/TextshotPage.php

@@ -23,7 +23,7 @@ public static function fromJson(array $data): self
     }
 
     public function __construct(
-        public string $language,
+        public ?string $language,
         public string $content,
     ) {}