mirror of https://github.com/Respect/Validation.git synced 2026-03-15 06:45:44 +01:00

Alexandre Gomes Gaigalas d9cdc118b2 Introduce REUSE compliance

This commit introduces REUSE compliance by annotating all files
with SPDX information and placing the reused licences in the
LICENSES folder.

We additionally removed the docheader tool which is made obsolete
by this change.

The main LICENSE and copyright text of the project is now not under
my personal name anymore, and it belongs to "The Respect Project
Contributors" instead.

This change restores author names to several files, giving the
appropriate attribution for contributions.

2026-01-21 06:28:11 +00:00

2.3 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 valid country code
`inverted`	{{subject}} must not be a valid 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	Require sokil/php-isocodes and sokil/php-isocodes-db-only
2.0.0	Became case-sensitive
0.5.0	Created

2.3 KiB Raw Blame History