Dies ist eine Referenzimplementierung der OParl-API. Eine Livedemo mit Beispieldaten ist unter demoserver.oparl.org verfügbar.
Dieses Programm wird mit Hilfe des Laravel 5.1 Frameworks in PHP 5.4 entwickelt. Allgemeine Hinweise zum Aufsetzen einer lokalen Entwicklungsumgebung für Laravelanwendungen findet sich in der Dokumentation.
Die Umgebungsvariablen in .env.example
sind die für Homestead funktionierenden Defaultwerte, daher
reicht es, diese einfach in eine .env
zu kopieren.
Momentan gibt es noch die Möglichkeit, SQLite als Datenbankbackend zu benutzen. Dazu muss
in .env
einfach DB_DEFAULT=sqlite
gesetzt werden. Zusätzlich sollte die Existenz einer
Datenbank mit touch storage/database.sqlite
sichergestellt werden.
Die Benutzung von SQLite bringt u.U. signifikante Performanceeinbußen mit sich!
Es wird empfohlen anstatt SQLite MySQL als Backend zu nutzen. Dazu muss natürlich die in
.env
angegebene Datenbankverbindung funktionieren.
Die Unterstützung für Postgres ist in Arbeit.
Nach der Einrichtung der Datenbankverbindung ist es noch notwendig das Datenbankschema zu initialisieren.
Dazu ist einfach php artisan migrate
auszuführen (Im Falle von MySQL oder Postgres innerhalb der Homestead VM!)
Wenn die Beispieldaten generiert werden sollen, kann dies mit php artisan db:seed
getan werden.
Es wird in Zukunft möglich sein, diese Referenzimplementierung als Grundlage für eine Einbindung von OParl in bestehende RIS-Systeme zu verwenden. Nähere Informationen dazu werden mit dem Release von OParl 1.0 veröffentlicht.