PHP Classes
elePHPant
Icontem

hrwsBLZ: German bank identification code server

Recommend this page to a friend!
  Info   View files Example   View files View files (4)   DownloadInstall with Composer Download .zip   Reputation   Support forum (3)   Blog    
Last Updated Ratings Unique User Downloads Download Rankings
2016-10-31 (1 month ago) RSS 2.0 feedNot enough user ratingsTotal: 579 All time: 5,087 This week: 772Up
Version License PHP version Categories
hrwsblz 1.0.19Freeware5PHP 5, Databases, E-Commerce, Finances
Description Author
This package is specific mainly for applications used in Germany Germany .

This class can create and initialize a database table to insert or query German bank identification codes.

It can also verify account numbers matching a given bank identification code or a german IBAN.

The Deutsche Bundesbank provides formatted data files with all valid german bank identification codes.

The class can import these files and use it for payment data validation.

  Performance   Level  
Name: Heiko Rettinger <contact>
Classes: 2 packages by
Country: Germany Germany
Age: 40
All time rank: 2289145 in Germany Germany
Week rank: 1198 Up62 in Germany Germany Up

Details
Class: hrwsBLZ
created on: August 6th, 2003
last updated: October 31st, 2016
Author: Heiko Rettinger (c) by hr-ws.de 2003-2016
E-Mail: heiko@hr-ws.de
Filename: hrwsBLZ.readme.txt
Version: v1.0.19

english description:
This class can create and handle a database table to insert and query german
bank identification codes. Now you can also verify account numbers matching a
given bank identification code. The "Deutsche Bundesbank" provides formatted
datafiles with all valid german bank identification codes. With this class,
you can import these files and use it for payment data validation.

The usage of this class is only reasonable in germany. That's why this
documentation is written in german. If you need an english documentation,
please contact me.

Deutsche Beschreibung:
Mit dieser Klasse l?sst sich eine Tabelle mit deutschen Bankleitzahlen erzeugen
und auch verwalten. Es ist nun auch m?glich die G?ltigkeit von Kontonummern zu
einer gegebenen BLZ zu pr?fen. Die Deutsche Bundesbank bietet auf ihrer
Homepage vorformatierte Dateien an, die mit dieser Klasse in die Datenbank
importiert werden k?nnen.
Es ist m?glich, dass diese Datendatei zum Importieren in mehrere Teile
gesplittet werden muss, da die Datendateien mehr als 3MB umfassen.
Im Juni 2006 hatte die Deutsche Bundesbank den Aufbau der Datendateien ge?ndert.
Die aktuellen Versionen respektieren dieses Format. Im Falle eines Upgrades von
einer ?lteren Version muss die alte Datenbanktabelle entfernt und mit einer
neuen ersetzt werden. Dies l?sst sich mit der internen Klassenmethode
blz_droptable() durchf?hren. Die aktuelle Tabelle kann anschlie?end mit
blz_createtable() erzeugt werden.
In dieser Version sind alle bis Oktober 2016 ver?ffentlichen Pr?fziffer-
Verfahren implementiert.

Die Initialisierung:
Die Klasse erfordert bei der Initialisierung ein Konfigurationsarray
mit folgenden Feldern:
(o)	sqlhost :	den MySQL Server Hostnamen (Voreinstellung: "localhost")
(o)	sqluser :	den MySQL Usernamen (Voreinstellung: "")
(o)	sqlpass :	das MySQL Passwort (Voreinstellung: "")
(b)	sqldb :		den MySQL Datenbanknamen (Voreinstellung: "")
(b)	sqltable :	den MySQL Tabellennamen f?r die Klasse (Voreinstellung: "hrv_blz")
(o)	extconnid :	eine MySQL Verbindungskennung, falls diese anstelle einer eigenen
				Verbindung genutzt werden soll. sqldb & sqltable sind dann trotzdem
				erforderlich (Voreinstellung: NULL),
(o)	clearb4import : Importverhalten (true) l?scht bei einem Datenimport zuerst den
					kompletten Tabelleninhalt, (false) beh?lt alle Daten bei
					(Voreinstellung: true)
(o) = optional; (b) = wird ben?tigt

Die Variablen:
	->_cfg (array)
Enth?lt die Klassendeklaration (Felder siehe Konfigurationsarray)
	->_db (int)
Enth?lt die aktuelle MySQL Verbindungskennung
  ->_corrblz (array)
Array mit Korrekturen f?r Pr?fzifferberechnungsmethoden einzelner Bankleitzahlen
	->lasterror (string)
Enth?lt den letzten Fehler wenn eine Funktion false zur?cklieferte
	->data (array)
