README

Intervention Validation is an extension library for Laravel's own validation system. The package adds rules to validate data like IBAN, BIC, ISBN, creditcard numbers and more.

Installation

You can install this package quick and easy with Composer.

Require the package via Composer:

$ composer require intervention/validation

Laravel integration (optional)

The Validation library is built to work with the Laravel Framework (>=5.5). It comes with a service provider, which will be discovered automatically and registers the validation rules into your installation.

Usage

use Intervention\Validation\Validator;
use Intervention\Validation\Rules\HexColor;
use Intervention\Validation\Exception\ValidationException;

// create validator (for HexColor)
$validator = new Validator(new HexColor);

// validate against given values
$valid = $validator->validate('#ccc'); // true
$valid = $validator->validate('www'); // false

// change the validation rule
$validator->setRule(new Domainname);

// now validate new rule domainname
$valid = $validator->validate('foo.com'); // true
$valid = $validator->validate('?'); // false

// validator can also throw exceptions on invalid data. 
// just call assert() instead of validate().
try {
    $validator->assert('foobar');
} catch (ValidationException $e) {
    echo $e->getMessage();
}

Static Usage

use Intervention\Validation\Validator;
use Intervention\Validation\Rules\HexColor;
use Intervention\Validation\Exception\ValidationException;

// create validator statically
$valid = Validator::make(new HexColor)->validate('ccc'); // true
$valid = Validator::make(new HexColor)->validate('#www'); // false

// throw exceptions on invalid data instead of returning boolean
try {
    Validator::make(new HexColor)->assert('www');
} catch (ValidationException $e) {
    echo $e->getMessage();
}

Static dynamic call Usage

use Intervention\Validation\Validator;
use Intervention\Validation\Rules\HexColor;
use Intervention\Validation\Exception\ValidationException;

// call validation rule directly via static method
$valid = Validator::isHexColor('#ccc'); // true
$valid = Validator::isHexColor('#www'); // false

// throw exceptions on invalid data
try {
    Validator::assertHexColor('foo');
} catch (ValidationException $e) {
    echo $e->getMessage();
}

Usage with Laravel

The installed package provides additional validation rules including their error messages.

use Illuminate\Support\Facades\Validator;
use Intervention\Validation\Rules\Creditcard;

$validator = Validator::make($request->all(), [
    'color' => 'required|hexcolor',
    'number' => 'iban',
    'ccnumber' => new Creditcard(), // passing rules as objects is also possible
]);

Changing the error messages:

Add the corresponding key to /resources/lang/<language>/validation.php like this:

// example
'iban' => 'Please enter IBAN number!',

Or add your custom messages directly to the validator like described in the docs.

Available Rules

The following validation rules are available.

base64 (Intervention\Validation\Rules\Base64)

Checks if given value is Base64 encoded.

bic (Intervention\Validation\Rules\Bic)

Checks for a valid Business Identifier Code (BIC).

camelcase (Intervention\Validation\Rules\CamelCase)

The given field must be a formated in Camel case.

cidr (Intervention\Validation\Rules\Cidr)

Check if the value is a Classless Inter-Domain Routing notation (CIDR).

creditcard (Intervention\Validation\Rules\Creditcard)

The given field must be a valid creditcard number.

data url (Intervention\Validation\Rules\DataUrl)

The given field must be a valid data url.

domainname (Intervention\Validation\Rules\Domainname)

The given field must be a well formed domainname.

ean (Intervention\Validation\Rules\Ean)

Checks for a valid European Article Number (EAN-8 and EAN-13).

gtin (Intervention\Validation\Rules\Gtin)

Checks for a valid Global Trade Item Number (GTIN-8, GTIN-12, GTIN-13 or GTIN-14).

hexcolor (Intervention\Validation\Rules\HexColor)

The field under validation must be a valid hexadecimal color code.

htmlclean (Intervention\Validation\Rules\HtmlClean)

The field under validation must be free of any html code.

iban (Intervention\Validation\Rules\Iban)

Checks for a valid International Bank Account Number (IBAN).

imei (Intervention\Validation\Rules\Imei)

The given field must be a International Mobile Equipment Identity (IMEI).

isbn (Intervention\Validation\Rules\Isbn)

The field under validation must be a valid International Standard Book Number (ISBN).

isin (Intervention\Validation\Rules\Isin)

Checks for a valid International Securities Identification Number (ISIN).

issn (Intervention\Validation\Rules\Issn)

Checks for a valid International Standard Serial Number (ISSN).

jwt (Intervention\Validation\Rules\Jwt)

The given value must be a in format of a JSON Web Token.

kebabcase (Intervention\Validation\Rules\KebabCase)

The given value must be formated in Kebab case.

lowercase (Intervention\Validation\Rules\LowerCase)

The given value must be all lower case letters.

luhn (Intervention\Validation\Rules\Luhn)

The given value must verify against its included Luhn algorithm check digit.

macaddress (Intervention\Validation\Rules\MacAddress)

The field under validation must be a media access control address (MAC address).

semver (Intervention\Validation\Rules\SemVer)

The given field must be a valid version numbers using Semantic Versioning.

slug (Intervention\Validation\Rules\Slug)

The field under validation must be a user- and SEO-friendly short text.

snakecase (Intervention\Validation\Rules\SnakeCase)

The field under validation must formated as Snake case text.

titlecase (Intervention\Validation\Rules\TitleCase)

The field under validation must formated in Title case.

ulid (Intervention\Validation\Rules\Ulid)

The given field must be a valid Universally Unique Lexicographically Sortable Identifier.

uppercase (Intervention\Validation\Rules\UpperCase)

The field under validation must be all upper case.

username (Intervention\Validation\Rules\Username)

The field under validation must be a valid username with a minimum of 3 characters and maximum of 20 characters. Consisting of alpha-numeric characters, underscores, minus and starting with a alphabetic character. Multiple underscore and minus chars are not allowed. Underscore and minus chars are not allowed at the beginning or end.

License

Intervention Validation is licensed under the MIT License.

fxmonster / validation

Maintainers

Details