webservice——nusoap detailed explanation

PHP SOAP Server

It is very easy to set up a SOAP server with PHP and NuSoap. Basically, you just write the functions you want to expose to your Web services and register them with NuSoap. OK, there are two more steps required to complete the establishment of the PHP SOAP server. First, you have to create an instance of the NuSoap object in your PHP code, and then use the HTTP POST method to pass the original data to NuSoap for processing. The use of NuSOAP is relatively simple, and the most commonly used classes are soap_server and soapclient. ,

Among them soap_server is used to create Webservice services, and class soapclient is used to call Webservice

. The definitions of these two classes are in lib/nusoap.php, so we need to reference this when creating or calling the Webservice interface program File. NuSoap is a WebService programming tool in the PHP environment, used to create or call WebService. It is an open source software, which is a series of PHP classes written entirely in PHP language that sends and receives SOAP messages through HTTP. It is developed by NuSphere Corporation (http://dietrich.ganx4.com/nusoap/). One advantage of NuSOAP is that it does not require extension library support. This feature allows NuSoap to be used in all PHP environments and is not affected by server security settings. ​

1.

First, go to http://sourceforge.net/projects/nusoap/download nusoap.zip. 2.Server: Create the
nusoapService.php file.

[php] view plaincopy

2. require_once ("lib/nusoap.php");
3. $server = new soap_server () ;
4. //Avoid garbled characters
5. $server->soap_defencoding = 'UTF-8';
6. $server-> ;decode_utf8 = false;
7. $server->xml_encoding = 'UTF-8'; ->configureWSDL (
'test'
8. ); //Open wsdl support /*
9. Register programs that need to be accessed by the client
10. Type corresponding value: bool->" xsd:boolean" string->"xsd:string"
11. int->"xsd:int" float->"xsd:float"
12. */
13. $server->register (
'GetTestStr'
14. , //Method name array (
"name"
15. => "xsd:string" ), // Parameters, the default is "xsd:string" array (
"return"
16. => "xsd:string " ) ); //Return value, default is "xsd:string" //isset Check whether the variable is set
17. $HTTP_RA W_POST_DATA = isset (
$HTTP_RAW_POST_DATA
18. ) ? $HTTP_RAW_POST_DATA : ''; //service Process the data input by the client
19. $server- >service (
$HTTP_RAW_POST_DATA
20. ); /**
21. * Method for calling
22. * @param $name
23. */
24. functionGetTestStr(
$name
25. ) { Resurn "Hello, {$ name}!"
;
26. } ? & Gt;
3.

Client :Create the
nusoapClient.php
file.

[php] view plaincopy

