Kapitel 2. Installation

Die Installation von libsepa ist denkbar einfach: laden Sie von der Download-Seite das für Ihre Plattform passende Archiv herunter und entpacken Sie es in irgendein temporäres Verzeichnis. Verschieben Sie anschließend die benötigte Bibliotheksdatei in das richtige Verzeichnis (wird in den folgenden Abschnitten genauer beschrieben). Das war's.

2.1. Perl

Entpacken Sie die Datei Linux/64bit/perl5/SEPA-x.x.tar.gz bzw. Linux/32bit/perl5/SEPA-x.x.tar.gz in einem beliebigen Verzeichnis (z.B. unter /usr/src/). Compilieren, testen und installieren Sie das Modul anschließend wie jedes andere Perl-Modul:

perl Makefile.PL
make test
make install

2.2. PHP

Zuerst müssen Sie wissen, welche PHP-Version Sie verwenden: 5.2, 5.3, 5.4 oder 5.5. Kopieren Sie dann die passende Datei aus Linux/64bit/php-<Version>/sepa.so in das Verzeichnis für PHP-Extensions (meist so etwas wie /usr/lib/php5/<API-Versions-Nummer>/ oder in ein beliebiges anderes Verzeichnis.

Fügen Sie anschließend in Ihrer php.ini-Datei folgende Anweisung hinzu:

extension=sepa.so

Falls sich die Datei sepa.so nicht im Standard-Verzeichnis für Extensions befindet, müssen Sie beim extension-Befehl den vollständigen Pfad zu dieser Datei angeben.

2.3. Java

Kopieren Sie die Datei Linux/64bit/java/SEPA.jar in ein beliebiges Verzeichnis Ihres Java-Projekts und passen Sie ggf. den Classpath entsprechend an. Zusätzlich kopieren Sie die Datei Linux/64bit/libsepa-jni.so in ein Bibliotheksverzeichnis (z.B. /usr/local/lib/ oder geben Sie den Pfad mit der Option -Djava.library.path=... an.

Ein Aufruf des mitgelieferten Testprogramms (nach der Compilierung) könnte also etwa so aussehen:

java -Djava.library.path=/opt/libsepa -classpath /opt/libsepa/SEPA.jar:. SEPADemo

2.4. Updates

Wenn ein Update für libsepa verfügbar ist, laden Sie einfach wieder die o.g. Archiv-Datei von der Website herunter und ersetzen die bereits installierten Dateien an Ort und Stelle. Die Shared Library von libsepa (.so oder .dll) enthält alle Bankinformationen, so dass Sie keine andere Datei aktualisieren oder ersetzen müssen.