solumdesignum/scenarios

Laravel Dynamic Validation Scenarios

v1.2.0 2024-03-20 18:45 UTC

Requires

• php: ^8.1|^8.2|^8.3
• illuminate/support: ~10|~11

MIT

• Oskars Germovs

• validation
• dynamic
• laravel
• scenarios
• laravel-scenarios
• laravel-dynamic-validation

README

Introduction

Solum DeSignum Scenarios is agnostic backend validation Scenarios package.

Installation

To get started, install Scenarios using the Composer package manager:

composer require solumdesignum/scenarios

Next, publish Scenarios resources using the vendor:publish command:

php artisan vendor:publish --provider="SolumDeSignum\Scenarios\ScenariosServiceProvider"

This command will publish Scenarios config to your config directory, which will be created if it does not exist.

Scenarios Features

The Scenarios configuration file contains a configuration array.

<?php

declare(strict_types=1);

return [
    'features' => [
        'setMethodFromUrlSegment' => false,
        'setMethodFromController' => true,
    ],
    'methods' => [
        'pattern' => '/create|store|update|destroy/im'
    ]
];

Scenario's With Form Request Validation

<?php

declare(strict_types=1);

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Support\Facades\Auth;
use SolumDeSignum\Scenarios\Scenarios;


class OfficeBlogRequest extends FormRequest
{
    use Scenarios;

    /**
     * Determine if the user is authorized to make this request.
     *
     * @return bool
     */
    public function authorize(): bool
    {
        return Auth::check();
    }

    /**
     * Get the validation rules that apply to the request.
     *
     * @return array
     */
    public function rules(): array
    {
        $rules = [];

        if ($this->scenario === 'store') {
            $rules = [
                'title' => 'required|string',
                'publish_at' => 'required',
                'blog_category_id' => 'required|numeric',
                'description' => 'required',
            ];
        }

        if ($this->scenario === 'update') {
            $rules = [
                'title' => 'required|string',
                'publish_at' => 'required',
                'blog_category_id' => 'required|numeric',
                'description' => 'required',
                'img' => 'image',
            ];
        }

        if ($this->scenario === 'destroy') {
            $rules = [];
        }

        return $rules;
    }
}

Validation Rules Usage

However, can be used on both examples

namespace App\Validation;
	
use SolumDeSignum\Scenarios\Scenarios;

class SampleRules
{
  public static function ScenarioRules(string $scenario): ?array
  {
        switch ($scenario) {
            case $scenario === 'store';
                return
                    [
                        'text' => 'required|string',
                    ];
                break;

            case $scenario === 'update';
                return
                    [
                        'text' => 'required|string',
                        'description' => 'required|string',
                    ];
                break;
        }
  }
}

Scenario's With Controller

Manually Creating Validators

<?php

declare(strict_types=1);

namespace App\Http\Controllers\Office\Blog;

use Illuminate\Support\Facades\Validator;
use SolumDeSignum\Scenarios\Scenarios;
use App\Validation\SampleRules;

class BlogController
{
    use Scenarios;

    public function store(Request $request)
    {
        $validator = Validator::make($request->all(), SampleRules::ScenarioRules($this->scenario));
        if ($validator->passes()) {
            #Your Logic Code
        }
    }
}

Controller Functions Names Examples

However, you can override regex with your naming conventions inside configuration

<?php

declare(strict_types=1);

return [
    'methods' => [
        'pattern' => '/create|store|update|destroy/im'
    ]
];

#Controller Function Naming Samples: create(), store() , update() , destroy()

Author

• Oskars Germovs (Twitter)

Support

If you need support you can ask on Twitter.

License

Solum DeSignum Scenarios is open-sourced software licensed under the MIT license.