Rules Reference

Complete reference for validation rules included in the package.

---

without_alias

Validates that an email address does not contain a plus-addressed sub-alias (e.g. user+tag@gmail.com). Useful for preventing trial abuse and duplicate account creation.

• Class: MrPunyapal\LaravelExtendedValidation\Rules\WithoutAlias
• Macro: Rule::withoutAlias()
• String: without_alias

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\WithoutAlias;
use Illuminate\Validation\Rule;

// Class syntax
'email' => ['required', 'email', new WithoutAlias]

// Macro syntax
'email' => ['required', 'email', Rule::withoutAlias()]

// String syntax
'email' => 'required|email|without_alias'

Examples

---

not_email

Validates that a given string is not a valid email address. Useful for username fields to prevent collisions in applications that allow login with "Email or Username".

• Class: MrPunyapal\LaravelExtendedValidation\Rules\NotEmail
• Macro: Rule::notEmail()
• String: not_email

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\NotEmail;
use Illuminate\Validation\Rule;

'username' => ['required', 'string', 'min:3', 'max:30', new NotEmail]
'username' => ['required', 'string', Rule::notEmail()]
'username' => 'required|string|not_email'

Examples

---

slug

Validates that a string is a clean, URL-friendly slug. Rejects uppercase characters, whitespace, special characters, and consecutive or trailing separators.

• Class: MrPunyapal\LaravelExtendedValidation\Rules\Slug
• Macro: Rule::slug(string $separator = '-')
• String: slug or slug:{separator}

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\Slug;
use Illuminate\Validation\Rule;

// Default dash separator
'slug' => ['required', new Slug]
'slug' => ['required', Rule::slug()]
'slug' => 'required|slug'

// Custom underscore separator
'slug' => ['required', new Slug('_')]
'slug' => ['required', Rule::slug('_')]
'slug' => 'required|slug:_'

Examples (with default -)

---

even

Validates that a numeric input represents an even integer.

• Class: MrPunyapal\LaravelExtendedValidation\Rules\EvenNumber
• Macro: Rule::even()
• String: even

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\EvenNumber;
use Illuminate\Validation\Rule;

'team_size' => ['required', 'integer', new EvenNumber]
'team_size' => ['required', 'integer', Rule::even()]
'team_size' => 'required|integer|even'

Examples

---

odd

Validates that a numeric input represents an odd integer.

• Class: MrPunyapal\LaravelExtendedValidation\Rules\OddNumber
• Macro: Rule::odd()
• String: odd

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\OddNumber;
use Illuminate\Validation\Rule;

'step' => ['required', 'integer', new OddNumber]
'step' => ['required', 'integer', Rule::odd()]
'step' => 'required|integer|odd'

Examples

---

semver

Validates strings against the official Semantic Versioning 2.0.0 specification, including optional pre-release tags and build metadata. Supports strict SemVer without prefix, required v prefix, or optional v prefix.

• Class: MrPunyapal\LaravelExtendedValidation\Rules\Semver
• Macro: Rule::semver(?string $prefix = null)
• String: semver, semver:v, semver:optional

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\Semver;
use Illuminate\Validation\Rule;

// Strict SemVer 2.0.0 (no prefix)
'version' => ['required', new Semver]
'version' => ['required', Rule::semver()]
'version' => 'required|semver'

// Required 'v' prefix (e.g. v1.2.3)
'version' => ['required', Semver::withPrefix()]
'version' => ['required', Rule::semver('v')]
'version' => 'required|semver:v'

// Optional 'v' prefix (accepts both 1.2.3 and v1.2.3)
'version' => ['required', Semver::optionalPrefix()]
'version' => ['required', Rule::semver('optional')]
'version' => 'required|semver:optional'

Examples

---

base64_string

Validates that an attribute is valid base64-encoded data, with optional MIME type filtering for Data URIs and URL-safe base64 support.

• Class: MrPunyapal\LaravelExtendedValidation\Rules\Base64String
• Macro: Rule::base64String(array|string $allowedMimeTypes = [], bool $urlSafe = false)
• String: base64_string, base64_string:url_safe, or base64_string:{mimes}

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\Base64String;
use Illuminate\Validation\Rule;

// Standard base64 payload
'payload' => ['required', new Base64String]

// URL-safe base64 payload (Base64Url using - and _)
'token' => ['required', Base64String::urlSafe()]
'token' => ['required', Rule::base64String(urlSafe: true)]
'token' => 'required|base64_string:url_safe'

// Data URI restricted to specific image types
'avatar' => ['required', new Base64String(['image/png', 'image/jpeg'])]
'avatar' => ['required', Rule::base64String('image/png', 'image/jpeg')]
'avatar' => 'required|base64_string:image/png,image/jpeg'

---

luhn

