README

Request Validator

The Request Validator provides a robust and extensible system for validating REST API requests in WordPress plugins. It supports a fluent rule-based syntax inspired by Laravel and integrates seamlessly with WP_REST_Request.

📦 Installation

If using standalone:

composer require wpmvc/validator

🧱 Structure Overview

File	Purpose
`Validator`	Main validation handler class
`Mime`	Utility for validating uploaded file types
`DateTime`	Trait for handling date-based validation rules

🚀 Basic Usage

Inside a controller method:

public function store( Validator $validator, WP_REST_Request $request ) {
    $validator->validate([
        'title'    => 'required|string|min:3|max:255',
        'email'    => 'required|email',
        'price'    => 'numeric|min:0',
        'tags'     => 'array',
        'image'    => 'file|mimes:png,jpg,jpeg|max:2048',
        'launched' => 'date:Y-m-d|after_or_equal:2024-01-01',
    ]);

    // Validation passed; continue logic
}

❗ If validation fails, a WpMVC\Exceptions\Exception is thrown with HTTP status 422 and the error messages.

🛠 Available Rules

Rule	Description
`required`	Field must be present and non-empty
`string`	Must be a string
`email`	Validates email format
`numeric`	Must be a numeric value
`integer`	Must be an integer
`boolean`	Must be `true` or `false`
`array`	Must be an array
`uuid`	Must be a valid UUID
`url`	Must be a valid URL
`mac_address`	Must be a valid MAC address
`json`	Must be a valid JSON string
`confirmed`	`field_confirmation` must match field
`accepted`	Value must be in allowed list
`file`	Checks file upload validity
`mimes`	Allowed file extensions (e.g. `jpg,png`)
`max`	Max length/size/value (string, numeric, file, array)
`min`	Min length/size/value (string, numeric, file, array)
`date:format`	Must be a date in given format
`date_equals`	Must exactly match a date
`before`	Must be before given date
`after`	Must be after given date
`before_or_equal`	Must be before or equal to given date
`after_or_equal`	Must be after or equal to given date

📁 File Validation Example

$validator->validate([
    'photo' => 'required|file|mimes:png,jpg|max:1024',
]);

Validates that photo is a file
Accepts only png, jpg
Maximum 1MB (1024 KB)

📅 Date Validation Example

$validator->validate([
    'launched' => 'required|date:Y-m-d|after_or_equal:2022-01-01',
]);

Supports custom formats and comparison logic using native PHP DateTime.

📋 Error Handling

If throw_errors is true (default), the validator throws an exception and returns a 422 JSON response:

{
  "message": "",
  "errors": {
    "email": ["The email field must be a valid email address."],
    "price": ["The price must be at least 0."]
  }
}

🔄 Manual Check

You can also use:

$validator->validate($rules, false);
if ( $validator->is_fail() ) {
    return Response::send(['errors' => $validator->errors], 422);
}

🔧 Internal Utilities

Mime class for file type validation using mime_content_type.
DateTime trait for parsing and comparing dates based on format.
get_format(), is_it_valid_date(), get_timestamp() handle date logic.

wpmvc / request-validator

Maintainers

Details