sunafkafl/vies-parser

解析 VIES API 中的地址

v0.5.5 2023-10-11 10:55 UTC

This package is auto-updated.

Last update: 2024-09-11 12:49:58 UTC


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 的地址。