https://github.com/siriusphp/validation

Framework agnostic validation library for PHP
https://github.com/siriusphp/validation

forms input php sanitization security validation

Last synced: 3 months ago
JSON representation

Framework agnostic validation library for PHP

• Host: GitHub
• URL: https://github.com/siriusphp/validation
• Owner: siriusphp
• License: mit
• Created: 2013-08-15T20:23:10.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2023-11-19T15:41:53.000Z (12 months ago)
• Last Synced: 2024-05-17T17:02:39.437Z (6 months ago)
• Topics: forms, input, php, sanitization, security, validation
• Language: PHP
• Homepage: http://www.sirius.ro/php/sirius/validation/
• Size: 603 KB
• Stars: 159
• Watchers: 11
• Forks: 29
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• php-awesome - siriusphp/validation

README

        
# Sirius Validation

[![Source Code](http://img.shields.io/badge/source-siriusphp/validation-blue.svg)](https://github.com/siriusphp/validation)

[![Latest Version](https://img.shields.io/packagist/v/siriusphp/validation.svg)](https://github.com/siriusphp/validation/releases)

[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg)](https://github.com/siriusphp/validation/blob/master/LICENSE)

[![Build Status](https://github.com/siriusphp/validation/workflows/CI/badge.svg)](https://github.com/siriusphp/validation/actions)

[![Coverage Status](https://scrutinizer-ci.com/g/siriusphp/validation/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/siriusphp/validation/code-structure)

[![Quality Score](https://scrutinizer-ci.com/g/siriusphp/validation/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/siriusphp/validation)

[![Total Downloads](https://img.shields.io/packagist/dt/siriusphp/validation.svg)](https://packagist.org/packages/siriusphp/validation)

Sirius Validation is a library for data validation. It offers:

1. [validator object](docs/validator.md)

2. [45 build-in validation rules](docs/validation_rules.md). There are validators for strings, array, numbers, emails, URLs, files and uploads

3. [validation helper](docs/helper.md) to simplify the validation of single values

Out-of-the-box, the library can handle `array`s, `ArrayObject`s and objects that have implemented the `toArray` method.

In order to validate other data containers you must create a [`DataWrapper`](https://github.com/siriusphp/validation/blob/master/src/Validation/DataWrapper/WrapperInterface.php) so that the validator be able to extract data from your object.

## Elevator pitch

```php

$validator = new \Sirius\Validation\Validator;

// add a validation rule

$validator->add('title', 'required');

// add a rule that has a list of options

$validator->add('title', 'length', array('min' => 10, 'max' => 100));

// or use JSON

$validator->add('title', 'length', '{"min": 10, "max": 100}');

// or a URL query string

$validator->add('title', 'length', 'min=10&max=100');

// or, if you know that the validator can CORECTLY parse (ie: understand) the options string

$validator->add('title', 'length', '10,100');

// add a rule with a custom error message

$validator->add('title', 'maxlength', 'max=100', 'Article title must have less than {max} characters');

// add a rule with a custom message and a label (very handy with forms)

$validator->add('title:Title', 'maxlength', 'max=100', '{label} must have less than {max} characters');

// add multiple rules at once (separate using [space][pipe][space])

$validator->add('title:Title', 'required | maxlength(255) | minlength(min=10)');

// add all your rules at once

$validator->add([

        'title:Title' => 'required | maxlength(100)',

        'content:Content' => 'required',

        'source:Source' => 'website'

    ], [

        'content.required' => 'The content field should have a velue'

    ]);

// add nested rules

$validator->add('recipients[*]:Recipients', 'email'); //all recipients must be valid email addresses

$validator->add('shipping_address[city]:City', 'MyApp\Validator\City'); // uses a custom validator to validate the shipping city

```

## Links

- [documentation](http://sirius.ro/php/sirius/validation/)

- [changelog](CHANGELOG.md)