README

Validation module for the ez-php framework — rule-based validator with database-backed unique/exists rules and optional i18n support.

Requirements

• PHP 8.5+
• ez-php/framework 0.*

Installation

composer require ez-php/validation

Optionally install ez-php/i18n for localised error messages:

composer require ez-php/i18n

Usage

use EzPhp\Validation\Validator;

$validator = Validator::make(
    data: ['email' => 'alice@example.com', 'age' => 17],
    rules: [
        'email' => 'required|email',
        'age'   => 'required|integer|min:18',
    ],
);

if ($validator->fails()) {
    $errors = $validator->errors();
    // ['age' => ['The age must be at least 18.']]
}

// Or throw on failure:
$validator->validate(); // throws ValidationException

Supported rules

Rules skip silently for absent/empty values (except required and sometimes). Combine required with type rules to enforce both presence and type.

FormRequest

For controller-level validation with optional authorization, extend FormRequest:

use EzPhp\Validation\FormRequest;

class StoreUserRequest extends FormRequest
{
    public function authorize(): bool
    {
        return true; // check e.g. Auth::user()->isAdmin()
    }

    public function rules(): array
    {
        return [
            'name'  => 'required|string|max:255',
            'email' => 'required|email',
        ];
    }
}

Inject it into a controller action — it validates automatically on instantiation:

public function store(StoreUserRequest $request): Response
{
    // reaches here only if validation and authorization passed
    $data = $request->validated();
}

FormRequest throws ValidationException on rule failures and AuthorizationException when authorize() returns false.

With i18n

Pass a Translator instance to receive messages in the configured locale:

$translator = $app->make(\EzPhp\I18n\Translator::class);

$validator = Validator::make($data, $rules, translator: $translator);

License

MIT — Andreas Uretschnig