ZEND PHP 5 Certification STUDY GUIDE

210 ” XML and Web Services
}
When creating a SOAP server with SoapServer, you must decide whether your server
will operate in WSDL or non-WSDL mode. At present, SoapServer will not automatically
generate a WSDL file based on an existing PHP class, although this feature is
planned for a future release. For now, you can either create your WSDL files manually—usually
an incredibly tedious task, use a tool (like the Zend Studio IDE) that will
generate one for you, or choose not to provide one at all. For the sake of simplicity,
our example SOAP server will operate in non-WSDL mode.
Once we have created the server, we need to inform it of the class that we want the
web service to be based on. In this case, our SOAP server will use the MySoapServer
class. Finally, to process incoming requests, call the handle() method:
$options = array(’uri’ => ’http://example.org/soap/server/’);
$server = new SoapServer(NULL, $options);
$server->setClass(’MySoapServer’);
$server->handle();
While this SOAP service will work just fine in non-WSDL mode, it is important to
note that a WSDL file can be helpful to both users of the service and to the SoapServer
object itself. For users, a WSDL file helps expose the various methods and data types
available. For the server, the WSDL file allows the mapping of different WSDL types
to PHP classes, thus making handling complex data simpler.
The following example shows how a client might access the SOAP server described
in this section. Notice how the client is able to access the getMessage() and
addNumbers() methods of the MySoapServer class:
$options = array(
’location’ => ’http://example.org/soap/server/server.php’,
’uri’ => ’http://example.org/soap/server/’
);
$client = new SoapClient(NULL, $options);
Licensed to 482634 - Amber Barrow (itsadmin@deakin.edu.au)
echo $client->getMessage() . "\n";
echo $client->addNumbers(3, 5) . "\n";