SoapServer->addFunction()

(no version information, might be only in CVS)

SoapServer->addFunction() --  Adds one or several functions those will handle SOAP requests

说明

class SoapServer {

void addFunction ( mixed functions )

}

Exports one or more functions for remote clients.

参数

functions

To export one function, pass the function name into this parameter as a string.

To export several functions, pass an array of function names.

To export all the functions, pass a special constant SOAP_FUNCTIONS_ALL.

注: functions must receive all input arguments in the same order as defined in the WSDL file (They should not receive any output parameters as arguments) and return one or more values. To return several values they must return an array with named output parameters.

返回值

无返回值。

范例

例子 1. Some examples

<?php

function echoString($inputString)
{
    return
$inputString;
}

$server->addFunction("echoString");

function
echoTwoStrings($inputString1, $inputString2)
{
    return array(
"outputString1" => $inputString1,
                 
"outputString2" => $inputString2);
}
$server->addFunction(array("echoString", "echoTwoStrings"));

$server->addFunction(SOAP_FUNCTIONS_ALL);

?>


add a note add a note User Contributed Notes
Evan Borgstrom
24-Aug-2006 06:42
In response to comment by Nathan O'Sullivan about returning (or passing) a complex type, you can also use the stdClass() object.

Assume you define a complex type like so:

<xsd:complexType name="TestType">
       <xsd:all>
               <xsd:element name="A" type="xsd:string" />
               <xsd:element name="B" type="xsd:int" />
               <xsd:element name="C" type="xsd:boolean" />
       </xsd:all>
</xsd:complexType>

To use an object in place of an array you can do:

$test = new stdClass();
$test->A = "test string";
$test->B = 45;
$test->C = false;

$result = $client->Test($test);
16-Jun-2005 08:10
function Login($username, $password)
{
  return array("LoginResult" => array("Id"=>1, "Name"=>"Nathan", "Nickname"=>"Nathan", "Email"=>"email address") );
}

Ok, Only a litte error in the last note.. :
"LoginResult" => array    and NOT      "LoginResult" , array
Nathan O'Sullivan
29-Apr-2005 02:36
You may be left wondering, as I was, how to return a complex type - consider the following WSDL snippets, for a method called Login:

 <xs:element name="Login">
       <xs:complexType>
         <xs:sequence>
           <xs:element minOccurs="0" maxOccurs="1" name="username" type="xs:string" />
           <xs:element minOccurs="0" maxOccurs="1" name="password" type="xs:string" />
         </xs:sequence>
       </xs:complexType>
     </xs:element>

   <xs:complexType name="UserInfo">
       <xs:sequence>
         <xs:element minOccurs="0" maxOccurs="1" name="Id" type="xs:string" />
         <xs:element minOccurs="0" maxOccurs="1" name="Name" type="xs:string" />
         <xs:element minOccurs="0" maxOccurs="1" name="Nickname" type="xs:string" />
         <xs:element minOccurs="0" maxOccurs="1" name="Email" type="xs:string" />
       </xs:sequence>
     </xs:complexType>

   <xs:element name="LoginResponse">
       <xs:complexType>
         <xs:sequence>
           <xs:element minOccurs="0" maxOccurs="1" name="LoginResult" type="s0:UserInfo" />
         </xs:sequence>
       </xs:complexType>
     </xs:element>

Here's a working Login function  that I've added with add SoapServer::addFunction

function Login($username, $password)
{
  return array("LoginResult", array("Id"=>1, "Name"=>"Nathan", "Nickname"=>"Nathan", "Email"=>"email address") );
}

The UserInfo complextype is represented by the inner array.  The outer array has just one element, "LoginResult".  The LogineResponse element  seems to be treated as a one-member array by PHP.