Webservice--nusoap detailed

PHP SOAP Server

It is very easy to build a SOAP server with PHP and Nusoap. Basically, you just write out the functions you want to expose to your Web services, and then register them with Nusoap. OK, another two steps will be required to complete the creation of the PHP soap server. First you also create an instance of the Nusoap object in your PHP code, and then use the HTTP POST method to pass the raw data to nusoap for processing

The use of Nusoap is relatively simple, with the most commonly used classes being soap_server and SoapClient, where Soap_server is used to create the WebService service, and class soapclient is used to invoke WebService The definitions of these two classes are all in lib/nusoap.php, so we need to reference the file when we create or invoke the WebService interface program.

Nusoap is a WebService programming tool for creating or invoking webservice in a PHP environment. It is an open source software, developed by Nusphere Corporation (http://dietrich.ganx4.com/nusoap/), a series of PHP classes written entirely in PHP that send and receive SOAP messages over HTTP. One advantage of Nusoap is that there is no need for extended library support, which 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/ to download nusoap.zip.
2. Server : Establish nusoapservice.php file.

[Php]view plaincopy

4. require_once ("lib/nusoap.php");
6. $server = New soap_server ();
8. //Avoid garbled characters
10. $server ->soap_defencoding = ' UTF-8 ' ;
12. $server ->decode_utf8 = false;
14. $server ->xml_encoding = ' UTF-8 ' ;
16. $server ->configurewsdl (' test '); //Open WSDL support
18. /*
20. registering programs that need to be accessed by clients
22. type corresponding value: bool-> "Xsd:boolean" string-> "xsd:string"
24. int-> "Xsd:int" float-> "Xsd:float "
26. */
28. $server ->register ( ' getteststr ', //Method name
30. Array ("name" = " xsd:string" ), //parameter, default to "Xsd:string"
32. Array ("return" = " xsd:string" )); //return value, default to "Xsd:string"
34. //isset Detect if the variable is set
36. $HTTP _raw_post_data = Isset ( $HTTP _raw_post_data )? $HTTP _raw_post_data : '' ;
38. //service processing the data entered by the client
40. $server ->service ( $HTTP _raw_post_data );
42. /**
44. * method for calling
46. * @param $name
48. */
50. function getteststr ($name) {
52. return "Hello, {$name}!" ;
54. }
56. ?>

3. Client: Establish the nusoapclient.php file.

[Php]view plaincopy

4. require_once ("lib/nusoap.php");
6. /*
8. calling WebService via WSDL
10. parameter 1 The address of the WSDL file (the WSDL after the question mark cannot be uppercase)
12. Parameter 2 Specifies whether to use the WSDL
14. $client = new SoapClient (' http://localhost/nusoapService.php?wsdl ', true);
16. */
18. $client = New soapclient ( ' http://localhost/nusoapService.php ' );
20. $client ->soap_defencoding = ' UTF-8 ' ;
22. $client ->decode_utf8 = false;
24. $client ->xml_encoding = ' UTF-8 ' ;
26. //parameter to array form pass
28. $paras = Array (' name ' = ' Bruce Lee ' );
30. //target method can omit subsequent arguments when no parameters are available
32. $result = $client ->call ( ' getteststr ', $paras );
34. //Check for error, get return value
36. if (! $err = $client ->geterror ()) {
38. Echo "return result:", $result;
40. } Else {
42. Echo "Call Error:", $err;
44. }
46. ?>

[Php]view plaincopy

4. require_once ("lib/nusoap.php");
6. /*
8. calling WebService via WSDL
10. parameter 1 The address of the WSDL file (the WSDL after the question mark cannot be uppercase)
12. Parameter 2 Specifies whether to use the WSDL
14. $client = new SoapClient (' http://localhost/nusoapService.php?wsdl ', true);
16. */
18. $client = New soapclient ( ' http://localhost/nusoapService.php?wsdl ', true);
20. $client ->soap_defencoding = ' UTF-8 ' ;
22. $client ->decode_utf8 = false;
24. $client ->xml_encoding = ' UTF-8 ' ;
26. //parameter to array form pass
28. $paras = Array (' name ' = ' Bruce Lee ' );
30. //target method can omit subsequent arguments when no parameters are available
32. $client ->call ( ' getteststr ', $paras );
34. $document = $client ->document;
36. Echo $document;
38. ?>

Note:Return Result: Hello, {Bruce Lee}!

Wsdl
WSDL is an XML language used to describe a Web service. It is a machine-readable format that provides all the information necessary to access a service to a Web service client. Nusoap specializes in providing a class for parsing WDSL files and extracting information from them. The SoapClient object uses a WSDL class to alleviate the difficulty of the developer invoking the service. With the help of the WSDL information to create the message, the programmer simply needs to know the name and parameters of the operation to invoke it.
Using WSDL with NUSOAP provides the following advantages:
All service meta-files, such as namespaces (namespaces), endpoint URLs, parameter names (parameter names), etc., can be obtained directly from the WSDL file, allowing the client to dynamically adapt to server-side changes. Because it is readily available from the server, this data no longer requires hard coding in user scripts.
It allows us to use the Soap_proxy class. This class derives from the SoapClient class and adds a method that corresponds to the operations detailed in the WDSL file. These methods can now be called directly by the user through it.
The SoapClient class contains a getproxy () square method that returns an object of a Soap_proxy class. The Soap_proxy class derives from the SoapClient class, adding a method that corresponds to the operation defined in the WSDL document, and allows the user to invoke a endpoint remote method. This applies only to cases where the SoapClient object is initialized with the Wdsl file. The advantage is that it is easy for users to use, and the disadvantage is that creating objects in performance--php is time-consuming-and does not serve utilitarian purposes (and this functionality serves no utilitarian purpose).

[Php]view plaincopy

4. require_once ("lib/nusoap.php");
6. $client = New soapclient ( ' http://localhost/nusoapService.php?wsdl ', true);
8. $client ->soap_defencoding = ' UTF-8 ' ;
10. $client ->decode_utf8 = false;
12. $client ->xml_encoding = ' UTF-8 ' ;
14. //Generate proxy class
16. $proxy = $client ->getproxy ();
18. //Call remote function
20. $sq = $proxy ->getteststr (' Bruce Lee ');
22. if (! $err = $proxy ->geterror ()) {
24. Print_r ($sq);
26. } Else {
28. Print "ERROR: $err";
30. }
34. print ' REQUEST: '. <span>$p</span> <span>->request.</span> ' ' ;
36. print ' RESPONSE: '. <span>Str_replace</span> <span>(</span><span>' ><</span>'<span>, </span> <span>' >\n<</span>'<span>, </span> <span>$p</span><span>->response).</span> ' ' ;
38. ?>

Fourth step: Run Server Side file page: http://localhost/ Nusoapservice. PHP-Generated WSDL files

Click the method name. This allows us to provide a visual document to the service by using Nusoap by adding a few lines of code to the service. But that's not all we can do.

We add some WSDL calls in the service by using NUSOAP we can generate WSDL for the service and some other documentation. In contrast, there are few things we can do in the client, at least in our simple example. The client shown below is no different from the client without WSDL, the only difference being that parsing soapclent class is done by providing the URL to the WSDL, not the previous service endpoint.

Nusoap Call WebService the solution that appears garbled:

[Php]view plaincopy

1. $client ->soap_defencoding = ' Utf-8 ' ;
2. $client ->decode_utf8 = false;
3. $client ->xml_encoding = ' Utf-8 ' ;

file code cannot have any output , Otherwise, the call will report an error similar to the following:
XML error parsing SOAP payload on line x ( row number ): Reserved XML Name

implement WebService with nusoap , do not open php SOAP extension, The reason is that Nusoap's soapclient class has conflicts with PHP5 's built-in soap classes.

Solution Solutions

1. Modify php.ini does not load PHP5 built-in SOAP extensions (Windows is Php_soap.dll).

2. There is also a renaming of the SoapClient class for Nusoap.

Identity verification

[Php]view plaincopy

4. Header (' content-type:text/xml; Charset=utf-8 ');
6. require_once (' nusoap.php ');
8. $params = Array (' authenticationheader ' = = array(
10. ' Content-type ' = ' text/xml; Charset=utf-8 ' ,
12. ' SOAPAction ' = ' Yourfunstion ' ,
14. )
16. );
18. $client = New nusoap_client (' http://www.yourdomain.com/service.asmx?wsdl ', True, ' , '', '', '');
20. $client ->setheaders ('
22. "Http://tempuri.org/webservice" >
24. username
26. Password
30. ');
32. $err = $client ->geterror ();
34. if ($err) {
36. Echo '

    Constructor Error

    '$err'

    ';
38. }
40. $result = $client ->call (' yourfunction ', $params, ', ' , False, true);
42. if ($client->fault) {
44. Echo '

    Fault

    ';  

46. Print_r ($result);
48. Echo '';
50. } Else {
52. $err = $client ->geterror ();
54. if ($err) {
56. Echo '

    Error

    '$err'

    ';
58. } Else {
60. Echo '

    Result

    ';  

62. //print_r ($result);
64. Echo '';
66. }
68. }
70. Echo '

    Request

    ' . Htmlspecialchars ($client'

    ';
72. Echo '

    Response

    ' . Htmlspecialchars ($client'

    ';
74. ?>
    

The above describes the webservice--nusoap, including the aspects of the content, I hope that the PHP tutorial interested in a friend helpful.

