2. PHP RPC

Die GREYHOUND PHP RPC API (im Folgenden kurz "PHP RPC") ist eine Klassenbibliothek, über die die RPC-Schnittstelle des GREYHOUND Servers angesprochen werden kann, um Daten abzurufen, zu verändern oder anzulegen.

Eingebunden wird die Klassenbibliothek, indem die Datei ghrpc.php inkludiert wird:

Für PHP Skripte, die im GREYHOUND Client ausgeführt werden, ist der Include-Pfad bereits entsprechend gesetzt, sodass die Bibliothek so eingebunden werden kann. Für PHP Skripte, die auf einem separaten Webserver ausgeführt werden, muss die GREYHOUND PHP API entsprechend in den Include-Pfad aufgenommen oder der Pfad in der require_once Anweisung entsprechend angepasst werden.

Die in der Datei ghrpc.php definierte Basisklasse GhRpc enthält einen Autoloader für die Klassen der PHP RPC Bibliothek, d.h. die Klassen der Bibliothek können verwendet werden, ohne explizit weitere PHP-Dateien einzubinden.

Die Kommunikation mit dem GREYHOUND Server wird über ein Client-Objekt abgewickelt. Dies wird im Abschnitt Serververbindung beschrieben. Der Abschnitt RPC Aufrufe beschreibt anschließend die eigentlichen RPC Dienste, Funktionen und Datenobjekte. Es folgt im Abschnitt Fehlerbehandlung eine Beschreibung der Ausnahmefehler, die bei der Verwendung der RPC Schnittstelle auftreten können.