在Codeigniter框架中使用NuSOAP

0、NuSOAP的简介

NuSOAP 是一组功能强大的PHP类，这个工具的发布让使用和创建SOAP消息变得相当简单。 NuSOAP有Dirtrich Ayala编写，可以无缝的与许多最流行的SOAP服务实现交互，它以LGPL协议进行发布。NuSOAP的主要特性包括：

简单：NuSOAP的面向对象方法隐藏了SOAP消息的组装、解析、提交和接收的有关细节，是用户能够集中精力处理自己的业务。

WSDL的生成和导入：NoSOAP可以生成一个对应于所发布的Web服务的WSDL文档，并且能导入一个WSDL引用在NuSOAP客户端使用。

代理类：NuSOAP可以生成的一个代理类，允许调用远程方法，如同调用本地方法一样。

HTTP代理：出于多种原因（安全性和审计是其中两个原因），有些客户端被强制将请求委托给HTTP代理，由代理代表客户端执行请求。也就是说，需要所有SOAP请求都传递给此代理，而不是直接查询服务器。NuSOAP为指定代理服务器提供了基本支持。

SSL：如果可以通过PHP使用CURL扩展，NuSOAP还支持通过SSL的安全通信。

1、Nusoap的获取安装

NuSOAP是一组PHP类，只要从SourceForge下载源码后，放入自己的工程目录引用，就可以使用。当然，NuSOAP库的存放位置可以自由决定，include目录、工程目录或者任何能够访问到的位置。

2、NuSOAP的使用

要使用NuSOAP，我觉得需要要对于SOAP有些基础得了解，附录中的参考资料我们可以了解到一些知识，从下面的图片，也可以了解到SOAP在Web服务堆栈中的地位。

使用SOAP时，有客户端和服务器两种情况。具体的使用比较简单，以至于NuSOAP官方都没有什么文档来说明，也许作者觉得不需要说明吧。下面就结合CodeIgniter框架，来说明NuSOAP的使用。

PS：需要说明的一点，NuSOAP不能和PHP的SOAP扩展同时使用，如果你的LAMP环境中安装了SOAP的扩展，那么NuSOAP直接是不能用的，因为类名重复的，如果花些力气把名字改下，也可以使用 :)

3、CI中使用Nusoap的方法

CI中调用第三方的类库，如果简单的调用，则非常的简单。一般的做法是将NuSOAP放在application/libraries 下面，然后编写一个引用这些文件的类，如 Nusoap_lib.php

<?php  if ( ! defined('BASEPATH')) exit('No direct script access allowed');

class Nusoap_lib { 
    function __construct(){ 
        $library_path = '/home/apache/htdocs/libraries/'; 
        $nusoap = $library_path . 'nusoap0.9.5/nusoap.php';

        require_once $nusoap; 
    } 
}

?>

这样，我们就可以在其他的文件中通过CI常规的加载的方式来调用 NuSOAP 进行使用，比如在一个 Client类中。

$this->load->library('Nusoap_lib');

$api_url = "http://app.x.com/webservicefordiscuz/Service.asmx"; 
$this->nusoap_client = new SoapClient( $api_url ); 
$this->nusoap_client->soap_defencoding = 'utf-8'; 
$this->nusoap_client->decode_utf8 = false; 
$this->nusoap_client->xml_encoding = 'utf-8';

$err = $this->nusoap_client->getError();

if( $err ){ 
    echo '<h2>Constructor error</h2><pre>' . $err . '</pre>'; 
    echo '<h2>Debug</h2><pre>' . htmlspecialchars($client->getDebug(), ENT_QUOTES) . '</pre>'; 
    exit(); 
}else{

}

