marshmallow / validation
Additional validation rules for the Laravel framework
Fund package maintenance!
Intervention
paypal.me/interventionio
Installs: 3 658
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 0
Forks: 66
Open Issues: 0
Requires
- php: ^8.1
- ext-mbstring: *
- illuminate/validation: ^10|^11
Requires (Dev)
- phpstan/phpstan: ^1
- phpunit/phpunit: ^10.0
- slevomat/coding-standard: ~8.0
- squizlabs/php_codesniffer: ^3.8
- symfony/uid: ^5.1|^6.2
- dev-master
- v4.x-dev
- v4.0.0
- v3.2.0
- v3.1.3
- v3.1.2
- v3.1.1
- 3.1.0
- 3.0.3
- 3.0.2
- 3.0.1
- 3.0.0
- 3.0.0-beta.3
- 3.0.0-beta.2
- 3.0.0-beta.1
- 3.0.0-alpha.1
- v2.x-dev
- 2.9.0
- 2.8.0
- 2.7.0
- 2.6.8
- 2.6.7
- 2.6.6
- 2.6.5
- 2.6.4
- 2.6.3
- 2.6.2
- 2.6.1
- 2.6.0
- 2.5.2
- 2.5.1
- 2.5.0
- 2.4.2
- 2.4.1
- 2.4.0
- 2.3.4
- 2.3.3
- 2.3.2
- 2.3.1
- 2.3.0
- 2.2.0
- 2.1.1
- 2.1.0
- 2.0.3
- 2.0.2
- 2.0.1
- 2.0.0
- 2.0.0-beta3
- 2.0.0-beta2
- 2.0.0-beta1
- v1.x-dev
- 1.4.3
- 1.4.2
- 1.4.1
- 1.4.0
- 1.3.0
- 1.2.1
- 1.2.0
- 1.1.12
- 1.1.11
- 1.1.10
- 1.1.9
- 1.1.8
- 1.1.7
- 1.1.6
- 1.1.5
- 1.1.4
- 1.1.3
- 1.1.2
- 1.1.1
- 1.1.0
- 1.0.8
- 1.0.7
- 1.0.6
- 1.0.5
- 1.0.4
- 1.0.3
- 1.0.2
- 1.0.1
- 1.0.0
This package is auto-updated.
Last update: 2024-11-12 12:43:00 UTC
README
Marshmallow 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 marshmallow/validation
Laravel integration
The Validation library is built to work with the Laravel Framework (>=10). 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 multi language error messages, which can be used like Laravel's own validation rules.
use Illuminate\Support\Facades\Validator; use Marshmallow\Validation\Rules\Creditcard; use Marshmallow\Validation\Rules\Hexadecimalcolor; use Marshmallow\Validation\Rules\Username; $validator = Validator::make($request->all(), [ 'color' => new Hexadecimalcolor([3, 6]), // pass rule as object 'number' => ['required', 'creditcard'], // or pass rule as string 'name' => 'required|min:3|max:20|username', // combining rules works as well ]);
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 with this package.
Base64 encoded string
The field under validation must be Base64 encoded.
public Marshmallow\Validation\Rules\Base64::__construct()
Business Identifier Code (BIC)
Checks for a valid Business Identifier Code (BIC).
public Marshmallow\Validation\Rules\Bic::__construct()
Camel case string
The field under validation must be a formated in Camel case.
public Marshmallow\Validation\Rules\Camelcase::__construct()
Classless Inter-Domain Routing (CIDR)
Check if the value is a Classless Inter-Domain Routing notation (CIDR).
public Marshmallow\Validation\Rules\Cidr::__construct()
Creditcard Number
The field under validation must be a valid creditcard number.
public Marshmallow\Validation\Rules\Creditcard::__construct()
Data URI scheme
The field under validation must be a valid Data URI.
public Marshmallow\Validation\Rules\DataUri::__construct(?array $media_types = null)
Domain name
The field under validation must be a well formed domainname.
public Marshmallow\Validation\Rules\Domainname::__construct()
European Article Number (EAN)
Checks for a valid European Article Number.
public Marshmallow\Validation\Rules\Ean::__construct(array $lengths = [8, 13])
Parameters
length
Optional integer length (8 or 13) to check only for EAN-8 or EAN-13.
Global Trade Item Number (GTIN)
Checks for a valid Global Trade Item Number.
public Marshmallow\Validation\Rules\Gtin::__construct(array $lengths = [8, 12, 13, 14])
Parameters
length
Optional array of allowed lengths to check only for certain types (GTIN-8, GTIN-12, GTIN-13 or GTIN-14).
Hexadecimal color code
The field under validation must be a valid hexadecimal color code.
public Marshmallow\Validation\Rules\Hexadecimalcolor::__construct(array $lengths = [3, 4, 6, 8])
Parameters
length
Optional length as integer to check only for shorthand (3 or 4 characters) or full hexadecimal (6 or 8 characters) form.
Text without HTML
The field under validation must be free of any html code.
public Marshmallow\Validation\Rules\HtmlClean::__construct()
International Bank Account Number (IBAN)
Checks for a valid International Bank Account Number (IBAN).
public Marshmallow\Validation\Rules\Iban::__construct()
International Mobile Equipment Identity (IMEI)
The field under validation must be a International Mobile Equipment Identity (IMEI).
public Marshmallow\Validation\Rules\Imei::__construct()
International Standard Book Number (ISBN)
The field under validation must be a valid International Standard Book Number (ISBN).
public Marshmallow\Validation\Rules\Isbn::__construct(array $lengths = [10, 13])
Parameters
length
Optional length parameter as integer to check only for ISBN-10 or ISBN-13.
International Securities Identification Number (ISIN)
Checks for a valid International Securities Identification Number (ISIN).
public Marshmallow\Validation\Rules\Isin::__construct()
International Standard Serial Number (ISSN)
Checks for a valid International Standard Serial Number (ISSN).
public Marshmallow\Validation\Rules\Issn::__construct()
JSON Web Token (JWT)
The given value must be a in format of a JSON Web Token.
public Marshmallow\Validation\Rules\Jwt::__construct()
Kebab case string
The given value must be formated in Kebab case.
public Marshmallow\Validation\Rules\Kebabcase::__construct()
Lower case string
The given value must be all lower case letters.
public Marshmallow\Validation\Rules\Lowercase::__construct()
Luhn algorithm
The given value must verify against its included Luhn algorithm check digit.
public Marshmallow\Validation\Rules\Luhn::__construct()
Media (MIME) type
Checks for a valid Mime Type (Media type).
public Marshmallow\Validation\Rules\MimeType::__construct()
Postal Code
The field under validation must be a postal code of the given country.
public Marshmallow\Validation\Rules\Postalcode::__construct(array $countrycodes = [])
Parameters
countrycode
Country code in ISO-639-1 format.
Postal Code (static instantiation)
public static Marshmallow\Validation\Rules\Postalcode::countrycode(array $countrycodes): Postalcode
Parameters
countrycode
Country code in ISO-639-1 format.
Postal Code (static instantiation with reference)
public static Marshmallow\Validation\Rules\Postalcode::reference(string $reference): Postalcode
Parameters
reference
Reference key to get ISO-639-1 country code from other data in validator.
Semantic Version Number
The field under validation must be a valid version numbers using Semantic Versioning.
public Marshmallow\Validation\Rules\SemVer::__construct()
SEO-friendly short text (Slug)
The field under validation must be a user- and SEO-friendly short text.
public Marshmallow\Validation\Rules\Slug::__construct()
Snake case string
The field under validation must formated as Snake case text.
public Marshmallow\Validation\Rules\Snakecase::__construct()
Title case string
The field under validation must formated in Title case.
public Marshmallow\Validation\Rules\Titlecase::__construct()
Universally Unique Lexicographically Sortable Identifier (ULID)
The field under validation must be a valid Universally Unique Lexicographically Sortable Identifier.
public Marshmallow\Validation\Rules\Ulid::__construct()
Upper case string
The field under validation must be all upper case.
public Marshmallow\Validation\Rules\Uppercase::__construct()
Username
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 Marshmallow\Validation\Rules\Username::__construct()
Development & Testing
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
License
Marshmallow Validation is licensed under the MIT License.