php[world] 2019 — 25 years of PHP

Exposing a Service Component as a Web service

SCA for PHP can generate WSDL from the annotations within a service component, so that it can be easily deployed and exposed as a Web service. To provide SCA with the information it needs to generate the WSDL, it is necessary to add the annotation @binding.soap under the @service annotation and to specify the parameters and return values of the methods using the @param and @return annotations. These annotations will be read when WSDL is generated, and the order and types of the parameters determine the contents of the <schema> section of the WSDL.

SCA for PHP always generates document/literal wrapped WSDL for components that are exposing a Web service. Note that this does not stop components from consuming Web services which are not SCA components and which are documented with WSDL written in a different style.

The scalar types which can be used in the @param annotation are the four common PHP scalar types: boolean, integer, float and string. These are simply mapped to the XML schema types of the same name in the WSDL. The example below, which is a trivial implementation of the StockQuote service that the ConvertedStockQuote component calls, illustrates string and float types.

Example #1 StockQuote Service


include "SCA/SCA.php";

 * Scaffold implementation for a remote StockQuote Web service.
 * @service
 * @binding.soap
class StockQuote {

     * Get a stock quote for a given ticker symbol.
     * @param string $ticker The ticker symbol.
     * @return float The stock quote.
function getQuote($ticker) {

WSDL much like the following (though with a service location other than 'localhost', probably) would be generated from this service:

Example #2 Generated WSDL

<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="" xsi:type="tDefinitions"
    xmlns:tns2="http://StockQuote" xmlns:tns=""
    xmlns:xsi="" targetNamespace="http://StockQuote">
    <xs:schema xmlns:xs=""
      <xs:element name="getQuote">
            <xs:element name="ticker" type="xs:string"/>
      <xs:element name="getQuoteResponse">
            <xs:element name="getQuoteReturn" type="xs:float"/>

  <message name="getQuoteRequest">
    <part name="getQuoteRequest" element="tns2:getQuote"/>
  <message name="getQuoteResponse">
    <part name="return" element="tns2:getQuoteResponse"/>
  <portType name="StockQuotePortType">
    <operation name="getQuote">
      <input message="tns2:getQuoteRequest"/>
      <output message="tns2:getQuoteResponse"/>
  <binding name="StockQuoteBinding" type="tns2:StockQuotePortType">
    <operation name="getQuote">
        <tns3:body xsi:type="tBody" use="literal"/>
        <tns3:body xsi:type="tBody" use="literal"/>
      <tns3:operation xsi:type="tOperation" soapAction=""/>
    <tns3:binding xsi:type="tBinding" transport="" style="document"/>
  <service name="StockQuoteService">
    <port name="StockQuotePort" binding="tns2:StockQuoteBinding">
      <tns3:address xsi:type="tAddress" location="http://localhost/StockQuote/StockQuote.php"/>

<!-- this line identifies this file as WSDL generated by SCA for PHP. Do not remove -->

add a note add a note

User Contributed Notes 1 note

deadguysfrom at gmail dot com
9 years ago
In order for SCA to find the service class, the script filename must match the service class name.  In this case, StockQuote.php
To Top