NSY Validation Library — User Tutorial

Rule-based validation uses the retained third-party library rakit/validation (MIT, Laravel-inspired), exposed to the framework through the alias System\Libraries\Validator → Rakit\Validation\Validator (see System/Config/App.php).

System\Libraries\Validate is a sanitizer / type caster (asString(), asEmail(), …) — not a rule validator. Use Validator for rules such as required|email|min:6, and Validate to clean values. See Libraries for the sanitizer.

Table of Contents

1. Quick Start
2. Common Rules
3. Custom Messages
4. Reading the Result
5. Combining with Request
6. Quick Reference

Quick Start

use System\Libraries\Validator;   // alias of Rakit\Validation\Validator

$validator  = new Validator();
$validation = $validator->make($data, [
    'name'     => 'required|min:3',
    'email'    => 'required|email',
    'password' => 'required|min:6',
    'confirm'  => 'required|same:password',
]);

$validation->validate();

if ($validation->fails()) {
    $errors = $validation->errors()->firstOfAll();   // ['email' => 'The Email is not valid', ...]
} else {
    $clean = $validation->getValidatedData();        // only the validated keys
}

validate($inputs, $rules, $messages) is a shortcut that returns the same Validation object:

$validation = $validator->validate($data, ['email' => 'required|email']);

Common Rules

Array / nested keys use dot + wildcard notation:

$validation = $validator->make($data, [
    'skills'            => 'array',
    'skills.*.id'       => 'required|numeric',
    'skills.*.percent'  => 'required|numeric|between:0,100',
]);

The full rule list lives in the library — see System/Vendor/rakit/validation or the upstream project (github.com/rakit/validation).

Custom Messages

Pass a third argument keyed by field or field:rule:

$validation = $validator->make($data, [
    'email' => 'required|email',
], [
    'email.required' => 'Alamat e-mail wajib diisi.',
    'email.email'    => 'Format e-mail tidak valid.',
    'required'       => 'Kolom :attribute wajib diisi.',
]);

Register a reusable custom rule with addValidator():

$validator->addValidator('uppercase', new class extends \Rakit\Validation\Rule {
    protected $message = ':attribute harus huruf besar';
    public function check($value): bool { return strtoupper((string) $value) === (string) $value; }
});

Reading the Result

$validation->fails();                       // bool
$validation->errors()->firstOfAll();        // ['field' => 'message', ...]
$validation->errors()->first('email');      // first message for one field
$validation->getValidatedData();            // only keys that passed

Combining with Request

Request sanitizes input into a clean array first, then Validator applies rules:

use System\Libraries\Request;
use System\Libraries\Validator;

$input = Request::input('POST')->asArray([
    'name'  => 'string',
    'email' => 'string',
]);

$validation = (new Validator())->validate($input, [
    'name'  => 'required|min:3',
    'email' => 'required|email',
]);

Quick Reference

Related source: alias in System/Config/App.php; library at System/Vendor/rakit/validation.