genkgo/camt

用于读取CAMT文件的库(包含银行对账单的XML文件)。

2.8.0 2024-08-06 08:26 UTC

README

Build Status Code Coverage Total Downloads Latest Stable Version License

用于读取CAMT文件的库。目前仅支持CAMT.052, CAMT.053和CAMT.054。

支持版本

Camt 052

Camt 053

Camt 054

安装

可以通过Composer安装和自动加载。

composer require genkgo/camt

入门指南

读取CAMT文件,并遍历其对账单和条目。

<?php
use Genkgo\Camt\Config;
use Genkgo\Camt\Reader;

$reader = new Reader(Config::getDefault());
$message = $reader->readFile('test/data/camt053.v2.minimal.xml');
$statements = $message->getRecords();
foreach ($statements as $statement) {
    $entries = $statement->getEntries();
}

XSD验证

该库为每个支持的CAMT格式提供XSD验证。默认情况下执行验证。但在某些情况下,您可能想禁用它。

<?php
use Genkgo\Camt\Config;
use Genkgo\Camt\Reader;

$config = Config::getDefault();
$config->disableXsdValidation();

$reader = new Reader($config);

贡献

  • 发现了一个错误?请先尝试自己解决,并提交一个pull request。如果您无法修复它,至少提供一个清晰的错误描述。我们会在有时间的时候查看。
  • 想看到一个新功能被添加,提交一个pull request看看会发生什么。您还可以提交一个缺失功能的bug,我们可以讨论如何实现它。

质量

要检查一切是否正常,请运行

composer check

要修复代码风格,请运行

composer check

如何发布

  1. 创建一个带注解的标签
    1. git tag -a 1.2.3
    2. 标签主题必须是版本号,例如: 1.2.3
    3. 标签正文必须是变更日志条目的复制粘贴
  2. 使用 git push --tags 推送标签,然后GitHub Actions将自动创建GitHub发布