Download the PHP package malkusch/bav without Composer
On this page you can find all versions of the php package malkusch/bav. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package bav
Short Description BAV provides validation for German Bank Accounts (Konto)
License WTFPL
Homepage http://bav.malkusch.de/
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package bav
About BAV
BAV (bank account validator) is a validation library for German bank accounts.
Installation
Use Composer:
Configuration
You can use BAV out of the box. BAV comes with a ready to play default
configuration (DefaultConfiguration):
-
UTF-8encoding (if supported) -
FileDataBackendContainer. I.e. it uses binary search on the file from the Bundesbank. Note that this data backend uses the directorybav/datafor install and update operations. You have to make sure that this directory is writable. -
automatic installation. You don't have to call any installation script. The container will download the Bundesbank file upon the first execution.
- update plan which triggers an E_USER_NOTICE if the Bundesbank file is outdated.
You can define your own configuration by calling
ConfigurationRegistry::setConfiguration()
or preferably creating the file bav/configuration.php which returns a
Configuration object:
Update
The Bundesbank releases new files for March, June, September and December. BAV needs those new files. You have several possiblities to update bav:
Script
Call bin/bav-update.php.
Programmatically
Automatic
Enable automatic updates with
AutomaticUpdatePlan
in your bav/configuration.php:
This automatic update plan will perform long running update operations as a shutdown hook. I.e. it won't bother users during normal operations.
Usage
You can use BAV with the api facade
BAV:
-
BAV::isValidBank($bankID): Returns true for existing bank ids. -
BAV::isValidBankAccount($bankID, $account): Returns true for existing accounts of an existing bank. -
BAV::isValidAccount($account): This method validates an account against the bank of the lastisValidBank()call. -
BAV::getValidBankFilterCallback(): Returns a callback for filter bank validation. -
BAV::getValidAccountFilterCallback(): Returns a callback for filter account validation. The account filter needs to be called after the bank filter. -
BAV::getMainAgency(): Returns the main agency of a bank. BAV::getAgencies(): Returns further agencies. The main agency is not included in this list. This list can be empty.
An Agency
object has the fields:
Example
See also bav/docs/example.php.
Optional Dependencies
You may have:
-
CURL: If you provide
bav/data/banklist.txtyou don't need CURL. -
mbstring: BAV works with unicode encoding. Your PHP must have support compiled in the
mb_*functions. If these functions are missing BAV works only with the ISO-8859-15 encoding. -
PDO: If you intend to use a DBS you need to use
PDODataBackendContainer.PDODataBackendContainerneeds aPDOsupport compiled in PHP. - doctrine/orm: You can use
DoctrineBackendContainerwhich uses doctrine as data backend.
License and authors
This project is free and under the WTFPL. So do what ever you want. But it would be nice to leave a note about the authors.
The author of the original project which gave the idea to this project is Björn Wilmsmann. Responsable for this project is Markus Malkusch [email protected].
Donations
If you like BAV and feel generous donate a few Bitcoins here: 1335STSwu9hST4vcMRppEPgENMHD2r1REK
