README

This package provides an Extended Laravel Validator with many useful additional rules!

Laravel Excended Validator

Main Advantages

Time-Saving

Extends Laravel's great built-in validator with commonly used validation rules avoiding you to search the internet for "the golden regex" and extending validator yourself :)

Just register the service provider and rules are ready to use!

Excusive validation rules

Some hard-to-find validation rules available for you as if they where included in Laravel.

Installation

The only requirement is to have a Laravel or Lumen project. I asume your are already familiar with one of them, otherwise here are some docs about this great framework:

Laravel -> https://laravel.com
Lumen -> https://lumen.laravel.com

Laravel version Compatibility

Lumen version Compatibility

Install the package via Composer

$ composer require krazydanny/laravel-validator

Usage

We only have to register the service provider in our project and all new rules are ready to use :)

$app->register( KrazyDanny\Laravel\Validation\ServiceProvider::class );

For example:

$myValidator = Validator::make(
	$values,
	[
		'lat' => 'latitude',
		'lng' => 'longitude',
		'mac' => 'mac_address',
	],
	$messages
);

Rules

Here's a list of all available validation rules:

array_of_regex
alpha_blank
boolean_strict
camel_case
color_hex
date_gt_max
date_gt_min
date_lt_max
date_lt_min
document_number
float
geo_distance
kebab_case
latitude
longitude
mac_address
object
pascal_case
snake_case

array_of_regex

Iterates array values verifying each element matches a given regular expression.

Synthax:

array_of_regex

$myValidator = Validator::make(
	$values,
	[
		'attributes' => 'array_of_regex:/(some_regex)/',
	],
	[
		'attributes.array_of_regex' => 'Some message',
	]
);

MATCH examples:

[ 'value A', 'value B', 'value C' ]
[]

NO MATCH examples:

'value A, value B, value C'
"[ 'value A', 'value B', 'value C' ]"
"[]"

boolean_strict

Checks if value's data type is strictly bool.

Synthax:

boolean_strict

$myValidator = Validator::make(
	$values,
	[
		'active' => 'boolean_strict',
	],
	[
		'active.boolean_strict' => 'Some message',
	]
);

MATCH examples:

true
false

NO MATCH examples:

1
0
'true'
'false'

camel_case

Checks if value is a string formatted using camelCase notation.

Synthax:

camel_case

$myValidator = Validator::make(
	$values,
	[
		'var_name' => 'camel_case',
	],
	[
		'var_name.camel_case' => 'Some message',
	]
);

MATCH examples:

'camel',
'camelCase'
'camelCaseN'
'camelCaseNotation'

NO MATCH examples:

'Camel',
'CamelCase',
'camelcase',
'NCamelCase'

color_hex

Checks if a string represents a hexadecimal color code.

Synthax:

color_hex

$myValidator = Validator::make(
	$values,
	[
		'color'  => 'color_hex',
		'colors' => 'color_hex', // also works with an array of values
	],
	[
		'color.color_hex' => 'Some message',
	]
);

MATCH examples:

'#FFFFFF'
'#FF3333'
'#ffffff'
'#5AD66A'

NO MATCH examples:

'FFFFFF'
'#FF33'
'#FF3333A'
'#'

date_gt_min

Checks if a date (value) is greater than another date (first parameter) at least by the given seconds (second parameter).

Third parameter (optional) could be date's (value) format.

Synthax:

date_gt_min:lower_date,diff_in_seconds,format

$myValidator = Validator::make(
	$values,
	[
		'start_at' => 'date_gt_min:2020-03-01 00:00:00,86400',
	],
	[
		'start_at.date_gt_min' => 'Some message',
	]
);

date_gt_max

Checks if a date (value) is greater than another date (first parameter) by the given seconds as much (second parameter).

Third parameter (optional) could be date's (value) format.

Synthax:

date_gt_max:lower_date,diff_in_seconds,format

$myValidator = Validator::make(
	$values,
	[
		'start_at' => 'date_gt_max:2020-03-01 00:00:00,86400',
	],
	[
		'start_at.date_gt_max' => 'Some message',
	]
);

date_lt_min

Checks if a date (value) is lower than another date (first parameter) at least by the given seconds (second parameter).

Third parameter (optional) could be date's (value) format.

Synthax:

date_lt_min:greater_date,diff_in_seconds,format

$myValidator = Validator::make(
	$values,
	[
		'start_at' => 'date_lt_min:2020-03-01 00:00:00,86400',
	],
	[
		'start_at.date_lt_min' => 'Some message',
	]
);

date_lt_max

Checks if a date (value) is lower than another date (first parameter) by the given seconds as much (second parameter).

Third parameter (optional) could be date's (value) format.

Synthax:

date_lt_max:greater_date,diff_in_seconds,format

$myValidator = Validator::make(
	$values,
	[
		'start_at' => 'date_lt_max:2020-03-01 00:00:00,86400',
	],
	[
		'start_at.date_lt_max' => 'Some message',
	]
);

document_number

Checks if value is a valid reference number for any kind of document or paper.

Synthax:

$myValidator = Validator::make(
	$values,
	[
		'id_doc'       => 'document_number',
		'license_num'  => 'document_number',
		'passport_num' => 'document_number',
	],
	[
		'passport_num.document_number' => 'Some message',
	]
);

MATCH examples:

'123123123123'
'abcabcabcabc'
'a1b2c3d4e5f6'
'20-30764053-0'
'20/30764053/0'
'20 30764053 0'
'20/3076 405-30'
'20/3076.405-30'
'a1-b2c3d4e5f-6'

NO MATCH examples:

'20--30764053-0'
'20//30764053/0'
'20  30764053 0'
'20/3076..405-30'
'N° 23123123312'
'n° 23123123312'
'n°23123123312'

float

Checks if value is a floating point number. With the 'strict' parameter also checks the data type.

Synthax:

$myValidator = Validator::make(
	$values,
	[
		'price' => 'float',
		'rate'  => 'float:strict',
	],
	[
		'price.float' => 'Some message',
		'rate.float'  => 'Some message',
	]
);

MATCH examples:

0
100
0.00
0.01
100.00
100.01
'0'
'100'
'0.00'
'0.01'
'100.00'
'100.01'

NO MATCH examples:

'0,00'
'100,00'

geo_distance

Checks if value is an integer representing "earth distance". Value can specify the following units at the end of the value: "km" or "m"

Synthax:

$myValidator = Validator::make(
	$values,
	[
		'distance' => 'geo_distance',
		'radius'   => 'geo_distance',
	],
	[
		'distance.geo_distance' => 'Some message',
		'radius.geo_distance'   => 'Some message',
	]
);

MATCH examples:

0
100
1000
'0'
'1m'
'100km'

NO MATCH examples:

-1
'-1m'
'100k'

kebab_case

Checks if value is a string formatted using kebab-case notation.

Synthax:

kebab_case

$myValidator = Validator::make(
	$values,
	[
		'category' => 'kebab_case',
	],
	[
		'category.kebab_case' => 'Some message',
	]
);

MATCH examples:

'kebabcase',
'kebab-case'
'kebab-case-notation'

NO MATCH examples:

'kebabCase',
'kebab-Case',
'Kebab-case',

latitude

Checks if value is valid latitude (between 90 and -90 degrees).

Synthax:

latitude

$myValidator = Validator::make(
	$values,
	[
		'lat' => 'latitude',
	],
	[
		'lat.latitude' => 'Some message',
	]
);

MATCH examples:

1
90
-90
1.00,
30.010203
-67.50685
90.000000
-80.9999900000999

NO MATCH examples:

91
-91
-100
180.00
90.00000000000001
-90.00000000000001

longitude

Checks if value is valid longitude (between 180 and -180 degrees).

Synthax:

longitude

$myValidator = Validator::make(
	$values,
	[
		'lng' => 'longitude',
	],
	[
		'lng.longitude' => 'Some message',
	]
);

MATCH examples:

1
-180
180.00,
30.010203
-67.50685
90.000000
-179.9999900000999

NO MATCH examples:

181
-181
188.99
200.000
180.00000000000001
-180.00000000000001

mac_address

Checks if value is a valid IEEE 802 MAC Address.

Synthax:

mac_address

$myValidator = Validator::make(
	$values,
	[
		'mac_addr' => 'mac_address',
	],
	[
		'mac_addr.mac_address' => 'Some message',
	]
);

MATCH examples:

'00:00:00:00:00:00'
'EE:EE:EE:EE:EE:EE'
'A1:01:A2:02:A3:03'

NO MATCH examples:

000000000000
'A1:01:A2:02'
'A1.01.A2.02.A3.03'
'A1 01 A2 02 A3 03'
'A1:01:A2:02:A3:03:'

object

Checks if value is an object or an array representing an object.

Synthax:

object

$myValidator = Validator::make(
	$values,
	[
		'attributes' => 'object',
	],
	[
		'attributes.object' => 'Some message',
	]
);

MATCH examples:

[ 'fieldA' => 'value A', 'fieldB' => "value B" ]
new stdClass
(object)[ 'field' => 'value' ]

NO MATCH examples:

[ 'value A', 'value B' ]
"{}"

pascal_case

Checks if value is a string formatted using PascalCase notation.

Synthax:

pascal_case

$myValidator = Validator::make(
	$values,
	[
		'class_name' => 'pascal_case',
	],
	[
		'class_name.pascal_case' => 'Some message',
	]
);

MATCH examples:

'Pascal'
'Pascalcase'
'PascalCase'
'PascalCaseN'
'PascalCaseNotation'

NO MATCH examples:

'pascal'
'pascalCase'
'pascalcase'
'nPascalCase'

snake_case

Checks if value is a string formatted using snake_case notation.

Synthax:

snake_case

$myValidator = Validator::make(
	$values,
	[
		'param_name' => 'snake_case',
	],
	[
		'param_name.snake_case' => 'Some message',
	]
);

MATCH examples:

'snakecase'
'snake_case'
'snake_case_n'
'n_snake_case'
'snake_case_notation'

NO MATCH examples:

'Snake_case'
'snake_Case'
'snake_CaseNotation'
'N_snake_case'
'snake_caseN'
'snake_case_N'

krazydanny / laravel-validator

Maintainers

Details

README

Main Advantages

Time-Saving

Excusive validation rules

Installation

Laravel version Compatibility

Lumen version Compatibility

Install the package via Composer

Usage

Rules

array_of_regex

boolean_strict

camel_case

color_hex

date_gt_min

date_gt_max

date_lt_min

date_lt_max

document_number

float

geo_distance

kebab_case

latitude

longitude

mac_address

object

pascal_case

snake_case