burtds / laravel-vatnumber-checker
为Laravel提供的一个简单的增值税号码检查包。
v1.0.2
2024-03-14 08:00 UTC
Requires
- php: >=8.1
- guzzlehttp/guzzle: ^7.2
- spatie/laravel-package-tools: ^1.16
Requires (Dev)
- laravel/pint: ^1.13
- orchestra/testbench: ^8.13|^9.0
- pestphp/pest: ^2.0
- spatie/laravel-ray: ^1.33
README
关于laravel-vatnumber-checker
一个小型包,允许您轻松检索与增值税号码相关联的信息。验证有效性、公司名称和公司地址仅需一个API调用。
如何使用laravel-vatnumber-checker
安装
您可以通过composer安装此包
composer require burtds/laravel-vatnumber-checker
之后,您就可以获取所需的信息了。
用法
此包使用由欧洲委员会提供的API,名为"VIES"。
我们将在文件顶部导入此包的外观。
use Burtds\VatChecker\Facades\VatChecker
完成这些操作后,您将能够使用提供的函数。在此示例中,我们使用Vulpo BV的增值税号码。
$validVatNumber = '0749617582' // Vulpo BV's VAT number // returns a raw response of the European Commission's API VatChecker::getRawVatInstance('BE', $validVatNumber); // returns the validity of a VAT number VatChecker::isVatValid('BE', $validVatNumber); // returns the company name related to the VAT number VatChecker::getCompanyName('BE', $validVatNumber); // returns the company address related to the VAT number VatChecker::getCompanyAddress('BE', $validVatNumber);
所有方法均支持单个参数。
$validVatNumber = 'BE0749617582' // Vulpo BV's VAT number // returns a raw response of the European Commission's API VatChecker::getRawVatInstance($validVatNumber); // returns the validity of a VAT number VatChecker::isVatValid($validVatNumber); ...
验证规则
此包还提供了一个简单的验证规则。
use Burtds\VatChecker\Rules\VatNumber; $validatedData = $request->validate([ 'vat_number' => ['required', new VatNumber], ]);
如果提供的增值税号码有效,此示例将通过验证。如果不正确,它将返回一个整洁的错误消息。
测试与代码格式化
对于测试,您可以运行
composer test
对于使用Laravel Pint格式化代码,您可以运行
composer format
安全漏洞
如果您在此包中发现安全漏洞,请通过bert@bert.gent发送电子邮件给我。我会尽快回复您。
鸣谢
许可
此包是开源软件,根据MIT许可证授权。