README

基于ZendFramework项目的ZendSoap组件的Silex SOAP服务提供商。

有关Zend Soap的更多信息，请参阅Zend Framework文档

• Zend Soap Server
• Zend Soap Client

##为什么需要Zend Soap silex服务提供商？

• 用于测试
• 为了更好的集成
• 为了简单

##安装

1. 在您的 composer.json 文件的require部分中添加 "ibsciss/zend-soap-service-provider": "dev-master"，然后运行 composer install 命令。
2. 注册服务： $app->register(new ZendSoapServiceProvider());，并不要忘记添加 use \Ibsciss\Silex\Provider\ZendSoapServiceProvider 语句。

##用法

###基本用法

当服务提供商注册后，您将可以访问两个基本服务

• soap.server，Zend\Soap\Server 实例
• soap.client，Zend\Soap\Client 实例

$app = new Application();
$app->register(new ZendSoapServiceProvider());

//client method call
$app['soap.client']->methodCall();

//server handling
$app['soap.server']->handle();

###多个实例

如果您需要更多的连接，您可以使用 soap.instances 参数定义多个实例。

//during registration
$app->register(new ZendSoapServiceProvider(), array(
    'soap.instances' => array(
        'connection_one',
        'connection_two'
    )
));

// --- OR ---
$app->register(new ZendSoapServiceProvider());
$app['soap.instances'] = array(
    'connection_one',
    'connection_two'
);

您可以通过以下两个服务访问您的实例

• soap.clients
• soap.servers

第一个定义的服务是默认服务，可以通过 soap.client 和 soap.server 服务访问。

$app['soap.clients']['connection_one']; //same as $app['soap.client'];
$app['soap.servers']['connection_two'];

###WSDL管理

您可以使用 soap.wsdl 参数为全局服务提供一个（可选）WSDL。

//during registration
$app->register(new ZendSoapServiceProvider(), array(
    'soap.wsdl' => '<wsdl></wsdl>';
));
// --- OR ---
$app['soap.wsdl'] = '<wsdl></wsdl>';

$app['soap.server']->getWsdl(); //return <wsdl></wsdl>

对于多个实例，可以为特定实例定义wsdl

//during registration
$app->register(new ZendSoapServiceProvider(), array(
    'soap.wsdl' => '<wsdl></wsdl>',
    'soap.instances' => array(
        'connection_one',
        'connection_two' => array('wsdl' => '<wsdl>anotherOne</wsdl>')
    );
));

// --- OR ---
$app['soap.wsdl'] = '<wsdl></wsdl>';
$app['soap.instances'] = array(
    'connection_one'
    'connection_two' => array('wsdl' => '<wsdl>anotherOne</wsdl>')
);

注意：如果您为每个实例提供一个wsdl，则不需要指定全局wsdl

//if you provide one wsdl per instance you don't have to specify a global one
$app->register(new ZendSoapServiceProvider(), array(
    'soap.instances' => array(
        'connection_one' => array('wsdl' => '<wsdl></wsdl>'),
        'connection_two' => array('wsdl' => '<wsdl>anotherOne</wsdl>')
    );
));

$app['soap.servers']['connection_one']->getWsdl() //return <wsdl></wsdl>
$app['soap.servers']['connection_two']->getWsdl() //return <wsdl>anotherOne</wsdl>

关于 \Zend\Soap 实现

该包现在使用官方的 \Zend\Soap 包

在 \Zend\Soap\Server

调试模式

当您的代码中发生异常时，\Zend\Soap\Server 会捕获它并检查该异常是否为授权异常。如果不是，出于安全考虑，它会发送一个“未知错误”消息。在生产环境中，这是一种合理的做法，但在开发测试过程中，这确实很烦人。

所以服务提供商扩展了 Server 类以添加一个 debugMode 方法，当silex debug 选项为 true 时，此方法会自动激活（可以通过 setDebugMode($boolean) 服务器方法手动启用/禁用调试模式）。示例

//enable:
$app['soap.server']->setDebugMode(true);

//disable:
$app['soap.server']->setDebugMode(false);

在调试模式下，服务器会将所有异常发送到soap客户端。

异常管理

如以下所述，当异常被 Zend\Soap\Server 捕获时，错误消息变为“未知错误”。因此，即使您将异常写入日志，也无法了解失败的根本原因，为了避免这种麻烦，提供程序中的服务器类提供了一个 getException 方法。示例

$app['soap.server']->fault(new \Exception('test'));

$app['soap.server']->getException(); //return the Exception instance given as attribute to the fault method.

内部 '\SoapServer' 实例

Zend\Soap\Server 使用内部 \SoapServer 实例来处理请求。在某些情况下，您需要访问此实例（例如，当 setReturnResponse 设置为 true 时发送 SoapFault）。这就是为什么，提供程序添加了一个 getSoap() 方法，它提供了当前内部 \SoapServer 实例。示例

