Anleitung

So installieren Sie VAMPIRE PHP mit Composer

VAMPIRE PHP ist freie Software unter der GPL-2.0-or-later und liegt öffentlich auf Packagist und auf GitHub. Sie installieren es mit einem einzigen Befehl und brauchen dafür weder Zugangsdaten noch eine eigene Paketquelle.


Ein Befehl genügt

composer require invoicepress/vampire-php

Composer holt das Paket von Packagist und trägt es in Ihre composer.json ein. Weitere Einstellungen, Benutzernamen oder Passwörter brauchen Sie nicht.

1 · Installieren
composer require invoicepress/vampire-php
2 · Selbsttest
vendor/bin/einvoice-validator selftest
3 · Erste Rechnung prüfen
wie in der Dokumentation für PHP
In drei Schritten zur ersten Prüfung: installieren, Selbsttest, erste Rechnung prüfen.

Was Ihr Server braucht

VAMPIRE PHP braucht PHP 8.2 oder neuer und dazu die Erweiterungen dom, libxml und bcmath. Weitere Abhängigkeiten zur Laufzeit gibt es nicht, und Java brauchen Sie auch nicht. Mit php -m sehen Sie, ob die Erweiterungen vorhanden sind.


So läuft die Installation in einer Pipeline

In einer Pipeline genügt derselbe Befehl. Steht das Paket schon in Ihrer composer.lock, genügt composer install. Weil Packagist öffentlich ist, braucht die Pipeline keine Zugangsdaten und keine Secrets.


Was im Paket liegt

Das Paket enthält das Prüfprogramm mit seiner Kommandozeile und alle Regelwerke samt Schemata und Codelisten. Ein Regelwerk enthält die Prüfregeln eines Formats in einer Fassung, zum Beispiel die Regeln der XRechnung 3.0.2, und eine Codeliste ist eine festgelegte Liste erlaubter Werte, zum Beispiel die Währungscodes. Auch die Peppol-Regeln sind enthalten. Dazu kommen die Lizenz des Prüfprogramms, die Datei NOTICE mit Herkunft und Lizenz jedes Regelwerks und die Lizenztexte der Regelwerke. Welche Regelwerke das im Einzelnen sind, zeigt die Seite Regelpakete.


So bekommen Sie neue Regelstände

Neue Regelstände erscheinen als neue Version des Pakets, und der Befehl composer update invoicepress/vampire-php holt sie. Ein Abo für Regelpakete gibt es nicht, denn die Regelpakete sind frei.


So prüfen Sie, ob die Installation geklappt hat

vendor/bin/einvoice-validator selftest

Der Selbsttest zeigt, wie viele Regelwerke und Zuordnungsregeln geladen sind, und prüft dann ein Probedokument. Läuft er durch, ist VAMPIRE PHP einsatzbereit. Wie Sie danach Ihre erste Rechnung prüfen, steht in der Dokumentation für PHP.


VAMPIRE PHP frei, VAMPIRE JS im Shop.

VAMPIRE PHP und alle Regelpakete sind frei und liegen auf GitHub und Packagist. VAMPIRE JS erwerben Sie im Shop von invoicePress.de.