krzysztofrewak / laravel-oop-validator
Laravel Validator object-oriented wrapper
Installs: 5 626
Dependents: 0
Suggesters: 0
Security: 0
Stars: 79
Watchers: 4
Forks: 2
Open Issues: 1
Requires
- php: ^7.3
- illuminate/support: ^6.3|^7.0
- illuminate/validation: ^6.3|^7.0
Requires (Dev)
This package is auto-updated.
Last update: 2024-10-29 05:47:09 UTC
README
laravel-oop-validator
Package was created for Laravel developers who need for some reason object-oriented approach to validation. It basically maps all string rules into easy manageable chained methods.
Installation
Use composer:
composer require krzysztofrewak/laravel-oop-validator
Usage
Most of the Laravel validation rules were mapped into Field
methods. You can use ValidationBuilder
or PipelinedValidationBuilder
instances: first one will return rules in arrayed form, second one in string pipeline.
Simple rule chains
$validator->validate("email", function (Field $field): void { $field->string()->required()->email(["rfc"]) }); $validator->getRules();
// for ValidationBuilder: ["email" => ["string", "required", "email:rfc"]] // for PipelinedValidationBuilder: ["email" => "string|required|email:rfc"]
More complex rule chains
$validator->validate("avatar", function (Field $field): void { $field->required() ->mimes(["jpeg", "png"]) ->unique("users", "avatar") ->dimensions(function(Dimensions $dimensions): void { $dimensions->ratio(3/2); }); }); $validator->getRules();
// for ValidationBuilder: ["avatar" => ["required", "mimes:jpeg,png", "unique:users,avatar", "dimensions:ratio=1.5"]] // for PipelinedValidationBuilder: ["avatar" => "required|mimes:jpeg,png|unique:users,avatar|dimensions:ratio=1.5"]
Nested rules chains
Nested validation rules could look like this:
$validator = new ValidationBuilder(); $validator->validateEach("tags", function (Field $field): void { $field->array(); }); $validator->validateInEach("id", "tags", function (Field $field): void { $field->required()->exists("tags", "id"); });
// for ValidationBuilder: ["tags.*:" => ["array"], "tags.*.id:" => ["required", "exists:tags,id"]] // for PipelinedValidationBuilder: ["tags.*:" => "array", "tags.*.id:" => "required|exists:tags,id"]
Custom rules chains
Custom validation rules could look like this:
$validator = new ValidationBuilder(); $validator->validate("field", function (Field $field): void { $field->required()->customRule(CustomRule::class); });
// for ValidationBuilder: ["field" => ["required", CustomRule::class]] // for PipelinedValidationBuilder it will throw NotAllowedRuleException()
Laravel integration
You can add instance of ValidationBuilder
into your FormRequest
's rules()
method or any other place where you can put array of rules:
<?php declare(strict_types = 1); namespace App\Http\Requests; use Illuminate\Foundation\Http\FormRequest; use KrzysztofRewak\LaravelOOPValidator\Field; use KrzysztofRewak\LaravelOOPValidator\ValidationBuilder; /** * Class CreateNewUserRequest * @package App\Http\Requests */ class CreateNewUserRequest extends FormRequest { /** * @var ValidationBuilder */ protected $builder; /** * CreateNewUserRequest constructor. * @param ValidationBuilder $builder */ public function __construct(ValidationBuilder $builder) { $this->builder = $builder; } /** * @return bool */ public function authorize(): bool { return true; } /** * @return array */ public function rules(): array { $this->builder->validate("email", function (Field $field): void { $field->required()->string()->email()->unique("users", "email"); }); $this->builder->validate("password", function (Field $field): void { $field->required()->string()->min(6)->confirmed(); }); return $this->builder->getRules(); } }