$app['soap.server']->getSoap()->fault(new \SoapFault('an error occured'));

##高级主题

###更改Soap类

如果您想使用自己的个人肥皂类，或者出于测试目的。您可以通过 soap.client.class 和 soap.server.class 覆盖肥皂、服务器或客户端类。

警告：如果您处于 dotNet 模式，您必须使用 soap.client.dotNet.class（或实例覆盖时的 client.dotNet.class）。

//global level
$app->register(new ZendSoapServiceProvider());

$app['soap.server.class'] = '\stdClass';
$app['soap.client.class'] = '\stdClass';

$app['soap.client']; //instanceOf stdClass;
$app['soap.server']; //instanceOf stdClass;

//----------------
//you can also override at the instance scope
$app = new Application();
$app->register(new ZendSoapServiceProvider(), array(
    'soap.instances' => array(
        'connection_one' => array('server.class' => '\stdClass'),
        'connection_two' => array('client.class' => '\stdClass')
    )
));

$app['soap.clients']['connection_one']; //instanceOf Zend\Soap\Client
$app['soap.servers']['connection_one']; //instanceOf stdClass

$app['soap.clients']['connection_two']; //instanceOf stdClass
$app['soap.servers']['connection_two']; //instanceOf Zend\Soap\Server

###更改 SOAP 版本

您可以使用 soap.version 属性指定 SOAP 版本。允许的值有：

• SOAP_1_1
• SOAP_1_2（默认值）

    $app->register(new ZendSoapServiceProvider(), array(
        'soap.version' => SOAP_1_1
    ));

    // ----- OR -----

    $app['soap.version'] = SOAP_1_1;

    //results :
    $app['soap.client']->getSoapVersion(); // SOAP_1_1;
    $app['soap.server']->getSoapVersion(); // SOAP_1_1;

    // -----------------------
    //like others options, you can define it at the instance level :

    $app->register(new ZendSoapServiceProvider(), array(
        'soap.instances' => array(
            'connection_one' => array('version' => SOAP_1_1),
            'connection_two' => array('dotNet' => true),
            'connection_three'
        )
    ));

    $app['soap.clients']['connection_one']->getSoapVersion(); // SOAP_1_1
    $app['soap.servers']['connection_one']->getSoapVersion(); // SOAP_1_1

    //dotNet use 1.1 by default;
    $app['soap.clients']['connection_two']->getSoapVersion(); // SOAP_1_1
    $app['soap.servers']['connection_two']->getSoapVersion(); // SOAP_1_2

    //default config
    $app['soap.clients']['connection_three']->getSoapVersion(); // SOAP_1_2
    $app['soap.servers']['connection_three']->getSoapVersion(); // SOAP_1_2

###DotNet 特定模式

与 PHP 或 Java 实现相比，DotNet 框架处理 SOAP 参数略有不同。

因此，如果您需要将 SOAP 网络服务与 dotNet 服务器集成，请在 soap.dotNet 选项中将它设置为 true。

$app['soap.dotNet'] = true;
$app['soap.client'] // instanceOf Zend\Soap\Client\DotNet

//you can also define it at the instance scope
$app->register(new ZendSoapServiceProvider(), array(
    'soap.instances' => array(
        'connection_one' => array('dotNet' => true),
        'connection_two'
    )
));

$app['soap.clients']['connection_one']; //instanceOf Zend\Soap\Client\DotNet
$app['soap.clients']['connection_two']; //instanceOf Zend\Soap\Client

如果您想覆盖 dotNet 类，请使用 soap.client.dotNet.class 属性而不是 soap.client.class。

##总结

###服务

• soap.client：默认 SOAP 客户端实例，是第一个定义实例的别名
• soap.server：默认 SOAP 服务器实例，是第一个定义实例的别名
• soap.clients：SOAP 客户端实例容器
• soap.servers：SOAP 服务器实例容器

###参数

• soap.wsdl：全局 WSDL
• soap.client.class：覆盖客户端工厂类
• soap.server.class：覆盖服务器工厂类
• soap.dotNet：启用 dotNet 模式，使用 Soap\Client\DotNet 类
• soap.client.dotNet.class：在 dotNet 模式下覆盖客户端工厂类
• soap.version：定义 SOAP 版本，接受常量 SOAP_1_1 或 SOAP_1_2 作为值（默认为 SOAP_1_2，除非在 dotNet 模式下）

所有参数都可以在实例级别定义

$app['soap.instances'] = array(
    'connection_two' => array(
        'wsdl' => '<wsdl>anotherOne</wsdl>',
        'client.class' => '\stdClass',
        'server.class' => '\stdClass',
        'dotNet' => true,
        'client.dotNet.class' => '\stdClass',
        'version' => SOAP_1_1
    )
);