eghojansu/bumbon-validation

PHP Data Validation

Bumbon/Validation

PHP Validation., _(*1)

Installation

composer require bumbon/validation

Usage

<?php

$validation = Validation::create(
    [
        'foo' => NotBlank(),
        'baz' => [
            new NotBlank(),
            new Length([
                'min' => 5,
            ])
        ],
    ],
    [
        'foo' => 'bar',
        'baz' => 'qux'
    ]
);
$violation = $validation->validate();

// or
// $validation->validate(['foo' => 'bar','baz' => 'qux']);

if ($violation->hasViolation()) {
    echo 'Invalid data';
} else {
    echo 'Data valid';
}

// or
if ($violation->noViolation()) {
    echo 'Data valid';
} else {
    echo 'Invalid data';
}

// get violation message
var_dump($violation->all());

// [
//   'foo' => ['Nilai ini tidak boleh kosong']
// ]

Available Constraints

All option can be passed in each constraint via associative array. All constraint has parent option. Default message is Bahasa Indonesia., _(*2)

<?php

// default parent option
$option = [
    // message
    'message' => 'Custom message',
    // group validate
    'groups' => ['Default'],
    // trim value
    'trim' => true,
    // callback for normalize data (before validate)
    'normalizer' => null,
];

• Between, _(*3)

  <?php
  $option = [
  'min' => 5,
  'max' => 5,
  ];
  

• Blank
• Boolean

• Callback, _(*4)

  <?php
  $option = [
  // callback (return bool)
  'callback' => null,
  ];
  

• Choice, _(*5)

  <?php
  $option = [
  // array of valid choices
  'choices' => [],
  ];
  

• Email

• Equal, _(*6)

  <?php
  $option = [
  // equal to this value
  'value' => null,
  ];
  

• GreaterThanEqual, _(*7)

  <?php
  $option = [
  // greater than or equal to this value
  'value' => null,
  ];
  

• GreaterThan, _(*8)

  <?php
  $option = [
  // greater than to this value
  'value' => null,
  ];
  

• Identical, _(*9)

  <?php
  $option = [
  // identical to this value
  'value' => null,
  ];
  

• InTable, _(*10)

  <?php
  $option = [
  // pdo connection
  'pdo' => null,
  // table to lookup
  'table' => null,
  // field to find
  'field' => 'ID',
  ];
  

• Ip
• IsFalse
• IsTrue

• Length, _(*11)

  <?php
  $option = [
  'min' => 5,
  'max' => 5,
  ];
  

• LessThanEqual, _(*12)

  <?php
  $option = [
  // lest than or equal to this value
  'value' => null,
  ];
  

• LessThan, _(*13)

  <?php
  $option = [
  // less than to this value
  'value' => null,
  ];
  

• NotBlank

• NotEqual, _(*14)

  <?php
  $option = [
  // not equal to this value
  'value' => null,
  ];
  

• NotIdentical, _(*15)

  <?php
  $option = [
  // not identical to this value
  'value' => null,
  ];
  

• NotInTable, _(*16)

  <?php
  $option = [
  // pdo connection
  'pdo' => null,
  // table to lookup
  'table' => null,
  // field to find
  'field' => 'ID',
  // primary key, can be array
  'id' => 'ID',
  // current primary key value, can be array
  'current_id' => null,
  ];
  

• Numeric
• PhoneNumber

• Regex, _(*17)

  <?php
  $option = [
  // match to this pattern
  'pattern' => null,
  ];
  

• Url

Custom Constraints

Implements Constraint Interface., _(*18)

<?php

namespace Bumbon\Validation\Constraint;

interface ConstraintInterface
{
    /**
     * Get violation message
     * @return array|string
     */
    public function getMessages();

    /**
     * Get groups
     * @return array
     */
    public function getGroups();

    /**
     * Set value to check
     * @param mixed $value
     * @return  $this
     */
    public function setValue($value);

    /**
     * Get value
     * @return  mixed
     */
    public function getValue();

    /**
     * Validate value
     * @return $this
     */
    public function validate();

    /**
     * Get constraint validity
     * @return boolean
     */
    public function isValid();
}

Or extends AbstractConstraint, _(*19)

<?php

use Bumbon\Validation\Constraint;

class CustomConstraint extends AbstractContraint
{
    public function validate()
    {
        $this->valid = $this->value == 'true';

        return $this;
    }
}

Inspiration

This library was inspired by Symfony/Validation. I created this for my own project., _(*20)