README

主要用途

提供台湾的银行代码清单 JSON 格式，数据来源为财金资讯股份有限公司的开放数据 XML 文件，通过 PHP 将 XML 转换为 JSON 格式以便使用。

关于此程序

尽管财金资讯股份有限公司的开放数据提供了完整的 XML 或 CSV 格式的清单，但实际上内容包含了各种不同类型的银行代码清单：

全国性缴费/税业务-活期性账户缴费作业
外汇结算平台-美元
外汇业务-证券汇款
外汇业务-公库汇款
...

一般情况下我们只需要 网络ATM、外汇业务-入户新汇 或 跨行自动化服务机器业务(金融卡) 类型的清单即可，因此此程序下载 XML 后只会将这些类型的清单处理为 JSON 格式的文件。

安装

通过 Composer 安装

composer require wsmwason/taiwan-bank-code

简易使用方式

获取 网络ATM 银行代码清单

$taiwanBankCode = new wsmwason\TaiwanBankCode();
$bankCodeList = $taiwanBankCode->listBankCodeATM();

获取 外汇业务-入户新汇 银行代码清单

$taiwanBankCode = new wsmwason\TaiwanBankCode();
$bankCodeList = $taiwanBankCode->listBankCodeTT();

获取 跨行自动化服务机器业务(金融卡) 银行代码清单

$taiwanBankCode = new wsmwason\TaiwanBankCode();
$bankCodeList = $taiwanBankCode->listBankCodeCrossATM();

只要 data/ 目录内含有 JSON 文件，就能通过 listBankCodeATM() 或 listBankCodeTT() 获取银行代码清单。

可获取 ATM 的 Array：

Array
(
    [0] => Array
        (
            [code] => 004
            [name] => 臺灣銀行
        )

    [1] => Array
        (
            [code] => 005
            [name] => 臺灣土地銀行
        )
	...
)

或者直接读取 data/ 目录的 JSON 使用。

更新来源

原本不想在项目内放置 XML，不过台湾的银行代码变动应该不算太频繁，如果有更新时之后会再发布新版来更新 JSON 内容。

不过如果真的想直接更新的话，还是可以用 TaiwanBankCodeDataUpdate 下载 XML 以及转换 JSON 格式文件，如果有更新可以顺手发个 PR 发布新版。

执行下载 XML 及转换 JSON

$taiwanBankCodeDataUpdate = new wsmwason\TaiwanBankCodeDataUpdate();

// Download XML
$taiwanBankCodeDataUpdate->updateXmlFromFisc();

// Convert to Json
$taiwanBankCodeDataUpdate->convertJsonFromXml();

版本记录

1.0.0 正式发布

许可证

MIT 许可证 (MIT)

wsmwason / taiwan-bank-code

维护者

详细信息