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

Rule	Description
`required`	Field must be present and non-empty
`string`	Must be a string
`integer`	Must be an integer
`email`	Must be a valid email address
`min:n`	Minimum value (numeric) or minimum length (string)
`max:n`	Maximum value (numeric) or maximum length (string)
`regex:/pattern/`	Must match the given regex
`unique:table,column`	Value must not exist in the given DB column
`exists:table,column`	Value must exist in the given DB column
`confirmed`	Value must match `{field}_confirmation` in the input
`same:other`	Value must equal the value of `other` field
`different:other`	Value must differ from the value of `other` field
`date`	Must be a valid date parseable by `strtotime()`
`date_format:Y-m-d`	Must exactly match the given PHP date format
`before:date`	Must be a date strictly before the reference
`after:date`	Must be a date strictly after the reference
`file`	Must be a valid `$_FILES` upload (`UPLOAD_ERR_OK`)
`image`	Upload MIME type must be `image/*`
`mimes:jpg,png`	Upload file extension must be in the list
`max_size:n`	Upload size must not exceed `n` kilobytes
`dimensions:min_width=N,...`	Image dimensions must satisfy the constraints
`sometimes`	Skip all rules for this field when its key is absent from the data

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

ez-php / validation

Maintainers

Package info

Statistics

Security