README

本软件包为俄罗斯联邦国家增值税格式验证器提供预配置的配置类。是软件包 https://github.com/rocketfellows/specific-country-vat-number-format-validators-config 的扩展。

安装

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

依赖项

• https://github.com/rocketfellows/specific-country-vat-number-format-validators-config v1.0.0;
• https://github.com/rocketfellows/ru-vat-format-validator v1.0.0;

参考文献

• https://github.com/rocketfellows/country-vat-format-validator-interface
• https://github.com/arslanim/iso-standard-3166

软件包组件列表

• rocketfellows\RUVatNumberFormatValidatorsConfig\RUVatNumberFormatValidatorsConfig - 俄罗斯联邦国家增值税格式验证器的预配置配置类；

RUVatNumberFormatValidatorsConfig 描述

一个配置类，为俄罗斯联邦国家的增值税格式验证器提供匹配。

类接口

• getCountry - 返回俄罗斯联邦 Country 实例；
• getValidators - 返回验证器元组

初始化默认配置时，getValidators 函数返回一个包含单个验证器（RUVatFormatValidator 实例）的元组。

$config = new RUVatNumberFormatValidatorsConfig();

$config->getCountry();      // returns Russian Federation Country instance
$config->getValidators();   // returns CountryVatFormatValidators with one item - instance of RUVatFormatValidator

您可以通过类构造函数的第一个参数使用新的默认验证器覆盖默认验证器。注意 - 验证器必须实现 CountryVatFormatValidatorInterface 接口。

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

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

您还可以通过第二个构造函数参数向默认验证器添加额外的验证器。

注意 - 额外验证器参数必须是 CountryVatFormatValidators 的元组实例。并且每个额外验证器都必须实现 CountryVatFormatValidatorInterface 接口。

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

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

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

您还可以通过将默认验证器和额外验证器的元组传递给配置类构造函数来完全重建配置。

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

$config = new RUVatNumberFormatValidatorsConfig(
    $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();

更多用例示例可以在软件包的单元测试中找到。

贡献

欢迎提交拉取请求。如果发生重大更改，请首先打开一个问题进行讨论。

请确保根据需要更新测试。