Validates numeric strings against the Luhn/MOD-10 algorithm. Common for credit cards, debit cards, IMEI numbers, and national identifiers. Formatted strings containing spaces or dashes are accepted, but non-numeric characters are rejected.

• Class: MrPunyapal\LaravelExtendedValidation\Rules\Luhn
• Macro: Rule::luhn()
• String: luhn

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\Luhn;
use Illuminate\Validation\Rule;

'card_number' => ['required', new Luhn]
'card_number' => ['required', Rule::luhn()]
'card_number' => 'required|luhn'

---

min_words

Validates that a string contains at least a specified number of words.

• Class: MrPunyapal\LaravelExtendedValidation\Rules\MinWords
• Macro: Rule::minWords(int $min)
• String: min_words:{min}

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\MinWords;
use Illuminate\Validation\Rule;

'bio' => ['required', 'string', new MinWords(10)]
'bio' => ['required', 'string', Rule::minWords(10)]
'bio' => 'required|string|min_words:10'

---

max_words

Validates that a string does not exceed a specified number of words.

• Class: MrPunyapal\LaravelExtendedValidation\Rules\MaxWords
• Macro: Rule::maxWords(int $max)
• String: max_words:{max}

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\MaxWords;
use Illuminate\Validation\Rule;

'summary' => ['required', 'string', new MaxWords(50)]
'summary' => ['required', 'string', Rule::maxWords(50)]
'summary' => 'required|string|max_words:50'

---

domain

Validates that a string is a valid domain name (FQDN) without requiring http:// or https:// protocol schemes.

• Class: MrPunyapal\LaravelExtendedValidation\Rules\Domain
• Macro: Rule::domain()
• String: domain

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\Domain;
use Illuminate\Validation\Rule;

'website' => ['required', new Domain]
'website' => ['required', Rule::domain()]
'website' => 'required|domain'

Examples

---

e164

Validates international telephone numbers according to the ITU-T E.164 format (+ followed by 2 to 15 digits).

• Class: MrPunyapal\LaravelExtendedValidation\Rules\E164Phone
• Macro: Rule::e164()
• String: e164

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\E164Phone;
use Illuminate\Validation\Rule;

'phone' => ['required', new E164Phone]
'phone' => ['required', Rule::e164()]
'phone' => 'required|e164'

Examples

---

isbn

Validates International Standard Book Numbers (ISBN-10, ISBN-13, or both) with mathematical checksum verification.

• Class: MrPunyapal\LaravelExtendedValidation\Rules\Isbn
• Macro: Rule::isbn(?string $type = null)
• String: isbn, isbn:10, isbn:13

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\Isbn;
use Illuminate\Validation\Rule;

// Accepts either ISBN-10 or ISBN-13
'book' => ['required', new Isbn]
'book' => ['required', Rule::isbn()]
'book' => 'required|isbn'

// ISBN-10 only
'book' => ['required', Isbn::isbn10()]
'book' => ['required', new Isbn('10')]
'book' => ['required', Rule::isbn('10')]
'book' => 'required|isbn:10'

// ISBN-13 only
'book' => ['required', Isbn::isbn13()]
'book' => ['required', new Isbn('13')]
'book' => ['required', Rule::isbn('13')]
'book' => 'required|isbn:13'

---

country_code

Validates ISO 3166-1 country codes (alpha-2 format, alpha-3 format, or either).

• Class: MrPunyapal\LaravelExtendedValidation\Rules\CountryCode
• Macro: Rule::countryCode(string $format = 'alpha2')
• String: country_code, country_code:alpha2, country_code:alpha3, country_code:any

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\CountryCode;
use Illuminate\Validation\Rule;

// ISO 3166-1 alpha-2 (US, GB, IN, DE, JP, etc.)
'country' => ['required', CountryCode::alpha2()]
'country' => ['required', new CountryCode]
'country' => ['required', Rule::countryCode()]
'country' => 'required|country_code'

// ISO 3166-1 alpha-3 (USA, GBR, IND, DEU, JPN, etc.)
'country' => ['required', CountryCode::alpha3()]
'country' => ['required', new CountryCode('alpha3')]
'country' => ['required', Rule::countryCode('alpha3')]
'country' => 'required|country_code:alpha3'

// Accepts either alpha-2 or alpha-3
'country' => ['required', CountryCode::any()]
'country' => ['required', new CountryCode('any')]
'country' => ['required', Rule::countryCode('any')]
'country' => 'required|country_code:any'

---

hex_color

Validates CSS hex color codes (supporting 3, 4, 6, or 8 hexadecimal characters). Supports colors with # (default), without #, or optional #.

• Class: MrPunyapal\LaravelExtendedValidation\Rules\HexColor
• Macro: Rule::hexColor(?string $prefix = null)
• String: hex_color

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\HexColor;
use Illuminate\Validation\Rule;

