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.
You can install this package quick and easy with Composer.
Require the package via Composer:
$ composer require intervention/validation
The Validation library is built to work with the Laravel Framework (>=7). It comes with a service provider, which will be discovered automatically and registers the validation rules into your installation. The package provides 30 additional validation rules including error messages, which can be used like Laravel's own validation rules.
use Illuminate\Support\Facades\Validator;
use Intervention\Validation\Rules\Creditcard;
use Intervention\Validation\Rules\HexColor;
use Intervention\Validation\Rules\Username;
$validator = Validator::make($request->all(), [
'color' => new Hexcolor(3), // pass rule as object
'number' => ['required', 'creditcard'], // or pass rule as string
'name' => 'required|min:3|max:20|username', // combining rules works as well
]);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.
It is also possible to use this library without the Laravel framework. You won't have the Laravel facades available, so make sure to use Intervention\Validation\Validator for your calls.
use Intervention\Validation\Validator;
use Intervention\Validation\Rules\Creditcard;
use Intervention\Validation\Exceptions\ValidationException;
// use static factory method to create laravel validator
$validator = Validator::make($request->all(), [
'ccnumber' => new Creditcard(),
'iban' => ['required', 'iban'],
'color' => 'required|hexcolor:3',
]);
// validate single values by calling static methods
$result = Validator::isHexcolor('foobar'); // false
$result = Validator::isHexcolor('#ccc'); // true
$result = Validator::isBic('foo'); // false
// assert single values
try {
Validator::assertHexcolor('foobar');
} catch (ValidationException $e) {
$message = $e->getMessage();
}The following validation rules are available with this package.
The field under validation must be Base64 encoded.
public Intervention\Validation\Rules\Base64::__construct()
Checks for a valid Business Identifier Code (BIC).
public Intervention\Validation\Rules\Bic::__construct()
The field under validation must be a formated in Camel case.
public Intervention\Validation\Rules\Camelcase::__construct()
Check if the value is a Classless Inter-Domain Routing notation (CIDR).
public Intervention\Validation\Rules\Cidr::__construct()
The field under validation must be a valid creditcard number.
public Intervention\Validation\Rules\Creditcard::__construct()
The field under validation must be a valid Data URI.
public Intervention\Validation\Rules\DataUri::__construct()
The field under validation must be a well formed domainname.
public Intervention\Validation\Rules\Domainname::__construct()
Checks for a valid European Article Number.
public Intervention\Validation\Rules\Ean::__construct(?int $length = null)
length
Optional integer length (8 or 13) to check only for EAN-8 or EAN-13.
Checks for a valid Global Trade Item Number.
public Intervention\Validation\Rules\Gtin::__construct(?int $length = null)
length
Optional integer length to check only for certain types (GTIN-8, GTIN-12, GTIN-13 or GTIN-14).
The field under validation must be a valid hexadecimal color code.
public Intervention\Validation\Rules\HexColor::__construct(?int $length = null)
length
Optional length as integer to check only for shorthand (3 characters) or full hexadecimal (6 characters) form.
The field under validation must be free of any html code.
public Intervention\Validation\Rules\HtmlClean::__construct()
Checks for a valid International Bank Account Number (IBAN).
public Intervention\Validation\Rules\Iban::__construct()
The field under validation must be a International Mobile Equipment Identity (IMEI).
public Intervention\Validation\Rules\Imei::__construct()
The field under validation must be a valid International Standard Book Number (ISBN).
public Intervention\Validation\Rules\Isbn::__construct(?int $length = null)
length
Optional length parameter as integer to check only for ISBN-10 or ISBN-13.
Checks for a valid International Securities Identification Number (ISIN).
public Intervention\Validation\Rules\Isin::__construct()
Checks for a valid International Standard Serial Number (ISSN).
public Intervention\Validation\Rules\Issn::__construct()
The given value must be a in format of a JSON Web Token.
public Intervention\Validation\Rules\Jwt::__construct()
The given value must be formated in Kebab case.
public Intervention\Validation\Rules\Kebabcase::__construct()
The given value must be all lower case letters.
public Intervention\Validation\Rules\Lowercase::__construct()
The given value must verify against its included Luhn algorithm check digit.
public Intervention\Validation\Rules\Luhn::__construct()
Checks for a valid Mime Type (Media type).
public Intervention\Validation\Rules\MimeType::__construct()
The field under validation must be a postal code of the given country.
public Intervention\Validation\Rules\Postalcode::__construct(string $countrycode)
countrycode
Country code in ISO-639-1 format.
public static Intervention\Validation\Rules\Postalcode::countrycode(string $countrycode): Postalcode
countrycode
Country code in ISO-639-1 format.
public static Intervention\Validation\Rules\Postalcode::resolve(callable $callback): Postalcode
callback
Callback to resolve ISO-639-1 country code from other source.
public static Intervention\Validation\Rules\Postalcode::reference(string $reference): Postalcode
reference
Reference key to get ISO-639-1 country code from other data in validator.
The field under validation must be a valid version numbers using Semantic Versioning.
public Intervention\Validation\Rules\SemVer::__construct()
The field under validation must be a user- and SEO-friendly short text.
public Intervention\Validation\Rules\Slug::__construct()
The field under validation must formated as Snake case text.
public Intervention\Validation\Rules\Snakecase::__construct()
The field under validation must formated in Title case.
public Intervention\Validation\Rules\Titlecase::__construct()
The field under validation must be a valid Universally Unique Lexicographically Sortable Identifier.
public Intervention\Validation\Rules\Ulid::__construct()
The field under validation must be all upper case.
public Intervention\Validation\Rules\Uppercase::__construct()
The field under validation must be a valid username. 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.
public Intervention\Validation\Rules\Username::__construct()
With this package comes a Docker image to build a test suite container. To build this container you have to have Docker installed on your system. You can run all tests with this command.
$ docker-compose run --rm --build tests
Intervention Validation is licensed under the MIT License.