SubdivisionCode

February 5, 2026 ยท View on GitHub

  • SubdivisionCode(string $countryCode)

Validates subdivision country codes according to ISO 3166-2.

The $countryCode must be a country in ISO 3166-1 alpha-2 format.

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

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

v::subdivisionCode('US')->assert('CA');
// Validation passes successfully

Templates

SubdivisionCode::TEMPLATE_STANDARD

ModeTemplate
default{{subject}} must be a subdivision code of {{countryName|trans}}
inverted{{subject}} must not be a subdivision code of {{countryName|trans}}

Template placeholders

PlaceholderDescription
countryName
subjectThe validated input or the custom validator name (if specified).

Categorization

  • ISO codes
  • Localization

Changelog

VersionDescription
3.0.0Require sokil/php-isocodes and sokil/php-isocodes-db-only
1.0.0Created

See Also