sunafkafl / vies-parser
解析 VIES API 中的地址
v0.5.5
2023-10-11 10:55 UTC
Requires
- php: >=7.2
README
此库旨在解析欧盟 VIES API(增值税信息交换系统)返回的地址。通常,API 以一个字符串的形式返回地址,而不是街道、城市、邮编。这可能会对自动化造成很大问题。
支持的国家在 get_supported_countries() 中,目前包括 ['SK', 'NL', 'BE', 'FR', 'PT', 'IT', 'FI', 'RO', 'SI', 'AT', 'PL', 'HR', 'EL', 'DK', 'EE', 'CZ']。
我会尝试添加更多国家,或者随着从生产项目中获得更多数据而调整解析器。
请注意,对于某些国家(例如 DE、IE),由于 VIES API 不返回或过于不一致,无法解析地址。
安装
要安装最新版本,请使用 composer require sunkaflek/vies-parser
。
用法
<?php use ViesParser\ViesParser; require_once __DIR__ . '/vendor/autoload.php'; $parser = new ViesParser(); $address = "Havenlaan 2\n1080 Sint-Jans-Molenbeek"; $vat = 'BE0462920226'; $parsed_address = $parser->get_parsed_address($vat, $address); if ($parsed_address) { var_dump($parsed_address); } else { echo 'cant parse yet'; }
选项
选项作为数组通过 get_parsed_address 调用的第三个参数传递,例如
$parser->get_parsed_address($vat, $address, ['sk_delete_mc']);
可用的选项有
sk_delete_mc
从斯洛伐克增值税的城市名称中删除 "Mestka cast" 或其缩写 "m. c. ",以节省空间,地址中不需要它do_not_greeklish
不要尝试将希腊语地址转换为拉丁字符
注意事项
可以使用例如 https://github.com/DragonBe/vies 这样的出色库来获取 VIES API 的地址。