mirror of https://github.com/Respect/Validation.git synced 2026-03-17 23:59:51 +01:00

Henrique Moody 48405271c5

Replace placeholder "name" with "subject"

The `{{name}}` placeholder could represent different things depending on
the state of the Result, and referring to it as `{{name}}` seems
arbitrary. This commit changes it to `{{subject}}`, which is much more
generic and it describes well what that placeholder can mean.

2025-12-26 21:30:01 +01:00

1.9 KiB

Raw Blame History

PostalCode

PostalCode(string $countryCode, bool $formatted = false)

Validates whether the input is a valid postal code or not.

v::postalCode('BR')->isValid('02179000'); // true
v::postalCode('BR')->isValid('02179-000'); // true
v::postalCode('US')->isValid('02179-000'); // false
v::postalCode('US')->isValid('55372'); // true
v::postalCode('PL')->isValid('99-300'); // true

By default, PostalCode won't validate the format (puncts, spaces), unless you pass $formatted = true:

v::postalCode('BR', true)->isValid('02179000'); // false
v::postalCode('BR', true)->isValid('02179-000'); // true

Message template for this validator includes {{countryCode}}.

Extracted from GeoNames.

Templates

`PostalCode::TEMPLATE_STANDARD`

Mode	Template
`default`	{{subject}} must be a valid postal code on {{countryCode}}
`inverted`	{{subject}} must not be a valid postal code on {{countryCode}}

Template placeholders

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

Categorization

Localization
Strings

Changelog

Version	Description
2.3.0	Add option to validate formatting
2.2.4	Cambodian postal codes now support 5 and 6 digits
0.7.0	Created

1.9 KiB Raw Blame History