// Requires '#' prefix (default)
'accent' => ['required', new HexColor]
'accent' => ['required', Rule::hexColor()]
'accent' => 'required|hex_color'

// Without '#' prefix (e.g. 'fff', '4f46e5')
'accent' => ['required', HexColor::withoutHash()]
'accent' => ['required', Rule::hexColor('no_hash')]

// Optional '#' prefix (accepts both 'fff' and '#fff')
'accent' => ['required', HexColor::optionalHash()]
'accent' => ['required', Rule::hexColor('optional_hash')]

Examples

---

latitude

Validates that a numeric coordinate represents a valid latitude between -90 and 90 degrees (inclusive).

• Class: MrPunyapal\LaravelExtendedValidation\Rules\Latitude
• Macro: Rule::latitude()
• String: latitude

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\Latitude;
use Illuminate\Validation\Rule;

'lat' => ['required', new Latitude]
'lat' => ['required', Rule::latitude()]
'lat' => 'required|latitude'

Examples

---

longitude

Validates that a numeric coordinate represents a valid longitude between -180 and 180 degrees (inclusive).

• Class: MrPunyapal\LaravelExtendedValidation\Rules\Longitude
• Macro: Rule::longitude()
• String: longitude

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\Longitude;
use Illuminate\Validation\Rule;

'lng' => ['required', new Longitude]
'lng' => ['required', Rule::longitude()]
'lng' => 'required|longitude'

Examples

---

cidr

Validates that a string is a valid Classless Inter-Domain Routing (CIDR) subnet notation block. Supports IPv4, IPv6, or either.

• Class: MrPunyapal\LaravelExtendedValidation\Rules\Cidr
• Macro: Rule::cidr(?string $version = null)
• String: cidr, cidr:v4, or cidr:v6

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\Cidr;
use Illuminate\Validation\Rule;

// IPv4 or IPv6
'subnet' => ['required', new Cidr]
'subnet' => ['required', Rule::cidr()]
'subnet' => 'required|cidr'

// IPv4 only
'subnet' => ['required', new Cidr('v4')]
'subnet' => ['required', Rule::cidr('v4')]
'subnet' => 'required|cidr:v4'

// IPv6 only
'subnet' => ['required', new Cidr('v6')]
'subnet' => ['required', Rule::cidr('v6')]
'subnet' => 'required|cidr:v6'

Examples

---

email_domain

Validates that an email address belongs to an allowed domain list or does not belong to a blocked domain list. Supports exact domains, wildcards (*.example.com), and automatic subdomain allowance.

• Class: MrPunyapal\LaravelExtendedValidation\Rules\EmailDomain
• Macro: Rule::emailDomain($allowed = [], $blocked = [])
• String: email_domain

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\EmailDomain;
use Illuminate\Validation\Rule;

// Allow specific company domains
'email' => ['required', 'email', EmailDomain::allowed('company.com', 'partner.org')]
'email' => ['required', 'email', Rule::emailDomain(allowed: ['company.com', 'partner.org'])]

// Allow company domain and all of its subdomains (*.company.com)
'email' => ['required', 'email', EmailDomain::allowed('*.company.com')]
'email' => ['required', 'email', EmailDomain::allowed('company.com')->allowSubdomains()]

// Block disposable email providers
'email' => ['required', 'email', EmailDomain::blocked('mailinator.com', 'tempmail.com')]
'email' => ['required', 'email', Rule::emailDomain(blocked: ['mailinator.com', 'tempmail.com'])]

Examples

---

not_hashed

Ensures that a password field is not already passed as an algorithm hash (such as bcrypt or argon). Useful for preventing users or clients from submitting pre-hashed strings when registration or password resets expect plain text to hash on the server.

• Class: MrPunyapal\LaravelExtendedValidation\Rules\NotHashed
• Macro: Rule::notHashed()
• String: not_hashed

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\NotHashed;
use Illuminate\Validation\Rule;

'password' => ['required', 'string', 'min:8', new NotHashed]
'password' => ['required', 'string', 'min:8', Rule::notHashed()]
'password' => 'required|string|min:8|not_hashed'

Examples

---

alpha_underscore

Validates that a string contains only letters, numbers, and underscores (_). Unlike Laravel's native alpha_dash which also permits hyphens (-), alpha_underscore enforces strict identifier naming (like Python or SQL identifiers and usernames). An optional ASCII mode restricts matching to ASCII-only characters.

• Class: MrPunyapal\LaravelExtendedValidation\Rules\AlphaUnderscore
• Macro: Rule::alphaUnderscore(bool $ascii = false)
• String: alpha_underscore, alpha_underscore:ascii

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\AlphaUnderscore;
use Illuminate\Validation\Rule;

