Test Script für suhv_lib.php

Verein

Hier werden die Möglichkeiten auf Stufe Verein gezeigt. Der Verein wird im SUHVphp Framework über die Klasse SuhvClub abgebildet. Ein Club kann wie folgt erstellt werden:

$club = new SuhvClub(444, 2012);

Der erste Parameter ist die club_id und der zweite die aktuelle Saison. Beide Parameter können leer gelassen werden. In diesem Falle wird automatisch der in der Konstante CFG_SUHV_CLUB beschriebene Club für die aktuelle Saison eröffnet.

Vereins Informationen

Die Vereinsadresse kann über $club->getAddress() ausgelesen werden.

Eisweiherstrasse 82
8400 Winterthur
052 222 36 70

Es besteht auch die Möglichkeit die URL abzufragen: $club->getUrl():

www.win-u.ch

Alle Teams deines Vereins

Dieser Abschnitt zeigt ein Beispiel für den Clubs Services.

Diese Tabelle ist nicht für die Ausgabe auf einer Homepage gedacht. Sie demonstriert lediglich, wie man alle Teams eines Clubs von der Schnittstelle beziehen kann.

Letzte Spiele deines Vereins

Dieser Abschnitt behandelt die Search Funktion des Games Services.

Das tolle am SUHVphp Framework ist, dass sehr einfach Resultate ausgegeben werden können. Mit der folgenden Zeile Code erscheint die darauf folgende Ausgabe:

SuhvClubHtmlBuilder::outputPlayedGames($club);

Im oben gezeigten Beispiel sorgt die suhv_html_lib.php für die Zusammenstellung der gesuchten Spieldaten und stellt das Resultat direkt in HTML zur Verfügung.

Nächste Spiele deines Vereins

Dieser Abschnitt behandelt die Search Funktion des Games Services.

Die (reguläre) Saison ist für unsere Teams beendet.

Auch diese Ausgabe ist mit einer Zeile Code zu erreichen, sobald man den $club definiert hat:

SuhvClubHtmlBuilder::outputPlannedGames($club);

Team

Wichtiger Tipp!

Um alle Möglichkeiten der SuhvTeam Klasse zu nutzen und die REST Services des SUHVs möglichst zu entlasten, macht es Sinn, dass die Team Objekte in einer Datenbank gespeichert werden. Diese Datenbank sollte folgende beiden Werte speichern:

Team Objekt erstellen

Die benötigten Werte, um ein Team Objekt zu erstellen, sollten aus der der Datenbank gelesen werden! Beispiel folgt:

// auslesen der Team Werte aus der Datenbank
$sql = "select team_id, object from team where team_id = 409379";
$result = mysql_query($sql);
$team = mysql_fetch_assoc($result);

