genkgo/camt

Library to read CAMT files (XML containing bank statements).

2.8.0 2024-08-06 08:26 UTC

Requires

• php: ^8.1
• ext-dom: *
• ext-libxml: *
• ext-simplexml: *
• jschaedl/iban-validation: ^2.0
• moneyphp/money: ^4.0

Requires (Dev)

• friendsofphp/php-cs-fixer: @stable
• phpstan/phpstan: @stable
• phpunit/phpunit: @stable

MIT

README

Library to read CAMT files. Currently only CAMT.052, CAMT.053 and CAMT.054 are supported.

Supported Versions

Camt 052

Camt 053

Camt 054

Installation

It is installable and autoloadable via Composer:

composer require genkgo/camt

Getting Started

Read a CAMT file, and loop through its statements and entries.

<?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 validation

This library provides a XSD validation for each supported CAMT format. The validation is executed by default. But in some cases, you might want to disable it.

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

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

$reader = new Reader($config);

Contributing

• Found a bug? Please try to solve it yourself first and issue a pull request. If you are not able to fix it, at least give a clear description what goes wrong. We will have a look when there is time.
• Want to see a feature added, issue a pull request and see what happens. You could also file a bug of the missing feature and we can discuss how to implement it.

Quality

To check that everything is as it should be, run:

composer check

To fix code style, run:

composer check

How to release

1. Create an annotated tag
   1. git tag -a 1.2.3
   2. Tag subject must be the version number, eg: 1.2.3
   3. Tag body must be a copy-paste of the changelog entries
2. Push tag with git push --tags, then GitHub Actions will create a GitHub release automatically