README

波兰增值税纳税人

一个简单的库，使用波兰财政部Web服务验证给定的增值税号是否在波兰注册为增值税纳税人。

内容

• 安装
• 使用
• 路线图
• 变更日志
• 许可证

安装

此库可在 Packagist 上找到

$ composer require malek83/polish-vat-payer

使用

使用此库有两种简单的方法

获取验证结果的布尔值

use Malek83\PolishVatPayer\Builder\PolishVatPayerBuilder;
use Malek83\PolishVatPayer\PolishVatPayer;

/** @var PolishVatPayer $validator */
$validator = PolishVatPayerBuilder::builder()->build();

$bool = $validator->isValid('1568255600'); //returns boolean

获取包含所有所需信息的完整响应对象

use Malek83\PolishVatPayer\Builder\PolishVatPayerBuilder;
use Malek83\PolishVatPayer\PolishVatPayer;

/** @var PolishVatPayer $validator */
$validator = PolishVatPayerBuilder::builder()->build();

/** @var \Malek83\PolishVatPayer\Result\PolishVatNumberVerificationResult $result */
$result = $validator->validate('1234567890');

var_dump($result->isValid()); // gives boolean, true if company is VAT Payer, otherwise false
var_dump($result->getVatNumber()); //gives string, the verificated VAT number
var_dump($result->getMessage()); //gives string, the human readable message

请求缓存

如果需要，可以使用请求缓存。可以使用任何PSR-16兼容组件（例如symfony/cache）

默认情况下，缓存是关闭的。要使用缓存，请在构建外观时调用setter方法

use Malek83\PolishVatPayer\Builder\PolishVatPayerBuilder;
use Malek83\PolishVatPayer\PolishVatPayer;

/** @var PolishVatPayer $validator */
$validator = PolishVatPayerBuilder::builder()
    ->setCache(new AnyPsr16CompatibleCache())
    ->setTtl(new DateInterval('PT1H'))
    ->build();

默认TTL为1小时。在构建过程中也可以覆盖。

请求日志

也可以定义请求日志。它是PSR-3兼容的（例如Monolog）

默认情况下是关闭的，要开启它，只需在构建时调用 setLogger

use Malek83\PolishVatPayer\Builder\PolishVatPayerBuilder;
use Malek83\PolishVatPayer\PolishVatPayer;

/** @var PolishVatPayer $validator */
$validator = PolishVatPayerBuilder::builder()
    ->setLogger(new AnyPsr3CompatibleLogger())
    ->build();

路线图

所有未来功能均列在 Roadmap GitHub项目 中。

变更日志

请参阅 CHANGELOG 文件以获取有关最近更改的更多信息。

开发与测试的本地环境

$ docker build -t polish-vat-payer ./docker/

$ docker run -d --name polish-vat-payer --volume ${PWD}:/source polish-vat-payer

许可证

MIT许可证（MIT）。请参阅 许可证 获取更多信息。