Tutorials - Entwicklung - Webservices mit PHP und NuSOAP - Fehlerbehandlung und Parameterübergabe -

Server-Funktionen mit Übergabe-Parameter
jetzt wollen wir uns mal Funktionen für den Soap-Server ansehen, bei dem Parameter beim Aufruf des Webservices verwendet werden.

//hier wird als Parameter ein String erwartet:
function sGetLoginName($sName){
return "Hallo, ". $sName;
}

//und hier mal ein Array als Übergabeparameter:
function Login($aUserData){
if($aUserData['Passwort'] == '123')
{
return "Hallo, ".$aUserData['Vorname']." ".$aUserData['Name'];
}
else
{
return "falsches Passwort!!";
}
}

noch nichts aufregendes bisher (eigentlich ganz normale Funktionen),
aber was ist mit der Fehlerbehandlung - was passiert wenn kein oder ein falscher Parameter übergeben wird?

Serverseitige Fehlerbehandlung
um einen SOAP-Fehler auszugeben gibt es das Objekt vom Typ soap_fault, hierzu müssen 3 Parameter übergeben werden.
- der Fehlertyp als String (Client, Server, MustUnderstand oder VersionMismatch)
- der Fehlerverursacher als String (kann man auch leer lassen)
- die Fehlermeldung als String

dann könnte eine Funktion folgendermaßen aussehen:

function sGetLoginName($sName){
if(trim($sName == '') || $sName == null)
{
return new soap_fault(
"Client",
"",
"der Name fehlt!!"
);
}
else
{
return "Hallo, ". $sName;
}
}

Client-Aufruf des Webservices mit Parameterübergabe
wenn jetzt eine Funktion aufgerufen wird, die einen Übergabeparameter erwartet, geschieht dieses mit der Methode call().
Die Methode call() erwartet dann als ersten Parameter den Namen der Webservice-Funktion und als zweiten Parameter die Übergabeparameter an die gewählte Funktion.
Wichtig ist hierbei das die Übergabe-Parameter für die Funktion als Array übergeben werden müssen.

$sLoginName = $oSoapClient->call('sGetLoginName', array('sName' => 'Bytefresser'));
oder
$aUserData = array(
'Name' => 'Bytefresser',
'Vorname' => 'Rob',
'Passwort' => '123'
);
$sLoginName = $oSoapClient->call('Login', array($aUserData));

um jetzt auch eventuelle Fehler ausgeben zu können, muss noch die Methode getError() aufgerufen werden, welche dann die entsprechende Fehlermeldung liefert.

das Skript für einen Client könnte dann folgendermaßen aussehen:

<?php
require_once('nusoap.php');
$oSoapClient = new soapclient('http://meineadresse/soap_server.php');
$sLoginName = $oSoapClient->call('sGetLoginName', array('sName' => 'Bytefresser'));

if($sError = $oSoapClient->getError()){
echo "Fehler: ". $sError;
}
else{
echo $sLoginName;
?>

weitere Beiträge zum Thema PHP/NuSOAP:

Einführung
WSDL-Support