wirecard/iso-paypal-converter

将ISO 3166-2代码转换为PayPal API所需的代码

此包的规范存储库似乎已消失,因此该包已被冻结。

1.0.0 2018-09-12 11:59 UTC

This package is auto-updated.

Last update: 2023-01-06 16:58:45 UTC


README

ISO 3166-2 alpha 2代码转换为PayPal API所需的代码以识别客户的州。

License PHP v5.6 PHP v7.0 PHP v7.1

安装

可以使用Composer安装此库。
如果您尚未安装Composer,可以按照官方说明进行操作。

安装Composer后,请在终端/命令行工具中运行以下命令

composer require wirecard/iso-paypal-converter

用法

在您的应用程序中加载Composer提供的vendor/autoload.php
然后可以像这样初始化Converter

use Wirecard\IsoToPayPal\Converter;

$converter = new Converter();

这会自动加载所有州映射。

转换

要将ISO 3166-2代码转换为正确的PayPal标识符,只需将国家代码和州标识符传递给转换函数,如下所示

$converter->convert("TH", "50");
// => "Chiang Mai"

或者,您可以像这样传递一个包含州标识符的完整ISO 3166-2代码

$converter->convert("JP-01");
// => "HOKKAIDO"

异常

注意,如果您省略了州参数,第一个参数必须包含一个州标识符,否则您将收到一个InvalidArgumentException

$converter->convert("US");
// => InvalidArgumentException

完整的ISO 3166-2代码采用XX-YY的形式。

如果在转换表中找不到国家,您将收到一个CountryNotFoundException

$converter->convert("AT-1");
// => CountryNotFoundException

最后,如果您声明的国家中找不到州,您将收到一个StateNotFoundException,如下所示

$converter->convert("CA-NY");
// => StateNotFoundException

$converter->convert("US-NY");
// => "NY"