try{ 
    $result = $this->nusoap_client->call( 
        'CheckExistUser', 
        array('username' => "$username"), 
        '', 
        'http://app.x.com/webserviceForDiscuz/CheckExistUser' 
    );

    print_r( $result ); 
    echo "<br />"; 
    echo '<p>Request:<br />'; 
    echo '<pre>',htmlspecialchars($this->nusoap_client->request,ENT_QUOTES),'</pre>'; 
    echo '<br />Response:<br />'; 
    echo '<pre>',htmlspecialchars($this->nusoap_client->response,ENT_QUOTES ),'</pre></p>'; 
    echo "<br />"; 
    print_r( $this->nusoap_client ); 
}catch(Exception $e){ 
    echo $e->getMessage(); 
}

事实上，在CI中使用NuSOAP，最大的挑战不在于如何引入。而在于理解并使用NuSOAP，我们照着参考资料1中的例子，一步步也能做出一个SOAP应用，但是却不是十分理解为什么要这样做，以及SOAP的具体通信和实现方式是怎么样的。建议感兴趣的同学可以看看IBM Developer Works中关于SOAP的介绍，相信对于SOAP的理解和今后的使用会有很大帮助。

下面，是我自己试验的过程中的两个例子，希望对大家有所帮助。

服务端

<?php  if ( ! defined('BASEPATH')) exit('No direct script access allowed'); 
class Server extends Controller{ 
    function __construct(){ 
        parent::__construct(); 
        $this->load->library('Nusoap_lib');

        $this->nusoap_server = new soap_server(); 
        $this->nusoap_server->register( 
            'hello', 
            array( 
                'name' => 'xsd:string' 
            ), 
            array('return'=>'xsd:string'), 
            'uri:soap/server', 
            'uri:soap/server/hello', 
            'rpc', 
            'encoded' 
        ); 
    }

    function index(){ 
        if($this->uri->segment(3) == "wsdl"){ 
            $_SERVER['QUERY_STRING'] = "wsdl"; 
        }else{ 
            $_SERVER['QUERY_STRING'] = ""; 
        } 
        function hello($name){ 
            return "Hello $name."; 
        } 
        $this->nusoap_server->service( file_get_contents('php://input') ); 
        exit; 
    } 
} 
?>

客户端

<?php  if ( ! defined('BASEPATH')) exit('No direct script access allowed'); 
class Client extends Controller{ 
    function __construct(){ 
        parent::__construct(); 
        $this->load->library('Nusoap_lib'); 
    }

    function index(){ 
        $this->nusoap_client = new SoapClient('http://mti.x.com/soap/server'); 
//        $this->nusoap_client->soap_defencoding = 'utf-8'; 
//        $this->nusoap_client->decode_utf8 = false; 
//        $this->nusoap_client->xml_encoding = 'utf-8';

        $err = $this->nusoap_client->getError(); 
        if( $err ){ 
            echo '<p><b>Constructor error:' . $err . '</b></p>'; 
        } 
        $result = $this->nusoap_client->call( 
            'hello', 
            array('name'=>'World'), 
            'uri:soap/server', 
            'uri:soap/server/helo' );

        if( $this->nusoap_client->fault ){ 
            echo '<p><b>Fault:'; 
            print_r( $result ); 
            echo '</b></p>'; 
        }else{ 
            print_r( $result ); 
        }

        echo "<br />"; 
        echo '<p>Request:<br />'; 
        echo '<pre>',htmlspecialchars($this->nusoap_client->request,ENT_QUOTES),'</pre>'; 
        echo '<br />Response:<br />'; 
        echo '<pre>',htmlspecialchars($this->nusoap_client->response,ENT_QUOTES ),'</pre></p>'; 
        echo "<br />";

        // Display the debug messages 
        echo '<h2>Debug</h2>'; 
        echo '<pre>' . htmlspecialchars($this->nusoap_client->debug_str, ENT_QUOTES) . '</pre>'; 
    }

}

4、常见问题

调试的三个方法：1、使用->request，->response查看消息头；2、使用日志查看调试信息；3、使用错误信息捕捉。