2. require_once ("lib/nusoap.php");
3. /*
4. Call WebService through WSDL
5. Parameter 1 The address of the WSDL file (the wsdl after the question mark cannot be capitalized)
6. Parameter 2 Specifies whether to use WSDL
7. $client = new soapclient('http ://localhost /nusoapService.php?wsdl',true);
8. */
9. $client = new soapclient ( 'http://localhost/nusoapService. php' ); ->decode_utf8 = false;
10. $client->xml_encoding='UTF-8';
11. $paras = array (
12. 'name' => 'Bruce Lee');
13. $result = $client->call (
14. 'GetTestStr', $paras); //Check for errors and get the return value
15. if (! $err =
16. $client->getError ()) { echo" Return results: " , $result;
17. } else {
18. echo" Call error : ", $err;
19. } ?>
[php] view plaincopy
20. 2. require_once ("lib/nusoap.php");
    3. /*
    4. Call WebService through WSDL
    5. Parameter 1 The address of the WSDL file (wsdl after the question mark cannot be capitalized)
    6. Parameter 2 Specifies whether to use WSDL
    7. $client = new soap client('http://localhost /nusoapService.php?wsdl',true);
    8. */
    9. $client = new soapclient ( 'http://localhost/nusoapService. php?wsdl',true); $client->decode_utf8 = false;
    10. $ paras = array (
    11. 'name' => Omit the following parameters
    12. $client->call ('GetTestStr', $paras
    13. ); $document
    14. = $client- >document; echo $document; Note:
    15. Return result: Hello, { Bruce Lee } ! WSDLWSDL is an XML language used to describe Web Services. It is a machine-readable format that provides all the information necessary to access the service to the Web Service client. NuSOAP specifically provides a class to parse WDSL files and extract information from them. The soapclient object uses the wsdl class to make it easier for developers to call services. By creating the message with the help of WSDL information, the programmer only needs to know the name and parameters of the operation to call it.
    Using WSDL through NuSOAP provides the following advantages:
    16. All service metafiles, such as namespaces, endpoint URLs, parameter names, etc., can be obtained directly from the WSDL file, thus allowing client dynamics to adapt to server-side changes. Because this data is always available from the server, this data no longer needs to be hard-coded in user scripts. It allows us to use soap_proxy class. This class is derived from the soapclient class and adds methods corresponding to the operations detailed in the WDSL file. Now users can directly call these methods through it. The soapclient class contains a getProxy() method which returns an object of the soap_proxy class. The soap_proxy class is derived from the soapclient class, adds methods corresponding to the operations defined in the WSDL document, and allows the user to call an endpoint's remote method. This only applies if the soapclient object is initialized with a WDSL file. The advantage is ease of use for users, the disadvantage is performance - creating objects in PHP is time consuming - and does not serve a utilitarian purpose (and this functionality serves no utilitarian purpose).
    17. [php] view plaincopy
        2. require_once ("lib/nusoap.php");
        3. $client = new soapclient ( 'http://localhost/nusoapService.php?wsdl',true);
        4. $client->decode_utf8 = false; $client->
        5. //Generate proxy class
        6. $proxy = $client->getProxy();
        7. //Call remote function
        $sq
        8. = $proxy->GetTestStr('Bruce Lee'); ->getError()) {
        9. print_r($sq);
        10. } else { : $err"; }
        11.   print 'REQUEST:＜xmp＞'.$p->request.'＜/xmp＞'
        12. ; print 'RESPONSE: ＜xmp＞'
        .
        13. str_replace('><'
        ,
        14. ">n<", $p
        -> response ).
        15. ' ＜/xmp＞'
        ;
        17. ?> lfile Click on the method name. In this way, by adding a few lines of code to the service, we provide a visual document for the service using NuSOAP. But that's not all we can do.
        18. We add some WSDL calls to the service by using NuSOAP. We can generate WSDL and some other documents for the service. In contrast, there is not much we can do in the client, at least in our simple example. The client shown below is no different from the client that does not use WSDL. The only difference is that parsing the soapclent class is done by providing the URL of the WSDL instead of the service endpoint as before. Solution to garbled code when NuSoap calls WebService: [php] view plaincopy$client
        ->soap_defencoding =
        19. 'utf-8'
        ; code_utf8 = false;

$client->xml_encoding =

'utf-8'; Otherwise, an error similar to the following will be reported when calling ：

XML error parsing SOAP payload on line

Implement WebService, Do not enable the SOAP

extension of php,

The reason is that the SoapClient class of nusoap conflicts with the built-in SOAP class of php5.

Solution

1. Modify php.ini not to load the built-in soap extension of php5 (php_soap.dll under windows).

2. Some people also renamed the SoapClient class of nusoap.

Identity authentication

2. [php] view plaincopy
   2. header('content-type: text/xml; charset=UTF-8');  
   3. require_once('nusoap.php');  
   4. $params = array('AuthenticationHeader' => array(  
   5.     'Content-Type' => 'text/xml; charset=UTF-8',  
   6.     'SOAPAction' => 'YourFunstion',  
   7. )  
   8. );  
   9. $client = new nusoap_client('http://www.yourdomain.com/service.asmx?wsdl', true, '', '', '', '');  
   10. $client->setHeaders('    
   11. "http://tempuri.org/webservice">  
3.   username   
4.   password     
5.    
6. ');  
7. $err = $client->getError();  
8. if ($err) {  
9.     echo '

   Constructor error

   '</span><span> . </span><span>$err</span><span> . </span><span>'

   ';  
10. }  
11. $result = $client->call('YourFunction', $params, '', '', false, true);  
12. if ($client->fault) {  
13.     echo '

    Fault

    '</span><span>;  </span></span></li>
    <li><span>    print_r(<span>$result</span><span>);  </span></span></li>
    <li><span>    <span>echo</span><span> </span><span>'

    ';  
14. } else {  
15.     $err = $client->getError();  
16.     if ($err) {  
17.         echo '

    Error

    '</span><span> . </span><span>$err</span><span> . </span><span>'

    ';  
18.     } else {  
19.         echo '

    Result

    '</span><span>;  </span></span></li>
    <li><span><span>//print_r($result);</span><span>  </span></span></li>
    <li><span>        <span>echo</span><span> </span><span>'

    ';  
20.     }  
21. }
22. echo'

    Request

    '</span><span> . htmlspecialchars(</span><span>$client</span><span>->request, ENT_QUOT ES) .</span><span>'</ pre>'</span><span>; </span></span>->response, ENT_QUOTES) . </li>
    <li>'

    '; ?> The above introduces the detailed explanation of webservice-nusoap, including aspects of it. I hope it will be helpful to friends who are interested in PHP tutorials.