README

This package provides a preconfigured configuration class for vat number format validators for Portugal country. Is an extension of the package https://github.com/rocketfellows/specific-country-vat-number-format-validators-config.

Installation

composer require rocketfellows/pt-vat-number-format-validators-config

Dependencies

References

List of package components

rocketfellows\PTVatNumberFormatValidatorsConfig\PTVatNumberFormatValidatorsConfig - preconfigured configuration class for vat number format validators for Portugal country;

PTVatNumberFormatValidatorsConfig description

A configuration class that provides a match for the vat number format validators for the country Portugal.

Class interface:

getCountry - returns Portugal Country instance;
getValidators - returns validators tuple

When initializing the default configuration, the getValidators function returns a tuple with a single validator - an instance of PTVatFormatValidator.

$config = new PTVatNumberFormatValidatorsConfig();

$config->getCountry();      // returns Portugal Country instance
$config->getValidators();   // returns CountryVatFormatValidators with one item - instance of PTVatFormatValidator

You can override the default validator by initializing the configuration class object with a new default validator through the first parameter of the class constructor. Attention - validator must implement interface CountryVatFormatValidatorInterface.

$newDefaultValidator = new NewDefaultValidator();                       // instance of CountryVatFormatValidatorInterface
$config = new PTVatNumberFormatValidatorsConfig($newDefaultValidator);  // initialize with new default validator

$config->getValidators();   // returns CountryVatFormatValidators with one item - $newDefaultValidator

You can add additional validators to the default validator via the second constructor parameter.

Attention - additional validators parameter must be instance of tuple CountryVatFormatValidators. And each additional validator must implement interface CountryVatFormatValidatorInterface.

$firstAdditionalValidator = new FirstAdditionalValidator();   // instance of CountryVatFormatValidatorInterface
$secondAdditionalValidator = new SecondAdditionalValidator(); // instance of CountryVatFormatValidatorInterface

$config = new PTVatNumberFormatValidatorsConfig(
    null,
    (
        new CountryVatFormatValidators(
            $firstAdditionalValidator,
            $secondAdditionalValidator
        )
    )
);

// returns CountryVatFormatValidators with three items:
// default preconfigured validator by default - instance of PTVatFormatValidator
// $firstAdditionalValidator - from additional tuple
// $secondAdditionalValidator - from additional tuple
$config->getValidators();

You can also completely rebuild the configuration by passing the default validator and a tuple of additional validators to the config class constructor.

$defaultValidator = new DefaultValidator();                   // instance of CountryVatFormatValidatorInterface
$firstAdditionalValidator = new FirstAdditionalValidator();   // instance of CountryVatFormatValidatorInterface
$secondAdditionalValidator = new SecondAdditionalValidator(); // instance of CountryVatFormatValidatorInterface

$config = new PTVatNumberFormatValidatorsConfig(
    $defaultValidator,
    (
        new CountryVatFormatValidators(
            $firstAdditionalValidator,
            $secondAdditionalValidator
        )
    )
);

// returns CountryVatFormatValidators with three items:
// $defaultValidator from constructor first parameter
// $firstAdditionalValidator - from additional tuple
// $secondAdditionalValidator - from additional tuple
$config->getValidators();

More use case examples can be found in the package's unit tests.

Contributing

Welcome to pull requests. If there is a major changes, first please open an issue for discussion.

Please make sure to update tests as appropriate.

rocketfellows / pt-vat-number-format-validators-config

Maintainers

Details