jschaedl / bav
bankaccount validation
Installs: 315 901
Dependents: 0
Suggesters: 0
Security: 0
Stars: 14
Watchers: 6
Forks: 27
Open Issues: 1
Requires (Dev)
- phploc/phploc: *
- phpunit/php-code-coverage: >=1.2.10,<1.3.0
- phpunit/phpunit: 3.7.*
- sebastian/phpcpd: *
This package is auto-updated.
Last update: 2024-09-29 04:36:37 UTC
README
A small library for validating german bank account numbers. It provides classes which can be easily integrated into existing projects and is build for PHP 5.3+.
Installation
To install jschaedl/bav install Composer first, if you haven't already
curl -sS https://getcomposer.org/installer | php
Then just add the following to your composer.json file:
// composer.json { "require": { "jschaedl/bav": "*" } }
Then, you can install the new dependencies by running Composer’s update command from the directory where your composer.json
file is located:
# install $ php composer.phar install # update $ php composer.phar update jschaedl/bav # or you can simply execute composer command if you set it to # your PATH environment variable $ composer install $ composer update jschaedl/bav
You can see this library on Packagist.
Composer installs autoloader at ./vendor/autoload.php
. If you use jschaedl/bav in your php script, add:
require_once 'vendor/autoload.php';
Or you can use git clone command:
# HTTP $ git clone https://github.com/jschaedl/Bav.git # SSH $ git clone git@github.com:jschaedl/Bav.git
Usage example
use Bav\Backend\Parser\BankDataParser; use Bav\Backend\BankDataResolver; use Bav\Encoder\EncoderFactory; $bankDataFile = 'blz_2013_12_09_txt.txt'; $encoder = EncoderFactory::create(Bav::DEFAULT_ENCODING); $parser = new BankDataParser($bankDataFile); $parser->setEncoder($encoder); $bav = new Bav(); $bav->setBankDataResolver(new BankDataResolver($parser)); $bank = $bav->getBank('20090500'); $agency = $bank->getMainAgency(); $this->assertEquals('netbank', $agency->getName()); $this->assertEquals('000000', $agency->getIbanRule()); $bank = $bav->getBank('58561250'); $this->assertEquals('58564788', $bank->getBankId()); $bank = $bav->getBank('20090500'); $this->assertTrue($bank->isValid('1359100'));
How to contribute
If you want to fix some bugs or want to enhance some functionality, please fork the master branch and create your own development branch. Then fix the bug you found or add your enhancements and make a pull request. Please commit your changes in tiny steps and add a detailed description on every commit.
Unit Testing
All pull requests must be accompanied by passing unit tests. This repository uses phpunit and Composer. You must run composer install
to install this package's dependencies before the unit tests will run. You can run the test via:
phpunit -c tests/phpunit.xml tests/
License and authors
This project is free and under GPL (see gpl.txt). So do what ever you want. But it would be nice to leave a note about the authors.
The authors of the original project who gave the idea to this project are Björn Wilmsmann and Markus Malkusch.
Responsible for this project is Jan Schädlich.
Requirements
You may have:
- PHP 5.3.0 or greater
- mbstring or iconv
BAV works with unicode encoding. Your PHP must have support compiled in to either the mb_* or the iconv_* functions. If these functions are missing BAV works only with the ISO-8859-15 encoding.