Develop (#94)

* Validation system for settings data

Author: glorand

.github/workflows/test.yml

@@ -13,25 +13,19 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        php: [8.0, 7.4, 7.3, 7.2]
-        laravel: [8.*, 7.*, 6.*]
+        php: [8.0, 7.4, 7.3]
+        laravel: [8.*, 7.*]
         dependency-version: [prefer-lowest, prefer-stable]
         include:
           - laravel: 8.*
             testbench: 6.*
           - laravel: 7.*
             testbench: 5.*
-          - laravel: 6.*
-            testbench: 4.*
         exclude:
           - laravel: 8.*
             php: 7.2
           - laravel: 7.*
             php: 8.0
-          - laravel: 6.*
-            php: 8.0
-          - laravel: 6.*
-            php: 7.4
 
     name: P ${{ matrix.php }} - L ${{ matrix.laravel }} - ${{ matrix.dependency-version }}
 

.travis.yml

@@ -1,7 +1,6 @@
 language: php
 
 php:
-  - 7.2
   - 7.3
   - 7.4
 

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 All notable changes to `glorand/laravel-model-settings` will be documented in this file
 
+## 4.4.0 - 2021-11-01
+### Added
+- Validation system for settings data
+
 ## 4.3.0 - 2021-10-11
 ### Added
 - Using another method name other than settings()

README.md

@@ -41,7 +41,7 @@
 <a title="PHP Version" href="#"><img src="https://img.shields.io/packagist/php-v/glorand/laravel-model-settings" alt="PHP Version" /></a>
 </p>
 
-The package requires PHP 7.2+ and follows the FIG standards PSR-1, PSR-2 and PSR-4
+The package requires PHP 7.3+ and follows the FIG standards PSR-1, PSR-2, PSR-4 and PSR-12
 to ensure a high level of interoperability between shared PHP.
 
 Bug reports, feature requests, and pull requests can be submitted by following our [Contribution Guide](CONTRIBUTING.md).
@@ -62,7 +62,8 @@ Bug reports, feature requests, and pull requests can be submitted by following o
     - [Check if the model has a specific setting](#check)
     - [Remove a setting from a model](#remove)
     - [Persistence](#persistence)
-    - [Using another method name other than settings()](#invokeSettingsBy)
+    - [Using another method name other than `settings()`](#invokeSettingsBy)
+    - [Validation system for settings data](#validation)
  - [Changelog](#changelog)
  - [Contributing](#contributing)
 - [License](#license)
@@ -265,6 +266,40 @@ If you prefer to use another name other than `settings` ,
 you can do so by defining a `$invokeSettingsBy` property. 
 This forward calls (such as `configurations()`) to the `settings()` method.
 
+### Validation system for settings data <a name="validation></a>
+When you're using the set() or apply()|update() methods thrown an exception when you break a rule.
+You can define rules on model using `$settingsRules` public property, and the rules array definition is identical with
+the Laravel default validation rules. ([see Laravel rules](https://laravel.com/docs/8.x/validation#available-validation-rules))
+```php
+class User extends Model
+{
+    use HasSettingsTable;
+
+    public array $defaultSettings = [
+        'user' => [
+            'name' => 'Test User',
+            'email' => 'user@test.com'
+            'age' => 27,
+        ],
+        'language' => 'en',
+        'max_size' => 12,
+    ];
+
+    // settings rules
+    public array $settingsRules = [
+        'user' => 'array',
+        'user.email' => [
+            'string',
+            'email',
+        ],
+        'user.age' => 'integer',
+        'language' => 'string|in:en,es,it|max:2',
+        'max_size' => 'int|min:5|max:15',
+    ];
+}
+
+```
+
 ## Changelog <a name="changelog"></a>
 Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.
 

composer.json

@@ -17,18 +17,18 @@
         "settings"
     ],
     "require": {
-        "php": ">=7.2",
-        "illuminate/config": "^6.0|^7.0|^8.0",
-        "illuminate/database": "^6.0|^7.0|^8.0",
-        "illuminate/support": "^6.0|^7.0|^8.0",
-        "illuminate/console": "^6.0|^7.0|^8.0",
-        "illuminate/filesystem": "^6.0|^7.0|^8.0",
-        "illuminate/cache": "^6.0|^7.0|^8.0",
+        "php": ">=7.3",
+        "illuminate/config": "^7.0|^8.0",
+        "illuminate/database": "^7.0|^8.0",
+        "illuminate/support": "^7.0|^8.0",
+        "illuminate/console": "^7.0|^8.0",
+        "illuminate/filesystem": "^7.0|^8.0",
+        "illuminate/cache": "^7.0|^8.0",
         "ext-json": "*"
     },
     "require-dev": {
         "phpunit/phpunit": "^8.0|^9.0",
-        "orchestra/testbench": "^4.0|^5.0|^6.0",
+        "orchestra/testbench": "^5.0|^6.0",
         "friendsofphp/php-cs-fixer": "^2.16@dev",
         "josiasmontag/laravel-redis-mock": "^1.2"
     },

src/Console/CreateSettingsFieldForModel.php

@@ -16,11 +16,11 @@ class CreateSettingsFieldForModel extends Command
     protected $description = 'Create migration for the (update) selected table, adding settings field';
 
     /**
-     * @param \Illuminate\Filesystem\Filesystem $file
-     * @return bool
+     * @param  \Illuminate\Filesystem\Filesystem  $file
+     * @return int
      * @throws \Illuminate\Contracts\Filesystem\FileNotFoundException
      */
-    public function handle(Filesystem $file)
+    public function handle(Filesystem $file): int
     {
         $table = $this->ask('What is the name of the table?');
         $table = strtolower(Str::snake(trim($table)));

src/Managers/AbstractSettingsManager.php

@@ -5,12 +5,14 @@
 use Glorand\Model\Settings\Contracts\SettingsManagerContract;
 use Glorand\Model\Settings\Exceptions\ModelSettingsException;
 use Glorand\Model\Settings\Traits\HasSettings;
+use Illuminate\Support\Facades\Validator;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Support\Arr;
 
 /**
  * Class AbstractSettingsManager
  * @package Glorand\Model\Settings\Managers
+ * @SuppressWarnings(PHPMD.StaticAccess)
  */
 abstract class AbstractSettingsManager implements SettingsManagerContract
 {
@@ -49,11 +51,12 @@ private static function isAssoc(array $arr): bool
 
     /**
      * Flatten array with dots for settings package
-     * @param $array
+     * @param array $array
      * @param string $prepend
      * @return array
+     * @SuppressWarnings(PHPMD.ElseExpression)
      */
-    public static function dotFlatten($array, $prepend = ''): array
+    public static function dotFlatten(array $array, string $prepend = ''): array
     {
         $results = [];
         foreach ($array as $key => $value) {
@@ -226,4 +229,13 @@ public function deleteMultiple(iterable $paths): SettingsManagerContract
 
         return $this;
     }
+
+    /**
+     * @param  array  $settings
+     * @throws \Illuminate\Validation\ValidationException
+     */
+    protected function validate(array $settings)
+    {
+        Validator::make(Arr::wrap($settings), Arr::wrap($this->model->getRules()))->validate();
+    }
 }

src/Managers/FieldSettingsManager.php

@@ -12,11 +12,13 @@
 class FieldSettingsManager extends AbstractSettingsManager
 {
     /**
-     * @param array $settings
+     * @param  array  $settings
      * @return \Glorand\Model\Settings\Contracts\SettingsManagerContract
      */
     public function apply(array $settings = []): SettingsManagerContract
     {
+        $this->validate($settings);
+
         $this->model->{$this->model->getSettingsFieldName()} = json_encode($settings);
         if ($this->model->isPersistSettings()) {
             $this->model->save();

src/Managers/RedisSettingsManager.php

@@ -14,6 +14,8 @@ class RedisSettingsManager extends AbstractSettingsManager
 {
     public function apply(array $settings = []): SettingsManagerContract
     {
+        $this->validate($settings);
+
         Redis::set($this->model->cacheKey(), json_encode($settings));
 
         return $this;

src/Managers/TableSettingsManager.php

@@ -19,6 +19,8 @@ class TableSettingsManager extends AbstractSettingsManager
      */
     public function apply(array $settings = []): SettingsManagerContract
     {
+        $this->validate($settings);
+
         $modelSettings = $this->model->modelSettings()->first();
         if (!count($settings)) {
             if ($modelSettings) {