Floorball Webservice Class

Floorball Webservice Class ist eine einzige PHP Klasse für die Anbindung der Webservices des schweizerischen Unihockey Verbandes. Die Klasse implementiert sämtliche Notwendigen SOAP anbindung und liefert ein einfaches Interface für die Abfrage sämtlicher zu Verfügung gestellten Daten, ohne dass vertiefte SOAP Kenntnisse notwendig sind. Dies umfasst insbesondere auch die gesamte UTF-8 (de-/kodierung).

Zudem kann die Klasse so konfiguriert werden, dass die Daten für einen bestimmten Zeitintervall gecached werden, um die Laufzeiten zu verbessern.

Features

• Einfache Anbindung der SUHV Webservices
• Caching für bessere Performance
• Keine Zeichenumwandlungen notwendig
• Ausführlich dokumentiert und einfach anzuwenden

Installation

Um den Webservice zu nutzen muss die SOAP Library des PEAR Pakets installiert sein. Möglicherweise ist das Paket bei Ihrem Webhoster bereits installiert. Andernfalls müssen Sie das PEAR Paket manuell installieren und gegebenfalls den den Include Path manuell erweitern. Verwenden Sie hierzu die Zeile

ini_set("include_path", "/Absoluter_pfad_zu_pear/:".ini_get("include_path"));

und geben Sie den absoluten Pfad zum PEAR Paket an. Achten Sie darauf, dass Sie den Doppelpunkt und die nachfolgende Anweisung nicht verändern!

Wenn Sie den Webservice direkt in ihre Website integrieren kann dies Ihre Seite u.U. massiv verlangsamen (z.B. wenn Sie mehrere Informationen auf der Startseite anzeigen möchten). Diese Klasse unterstützt deshalb das Cachen von den einzelnen Request sodass diese nicht jedes mal abgeschickt werden sondern lokal die Informationen gepuffert werden. Um das Caching zu aktivieren setzten Sie die Variable $caching auf true, legen Sie die Lebenszeit des Caches in Sekunden fest und definieren Sie das entsprechende Caching Verzeichnis absolute oder relativ zur Klasse. Sorgen Sie dafür, dass das Verzeichnis auch angelegt ist und die Rechte korrekt eingestellt sind.

Weitere Konfigurationseinstellungen sind nicht nötig. Informationen wie die Benutzeridentifikation werden direkt beim Instantieren der Klasse übergeben.

Verwendung

Beachten Sie hierzu insbesondere die Dokumentation innnerhalb des Codes. Beachten Sie ausserdem das die zurückgegebenen Strukturen des SUHV hier nicht weitergehend dokumentiert werden. Es empfiehlt sich in einer Testumgebung die Antworten des Webservice mit der PHP Funktion print_r($res); als Plaintext auszugeben.

Untenstehende werden die wichtigsten Schritt erläutert:

Instantieren Sie die Klasse SUHVService und übergeben Sie die Benutzeridentifikation, den Authentifizierungscode, die Sprache (gem. SUHV) und Ihren vollständigen Vereinsnamen.

$obj = new SUHVService('1234', 'abcdefghijklmnopqrstuvwxyz', 1, 'UHC Webmasters');

Sämtliche Informationen werde UTF8 kodiert. Sie können das automatische Dekodieren direkt in der Klasse veranlassen und sich die Dekodierung in Ihrem Code ersparen.

$obj->setUTF8Enabled(true);

Das Caching können Sie für den Request den Sie los schicken an dieser Stelle nochmals explizit ein- oder ausschalten.

$obj->setCachingEnabled(false);

Es folgt das Abholen von Daten.

$res = $obj->getResultsTeam('314', '10');
//Ausgabe zum testen
print_r($res);

History