// Default mode (Unicode letters, numbers, and underscores)
'username' => ['required', 'string', new AlphaUnderscore]
'username' => ['required', 'string', Rule::alphaUnderscore()]
'username' => 'required|string|alpha_underscore'

// ASCII-only mode
'identifier' => ['required', 'string', AlphaUnderscore::ascii()]
'identifier' => ['required', 'string', Rule::alphaUnderscore(ascii: true)]
'identifier' => 'required|string|alpha_underscore:ascii'

Examples

---

unless_between

Validates that a numeric value falls outside a specified range (i.e. value < min OR value > max). Bounds may be specified in any order; the lower and upper bounds are normalized automatically.

• Class: MrPunyapal\LaravelExtendedValidation\Rules\UnlessBetween
• Macro: Rule::unlessBetween(float|int $min, float|int $max)
• String: unless_between:{min},{max}

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\UnlessBetween;
use Illuminate\Validation\Rule;

'discount' => ['required', new UnlessBetween(10, 20)]
'discount' => ['required', Rule::unlessBetween(10, 20)]
'discount' => 'required|unless_between:10,20'

Examples

---

without_whitespace

Validates that an input string does not contain any whitespace characters (spaces, tabs, or newlines).

• Class: MrPunyapal\LaravelExtendedValidation\Rules\WithoutWhitespace
• Macro: Rule::withoutWhitespace()
• String: without_whitespace

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\WithoutWhitespace;
use Illuminate\Validation\Rule;

'token' => ['required', new WithoutWhitespace]
'token' => ['required', Rule::withoutWhitespace()]
'token' => 'required|without_whitespace'

Examples

---

no_html

Validates that an input string contains no HTML or XML tags.

• Class: MrPunyapal\LaravelExtendedValidation\Rules\NoHtml
• Macro: Rule::noHtml()
• String: no_html

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\NoHtml;
use Illuminate\Validation\Rule;

'comment' => ['required', 'string', new NoHtml]
'comment' => ['required', 'string', Rule::noHtml()]
'comment' => 'required|string|no_html'

Examples

---

url_protocol

Validates that a URL string uses one of the specified protocol schemes. Protocol names can be passed with or without trailing :// (e.g. 'https' or 'https://').

• Class: MrPunyapal\LaravelExtendedValidation\Rules\UrlProtocol
• Macro: Rule::urlProtocol(array|string ...$protocols)
• String: url_protocol:{protocol1},{protocol2}

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\UrlProtocol;
use Illuminate\Validation\Rule;

'website' => ['required', new UrlProtocol('https')]
'website' => ['required', Rule::urlProtocol('https', 'http')]
'website' => 'required|url_protocol:https,http'

// Protocols with trailing '://' are normalized automatically
'website' => ['required', Rule::urlProtocol('https://', 'http://')]

Examples

---

snake_case

Validates that a string is strictly formatted in snake_case (lowercase alphanumeric characters separated by single underscores).

• Class: MrPunyapal\LaravelExtendedValidation\Rules\SnakeCase
• Macro: Rule::snakeCase(?bool $capital = false)
• String: snake_case / snake_case:capital

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\SnakeCase;
use Illuminate\Validation\Rule;

// Standard lowercase snake_case
'column_name' => ['required', new SnakeCase]
'column_name' => ['required', Rule::snakeCase()]
'column_name' => 'required|snake_case'

// ALL_CAPS snake_case (SCREAMING_SNAKE_CASE)
'constant_key' => ['required', SnakeCase::capital()]
'constant_key' => ['required', new SnakeCase(capital: true)]
'constant_key' => ['required', Rule::snakeCase(capital: true)]
'constant_key' => 'required|snake_case:capital'

Examples

---

multiple_of

Validates that a numeric value is an exact multiple of a given step.

• Class: MrPunyapal\LaravelExtendedValidation\Rules\MultipleOf
• Macro: Rule::multipleOf(int|float $step)
• String: multiple_of:{step}

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\MultipleOf;
use Illuminate\Validation\Rule;

'quantity' => ['required', new MultipleOf(5)]
'quantity' => ['required', Rule::multipleOf(5)]
'quantity' => 'required|multiple_of:5'

// Floating point increments
'price' => ['required', new MultipleOf(0.25)]

Examples

---

alpha_num_ascii

Validates that an input contains only standard ASCII alphanumeric characters (a-z, A-Z, 0-9), rejecting multi-byte characters and Unicode homoglyphs.

• Class: MrPunyapal\LaravelExtendedValidation\Rules\AlphaNumAscii
• Macro: Rule::alphaNumAscii()
• String: alpha_num_ascii

Usage

use MrPunyapal\LaravelExtendedValidation\Rules\AlphaNumAscii;
use Illuminate\Validation\Rule;

'code' => ['required', new AlphaNumAscii]
'code' => ['required', Rule::alphaNumAscii()]
'code' => 'required|alpha_num_ascii'

Examples