Download the PHP package kreyu/nip-validator-bundle without Composer
On this page you can find all versions of the php package kreyu/nip-validator-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download kreyu/nip-validator-bundle
More information about kreyu/nip-validator-bundle
Files in kreyu/nip-validator-bundle
Package nip-validator-bundle
Short Description Validate the NIP/TIN numbers with configurable validation constraint
License MIT
Informations about the package nip-validator-bundle
NIP/TIN Validator Bundle
Validate the tax identification numbers with configurable validation constraint.
Requirements
- Symfony validator >=6.1
- PHP >=8.1
For PHP 7.0 & Symfony 3.4, look at v1.x version.
Installation
To download the bundle, require it using the Composer:
Usage
Like with all Symfony validation constraints, you can apply it by using annotations:
or by using attributes:
or by using YAML:
or by using XML:
or by using PHP:
Pattern validation
By default, the only accepted format is a string of characters without the prefix nor dashes.
Usage of dashes
If you wish to allow or require the usage of the dashes, use the allowDashes
and requireDashes
options:
Both options are set to false
by default.
Setting the requireDashes
option to true
ignores the value of the allowDashes
, as the number without dashes is no longer valid.
The allowed formats with dashes are following:
XX-XXX-XXX-XX
, e.g.34-208-769-99
XXX-XXX-XX-XX
, e.g.342-087-69-99
Usage of prefix
If you wish to allow or require the usage of the prefix, use the allowPrefix
and requirePrefix
options.
Additionally, it is possible to modify the length of the prefix, using the prefixLength
option.
Both allowPrefix
and requirePrefix
options are set to false
by default, and prefixLength
defaults to 2
.
Prefixes are not followed with the space:
PPXXXXXXXXXX
, e.g.PL3420876999
Customization of the pattern violation message
It is possible to customize the pattern violation message using the patternMessage
option:
You can use the following parameters in this message:
Parameter | Description |
---|---|
{{ value }} |
The current (invalid value) |
{{ pattern }} |
The regular expression pattern used in the validation |
Usage of a custom regular expression
If the default functionality does not meet your needs, consider using the pattern
option:
By default this option is equals null
, and setting it to any other value ignores the allowDashes
, requireDashes
, allowPrefix
and requirePrefix
options.
Checksum validation
By default, the checksum is being validated. If you wish to disable this feature, set the checksum
option to false
:
Customization of the checksum violation message
It is possible to customize the checksum violation message using the checksumMessage
option:
You can use the following parameters in this message:
Parameter | Description |
---|---|
{{ value }} |
The current (invalid value) |
Usage of a callable normalizer
It is possible to define the PHP callable to apply on the value before the validation, using the normalizer
option:
License
The MIT License (MIT). Please see license file for more information.