// prüfen, ob ein serialisierter Wert des Objektes vorhanden ist
if ($team['object']) {
	$team = SuhvTeam::unserialize($team['object']));
} else {
	$team = new SuhvTeam($team['team_id'];
}
		

Team Objekt in der DB speichern

Am Ende jedes Scriptes sollte geprüft werden, ob das Team Objekt geändert wurde. Diese Information liefert die Methode $team->isUpdated(). Falls ja, muss das Objekt in der Datenbank gespeichert werden.

// prüfen, ob das Team Objekt geändert wurde
if ($team->isUpdated()) {
	// team objekt in der datenbank speichern!
	$sql = "UPDATE team SET object = '" . $team->serialize() . "' WHERE team_id = " . $team->getId();
	mysql_query($sql);
}

Alle Spiele eines Teams

Dieser Abschnitt behandelt die Teams Services.

Bitte schaut im Quelltext von index.php nach, wie wir die Team Daten auslesen.

Cupspiele

Gespielte Meisterschaftspiele

Playouts

Auf-/Abstiegs-Playoffs

Zukünftige Meisterschaftsspiele

Tabelle

Alle Spiele der Gruppe

Dieser Abschnitt bezieht Daten vom Leagues Service. Um die Daten der Liga zu erhalten, muss ein SuhvLeague Objekt erstellt werden. Das SuhvLeague Objekt kann aus dem SuhvTeam Objekt geholt werden ($team->getSuhvLeague()) oder es kann neu instanziert werden ($league = new SuhvLeague($team->getLeague(), $team->getGroup())).

Runde 1

Runde 2

Runde 3

Runde 4

Runde 5

Runde 6

Runde 7

Runde 8

Runde 9

Runde 10

Runde 11

Runde 12

Runde 13

Runde 14

Runde 15

Runde 16

Runde 17

Runde 19

Runde 18

Runde 20

Runde 21

Runde 22

Debug

Für die Performance deines Scriptes ist es wichtig, die REST Anfragen so weit als möglich zu minimieren. Mit der Anweisung SuhvApiManager::getInstance()->getLog(), kannst du kontrollieren, wieviele Anfragen getätigt wurden:

Array
(
    [0] => 2024-04-25 08:45:24 - cache - clubs/search?q=Winterthur%20United
    [1] => 2024-04-25 08:45:24 - cache - clubs/444/teams?season=2023
    [2] => 2024-04-25 08:45:24 - cache - clubs/444
    [3] => 2024-04-25 08:45:24 - cache - teams/409379/registrations?season=2023
    [4] => 2024-04-25 08:45:24 - internal - clubs/444
    [5] => 2024-04-25 08:45:24 - internal - clubs/444
    [6] => 2024-04-25 08:45:24 - cache - teams/431053/registrations?season=2023
    [7] => 2024-04-25 08:45:24 - cache - teams/2896/registrations?season=2023
    [8] => 2024-04-25 08:45:24 - cache - teams/431268/registrations?season=2023
    [9] => 2024-04-25 08:45:24 - cache - teams/431792/registrations?season=2023
    [10] => 2024-04-25 08:45:24 - cache - teams/428334/registrations?season=2023
    [11] => 2024-04-25 08:45:24 - cache - teams/428453/registrations?season=2023
    [12] => 2024-04-25 08:45:24 - cache - teams/429468/registrations?season=2023
    [13] => 2024-04-25 08:45:24 - cache - teams/1256/registrations?season=2023
    [14] => 2024-04-25 08:45:24 - cache - teams/411661/registrations?season=2023
    [15] => 2024-04-25 08:45:24 - cache - teams/418981/registrations?season=2023
    [16] => 2024-04-25 08:45:24 - cache - teams/417971/registrations?season=2023
    [17] => 2024-04-25 08:45:24 - cache - teams/429865/registrations?season=2023
    [18] => 2024-04-25 08:45:24 - cache - teams/429365/registrations?season=2023
    [19] => 2024-04-25 08:45:24 - cache - teams/430631/registrations?season=2023
    [20] => 2024-04-25 08:45:24 - cache - teams/432184/registrations?season=2023
    [21] => 2024-04-25 08:45:24 - cache - games/search?q=UHC%20Winterthur%20United&status=played&order=desc&season=2023&limit=15
    [22] => 2024-04-25 08:45:25 - 404 - games/search?q=UHC%20Winterthur%20United&status=planned&order=asc&season=2023&limit=15
    [23] => 2024-04-25 08:45:25 - cache - teams/409379/games?order=asc&season=2023&limit=100
    [24] => 2024-04-25 08:45:25 - internal - teams/409379/registrations?season=2023
    [25] => 2024-04-25 08:45:25 - cache - teams/409379/table?season=2023
    [26] => 2024-04-25 08:45:25 - cache - leagues/113/groups?season=2023
    [27] => 2024-04-25 08:45:25 - cache - leagues/113/groups/2/games?season=2023&order=asc&limit=200
    [28] => 2024-04-25 08:45:25 - cache - leagues/113/groups/2/table?season=2023
)

Erklärungen: In jeder Kolonne wird die Zeit der Anfrage, der HTTP Status Code resp. die Quelle sowie der Angefragte Service mit seinen Parametern aufgeführt. Mögliche Werte für die Quelle:

• HTTP Code: 200 bei einer erfolgreichen REST Abfrage
• HTTP Code: 404 bei einer REST Abfrage, die keine Resultate findet
• internal: steht für ein Resultat, welches auf dem SuhvApiManager zwischen gespeichert war
• cache: für ein Resultat, welches aus einem Cache File ermittelt wurde