izica/phalcon-validation

Handy interface for Phalcon Validation

2.0.1 2023-04-09 01:00 UTC

This package is auto-updated.

Last update: 2024-04-09 03:23:09 UTC


README

Useful tool for Phalcon\Validation for easiest way to validate your data

Installation

composer require izica/phalcon-validation

Api

Izica\Validation

  • __construct($arOptions) -- example below
  • validate($arData)
  • static make($arData, $arOptions)

Izica\ValidationRule

  • static required($arOptions: optional) -- Phalcon\Validation\Validator\PresenceOf
  • static numeric($arOptions: optional) -- Phalcon\Validation\Validator\Numericality
  • static email($arOptions: optional) -- Phalcon\Validation\Validator\Email
  • static url($arOptions: optional) -- Phalcon\Validation\Validator\Url
  • static callback($arOptions) -- Phalcon\Validation\Validator\Callback
  • static length($arOptions) -- Phalcon\Validation\Validator\StringLength
  • static unique($arOptions) -- Phalcon\Validation\Validator\UniquenessValidator
  • static between($arOptions) -- Phalcon\Validation\Validator\Between
  • static file($arOptions) -- Phalcon\Validation\Validator\File
  • static date($arOptions) -- Phalcon\Validation\Validator\Date
  • static regex($arOptions) -- Phalcon\Validation\Validator\Regex

Notice

[https://docs.phalconphp.com/3.4/en/api/phalcon_validation_validator_numericality] $arOptions which passed in static functions, for example static numeric($arOptions), used as params for new Numericality($arOptions);

You can use it like this

$validation = new Validation([
    'num' => [ValidationRule::numeric(['message' => ':field is not numeric')],
]);

Usage

use Izica\Validation;
use Izica\ValidationRule;
use Phalcon\Mvc\Controller;

class ExampleController extends Controller {
    public function indexAction() {
        $validation = new Validation([
            'email' => [ValidationRule::required(), ValidationRule::email()],
            'num' => [ValidationRule::required(), ValidationRule::numeric()],
        ]);
        $arMessages = $validation->validate($_POST);
        if ($arMessages) {
            // validation error
        }
        // validation success
    }
    // or short
    public function indexAction() {
        $arMessages = Validation::make($_POST, [
            'email' => [ValidationRule::required(), ValidationRule::email()],
            'num' => [ValidationRule::required(), ValidationRule::numeric()],
        ]);
        if ($arMessages) {
            // validation error
        }
        // validation success
    }
}
/*
    $_POST = [
        'email' => 'qwe'
    ];
*/
$arMessages = $validation->validate($_POST);

/* 
$arMessages
Array
(
    [0] => Array
        (
            [field] => email
            [type] => email
            [message] => email is not valid
        )

    [1] => Array
        (
            [field] => num
            [type] => required
            [message] => num is required
        )

    [2] => Array
        (
            [field] => num
            [type] => numeric
            [message] => num is not numeric
        )

)
*/