mirror of https://github.com/Respect/Validation.git synced 2026-03-14 14:25:45 +01:00

Alexandre Gomes Gaigalas 16148e9593 Standardize and improve validation message templates

- Remove redundant "valid" prefix:
   Date, DateTime, DateTimeDiff, Domain, Email, Iban, Imei, Ip, Isbn, Json, LanguageCode, LeapDate, LeapYear, Luhn, MacAddress, NfeAccessKey, Nif, Nip, Pesel, Phone, Pis, PolishIdCard, PostalCode, Roman, Slug, Tld, Url, Uuid, Version.

 - Remove redundant "value" suffix
   ArrayVal, BoolVal, Countable, FloatVal, IntVal, IterableVal, NumericVal, ScalarVal, StringVal.

 - Standardize "consist only of" phrasing
   Alnum, Alpha, Cntrl, Consonant, Digit, Graph, Lowercase, Printable, Punct, Space, Spaced, Uppercase, Vowel, Xdigit.

 - Improve file accessibility messages
   Directory, Executable, File, Image, Readable, SymbolicLink, Writable.

 - Improve grammar and article usage
   CreditCard, Extension, Mimetype, Regex, Size.

2026-02-03 19:58:55 +00:00

2.5 KiB

Raw Blame History

CountryCode

CountryCode()
CountryCode("alpha-2"|"alpha-3"|"numeric" $set)

Validates whether the input is a country code in ISO 3166-1 standard.

This validator requires sokil/php-isocodes and sokil/php-isocodes-db-only to be installed.

v::countryCode()->assert('BR');
// Validation passes successfully

v::countryCode('alpha-2')->assert('NL');
// Validation passes successfully

v::countryCode('alpha-3')->assert('USA');
// Validation passes successfully

v::countryCode('numeric')->assert('504');
// Validation passes successfully

This validator supports the three sets of country codes:

ISO 3166-1 alpha-2: alpha-2
ISO 3166-1 alpha-3: alpha-3
ISO 3166-1 numeric: numeric

When no set is defined, the validator uses 'alpha-2' (CountryCode::ALPHA2).

Templates

`CountryCode::TEMPLATE_STANDARD`

Mode	Template
`default`	{{subject}} must be a country code
`inverted`	{{subject}} must not be a country code

Template placeholders

Placeholder	Description
`subject`	The validated input or the custom validator name (if specified).

Categorization

ISO codes
Localization

Changelog

Version	Description
3.0.0	Templates changed
3.0.0	Require sokil/php-isocodes and sokil/php-isocodes-db-only
2.0.0	Became case-sensitive
0.5.0	Created

2.5 KiB Raw Blame History