Enth?lt alle Bankinformationen, die bei einer Abfrage mit blz_queryblz() oder
blz_isKtoValid() aus der Datenbank geliefert wurden
Aufbau: array(
			lfd Nr. => array([Datenbanksatz]) [,
			lfd Nr. => array([Datenbanksatz]) [, ... ]]
			)
Datenbanksatz:
	hrz_id			(int) lfd Nr. (von der Bundesbank vergeben)
	hrz_blz			(int) Bankleitzahl
	hrz_namelong	(string) Bezeichnung der Kreditinstitutsniederlassung (evtl. verk?rzt)
	hrz_nameshort	(string) Kurzbezeichnung der Kreditinstitutsniederlassung (max. 20 Zeichen)
	hrz_zipcode		(string) Postleitzahl
	hrz_town		(string) Ort
	hrz_own			(int) 1 = eigene Bankleitzahl, 2 = mitgenutzte Bankleitzahl
	hrz_bbk			(int) 1 = eigenes BBk-Girokonto, 2 = ohne
	hrz_deldate		(datum) Datum YYYY-MM-TT HH:MM:SS der L?schung, oder 0000-00-00 00:00:00 wenn aktiv
	hrz_followid	(int) neue lfd Nr. mit der diese Bankleitzahl ersetzt wurde oder 99999 wenn ung?ltig
	hrz_bic			(string) BIC ohne DE
	hrz_btxname		(string) Kurzbezeichnung der Kreditinstitutsniederlassung f?r Btx und EZ? (max 27 Zeichen)
	hrz_pzc			(string) Verfahren zur Pr?fsummenberechnung der Kontonummern (2 Zeichen)

Die Funktionen:
	blz_queryblz($aBLZ)
Fragt die Datenbank nach einer Bankleitzahl ab.
Parameter: $aBLZ (int) eine Bankleitzahl
RETURN-Wert: (int) Anzahl der gefundenen Datens?tze, oder (bool) false
	blz_isIBANvalid($aIBAN)
Pr?ft die G?ltigkeit einer IBAN anhand der zweistelligen Pr?fziffer
Parameter: $aIBAN (string) Die IBAN Zeichenkette beginnend mit dem L?ndercode
RETURN-Wert: (bool) G?ltig oder Ung?ltig.
	blz_checkKtoFromIBAN($aIBAN)
Pr?ft die G?ltigkeit einer deutschen IBAN anhand der erhaltenen Kto & BLZ
Parameter: $aIBAN (string) Die IBAN Zeichenkette beginnend mit dem L?ndercode DE
RETURN-Wert: (bool) G?ltig oder Ung?ltig.
	blz_isKtoValid($aKto, [$aBLZ])
Pr?ft die G?ltigkeit der Kontonummer. Wenn $aBLZ nicht ?bergeben wird
setzt dies einen vorangegangenen Aufruf von blz_queryblz() voraus.
Parameter: $aKto (int) die Kontonummer; $aBLZ (int) optionale BLZ
RETURN-Wert: (bool) G?ltig oder Ung?ltig.
	blz_getnumentries()
Bestimmt die Anzahl der BLZ-Eintr?ge
Parameter: keine
RETURN-Wert: (int) Anzahl der Eintr?ge, oder (bool) false
	blz_importfile($aFilename)
Importiert die angegebene Datei in die Datenbank
Parameter: $aFilename (string) Datei mit Pfad auf dem Server
RETURN-Wert: (bool) true oder false
	blz_importtext($aText)
Importiert den angegebenen Text in die Datenbank
Parameter: $aText (string) Eine Zeichenkette mit dem Format der deutschen Bundesbank
RETURN-Wert: (bool) true oder false

Interne Funktionen:
	blz_createtable()
Kann benutzt werden um die Datentabelle anzulegen
RETURN-Wert: (bool) true oder false
	blz_droptable()
Kann benutzt werden um die Datentabelle vom Server zu l?schen
RETURN-Wert: (bool) true oder false
	blz_cleartable()
Kann benutzt werden um die Datentabelle zu leeren
RETURN-Wert: (bool) true oder false

  Files folder image Files  
File Role Description
Plain text file hrwsBLZ.class5.php Class PHP5 class file
Accessible without login Plain text file hrwsBLZ.demo5.php Example PHP5 demo
Accessible without login Plain text file hrwsBLZ.demodata.txt Data some bank identification code datas for demonstration
Accessible without login Plain text file hrwsBLZ.readme.txt Doc. english and german documentation

 Version Control Unique User Downloads Download Rankings  
 0%
Total:579
This week:0
All time:5,087
This week:772Up