php - 如何填充复合消息并作为 SoapServer 响应 XML 返回？

Question

我正在设置一个 SOAP 网络服务，它应该返回一个复合消息。
此消息的有效实例如下:

<dl190Response xmlns="http://pse/">
    <cdhead cisprik="5563167"/>
    <mvts>
        <mvts_S att="a1">
            <x>x1</x>
            <w>w1</w>
        </mvts_S>
        <mvts_S>
            <x>x2</x>
            <w>w2</w>
        </mvts_S>
    </mvts>
</dl190Response>

所有这些都在 wsdl 中明确定义:

<?xml version="1.0" encoding="UTF-8"?>
<definitions
    xmlns="http://schemas.xmlsoap.org/wsdl/"
    xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
    xmlns:tns="http://pse/"
    xmlns:xs="http://www.w3.org/2001/XMLSchema"
    name="PSE"
    targetNamespace="http://pse/">
    <types>
        <xs:schema xmlns="http://pse/" targetNamespace="http://pse/">
            <xs:complexType name="cdhead_T">
                <xs:attribute name="cisprik" type="xs:long"/>
            </xs:complexType>
            <xs:complexType name="mvts_T">
                <xs:sequence>
                    <xs:element name="mvts_S" type="mvts_S_T" minOccurs="0" maxOccurs="unbounded"/>
                </xs:sequence>
            </xs:complexType>
            <xs:complexType name="mvts_S_T">
                <xs:sequence>
                    <xs:element name="x" type="xs:string"/>
                    <xs:element name="w" type="xs:string"/>
                </xs:sequence>
                <xs:attribute name="att" type="xs:string" use="optional"/>
            </xs:complexType>
        </xs:schema>
    </types>
    <message name="DL190Req">
        <part name="cdhead" type="tns:cdhead_T"/>
    </message>
    <message name="DL190Res">
        <part name="cdhead" type="tns:cdhead_T"/>
        <part name="mvts" type="tns:mvts_T"/>
    </message>
    <portType name="DLPortType">
        <operation name="dl190">
            <input message="tns:DL190Req"/>
            <output message="tns:DL190Res"/>
        </operation>
    </portType>
    <binding name="DLBinding" type="tns:DLPortType">
        <soap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>
        <operation name="dl190">
            <soap:operation soapAction="http://www.testServer.com/test_soap.php#dl190"/>
            <input>
                <soap:body use="literal" namespace="http://pse/"/>
            </input>
            <output>
                <soap:body use="literal" namespace="http://pse/"/>
            </output>
        </operation>
    </binding>
    <service name="PSE">
        <port name="DLPortType" binding="tns:DLBinding">
            <soap:address location="http://www.testServer.com/test_soap.php"/>
        </port>
    </service>
</definitions>

我一直在服务器端 test_soap.php 上无休止地工作以使其正确，但我没有成功。在返回 XML 之前正常工作的部分内容如下:

<?php
    class PSE {
        function dl190 ($arg) {
            //I don't need to extract the input data just now

            mysql_connect('127.0.0.1:3306', 'user', 'password');
            mysql_select_db('myDatabase');

            $xml = new SimpleXMLElement('<dl190Res/>');
            $xml -> addChild('cdhead');
            $mvts = $xml -> addChild('mvts');

            $rows = mysql_query('select * from trx');
            while($data = mysql_fetch_assoc($rows)) {
                $mvts_S = $mvts -> addChild('mvts_S'); 
                foreach($data as $key => $value) {
                    if ($key == 'att') { $mvts_S -> addAttribute($key, $value);}
                    else    {$mvts_S -> addChild($key, $value);}
                }
            };

            $dom = dom_import_simplexml ($xml) -> ownerDocument;

            // now respond to the request and return the XML
        }

    };
    ini_set( "soap.wsdl_cache_enabled", "0");
    $server = new SoapServer ("test.wsdl");
    $server -> setClass ('PSE');
    $server -> setObject (new PSE());
    $server -> handle();    
?>

我几乎尝试了所有我能想到的方法来获得正确的响应，但我没有成功。我能够对之前仅包含一个部分的消息执行相同的操作(请参阅我最近的问题+答案)。
但是在这里，有两个消息部分，我没有成功。

当然，在让 soap 服务器将其包装到 Envelope+Body 之后，$xml 内容的调试表明这正是我希望看到的返回内容。

实际上情况与只有一个消息部分的情况不同:只要我先剥离 XML 声明并返回它，我就可以从一个部分创建一个新的 SoapVar。在这里我不能这样做，因为返回值由两部分组成。

所以我想知道我现在应该做什么:

1. 为响应消息声明一个类并填充并返回它
2. 使用 SoapVar 和/或 SoapParam 施展魔法(请注意，我已经尝试了很多)
3. 对数组和 SoapVar 施展魔法(已经尝试了很多)
4. 以某种方式(如何？)向 wsdl 寻求帮助
5. 完全不同的东西
6. 用 SoapServer 结束这整个噩梦，从头开始创建我自己的 http 响应

我感谢所有帮助，所以 SOAP 专家们，请不要犹豫，尝试回答这个问题!

添加

作为临时解决方法，我编辑了 WSDL，将响应消息更改为只有一个部分。这允许我将预期的消息作为预期的两个部分的串联传递(或与此相关的任何其他消息，因为 SoapVar 没有对返回值进行消息定义结构 WSDL 检查):

$xml1 = new SimpleXMLElement('<cdhead/>');
$xml1 -> addAttribute ('xmlns', 'http://pse/');
$xml1 -> addAttribute ('cisprik', $newCisprik);

$xml2 = new SimpleXMLElement('<mvts/>');

$rows = mysql_query('select * from trx');
while($data = mysql_fetch_assoc($rows)) {
    $mvts_S = $xml2 -> addChild('mvts_S'); 
    foreach($data as $key => $value) {
        if ($key == 'att') { $mvts_S -> addAttribute($key, $value);}
        else    {$mvts_S -> addChild($key, $value);}
    }
};

$dom1 = dom_import_simplexml ($xml1) -> ownerDocument;
$dom2 = dom_import_simplexml ($xml2) -> ownerDocument;
$part1 = $dom1 -> saveXML($dom1 -> documentElement);
$part2 = $dom2 -> saveXML($dom2 -> documentElement);

$result = new SoapVar ($part1 . $part2, XSD_ANYXML);

特别之处在于连接当然不是有效的 XML，缺少周围的根元素，但 SoapVar 无论如何都能够解析它。

就是这样:对 SoapVar 和 SoapParam/SoapServer 有详细了解的任何人都可以解释是否完全有可能返回两个消息部分？
并说明如何操作？
或者，提供有关如何在其他 SOAP 设置中执行此操作的详细信息？

Answer 1

我尝试并设置了最小的 SoapServer，这是我所做的:

1. 将您的 wsdl 和 PHP 脚本复制到一个文件夹。
2. 更改 wsdl 位置引用以指向 php 脚本。
3. 将 WSDL 导入 SoapUI - 强烈推荐它，它是免费的!
4. 尝试调用该服务。

这是我的调用请求:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pse="http://pse/">
   <soapenv:Header/>
   <soapenv:Body>
      <pse:dl190>
         <cdhead cisprik="0"/>
      </pse:dl190>
   </soapenv:Body>
</soapenv:Envelope>

由于您对数据库的调用，它最初没有工作，但我知道您真的只需要一个解决方案来解决如何在 soap 层上正确响应，其余的您会弄清楚。

这是一个简单的解决方案:

<?php
class PSE
{
    public function dl190($arg)
    {
        //var_dump($arg) is:
        //object(stdClass)#3 (1) {
        //   ["cisprik"]=> int(0)
        //}

        $fakeResult = array();

        $fakeResult[0] = new stdClass();
        $fakeResult[0]->cisprik = 23;

        $fakeResult[1] = array();

        $fakeResult[1][0] = new stdClass();
        $fakeResult[1][0]->att = "a1";
        $fakeResult[1][0]->x = "x1";
        $fakeResult[1][0]->w = "w1";

        $fakeResult[1][1] = new stdClass();
        //$fakeResult[1][1]->att = "a1";
        $fakeResult[1][1]->x = "x2";
        $fakeResult[1][1]->w = "w2";

        return $fakeResult;
    }
}

//ini_set("soap.wsdl_cache_enabled", "0");

$server = new SoapServer ("wsdl.xml");
$server->setObject(new PSE());
$server->handle();

请注意，PHP 基本上只在请求参数中发出 stdClass 和数组的混合(我将您得到的内容作为评论转储在顶部)。这是一件令人难过的事情，但我相信在同一级别上做出回应而不是通过使用 XML 作为返回方式使事情变得更糟是一件公平的事情。

如果您针对此代码执行上述请求，您将获得此 soap 响应:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://pse/">
   <SOAP-ENV:Body>
      <ns1:dl190Response>
         <cdhead cisprik="23"/>
         <mvts>
            <mvts_S att="a1">
               <x>x1</x>
               <w>w1</w>
            </mvts_S>
            <mvts_S>
               <x>x2</x>
               <w>w2</w>
            </mvts_S>
         </mvts>
      </ns1:dl190Response>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

但是还有改进的余地。 PHP SoapServer(以及 SoapClient)有一个称为类映射的特性，我强烈建议您使用它。如果您的 IDE 支持任何类型的 PHPDoc 自动完成，您几乎可以在任何处理正确设置值的地方利用它。

这是我的带有类映射定义的版本。请注意，我在它们前面都加上了“PSE”前缀，以强调类名不需要以 WSDL 中的复杂类型命名这一事实。

<?php
class PSE
{
    public function dl190(PSE_cdhead_T $arg)
    {
        //  var_dump($arg) is:
        //  object(PSE_cdhead_T)#3 (1) {
        //      ["cisprik"]=> int(0)
        //  }

        $fakeResult = array();
        $fakeResult[0] = new PSE_cdhead_T();
        $fakeResult[0]->cisprik = 23;

        $fakeResult[1] = array();

        $fakeResult[1][0] = new PSE_mvts_S_T();
        $fakeResult[1][0]->att = "a1";
        $fakeResult[1][0]->x = "x1";
        $fakeResult[1][0]->w = "w1";

        $fakeResult[1][1] = new PSE_mvts_S_T();
        //$fakeResult[1][1]->att = "a1";
        $fakeResult[1][1]->x = "x2";
        $fakeResult[1][1]->w = "w2";

        return $fakeResult;
    }
}

class PSE_cdhead_T {
    /**
     * @var int
     */
    public $cisprik;
}


class PSE_mvts_S_T {
    /**
     * @var string
     */
    public $att;

    /**
     * @var string
     */
    public $x;

    /**
     * @var string
     */
    public $w;
}

//ini_set("soap.wsdl_cache_enabled", "0");

$classmap = array(
    'cdhead_T' => 'PSE_cdhead_T',
    'mvts_S_T' => 'PSE_mvts_S_T',
);

$serverOptions = array(
    'encoding' => 'utf-8',
    'classmap' => $classmap,
    'features' => SOAP_SINGLE_ELEMENT_ARRAYS,
);

$server = new SoapServer ("wsdl.xml", $serverOptions);

$server->setObject(new PSE());
$server->handle();

不幸的是，一个烦人的问题没有解决:在您的响应中，您不能使用类，而必须使用一个数组，而没有任何关于哪个索引参数映射到哪个 xml 结果的提示。这真的很糟糕，但要更改它，您必须更改 WSDL。

我很不高兴地报告说我不是创建 WSDL 文件的专家。我试图添加一个复杂类型作为响应中的唯一元素。如果您查看我的第二个版本中的转储，您会发现您得到了一个类 PSE_cdhead_T，它是请求消息的唯一部分的映射复杂类型。

因为响应消息有两部分，所以 SoapServer 必须将它们放在一个数组中。没有可能的命名引用。我建议您在此处添加一个新的 complexType 并在 map 中相应地创建一个新类，如下所示:

class PSE_DL190_Response
{
    /**
     * @var PSE_cdhead_T
     */
    public $cdhead;
    /**
     * @var PSE_mvts_S_T[]
     */
    public $mvts;
}

然后您可以更轻松地准备响应:

$fakeResult = new PSE_DL190_Response();
$fakeResult->cdhead = new PSE_cdhead_T(); // Set the one cdhead structure
$fakeResult->mvts[] = new PSE_mvts_S_T(); // Add one mvts structure;

这很可能会导致您的 XML 响应发生变化 - 但我无法评估其影响。

最后一个想法:有一些适用于 PHP 的 WSDL 代码生成器，您可以尝试一下。他们将自动生成类映射所需的类。上次我尝试它们时，它们似乎可以工作，但不适用于我测试的所有 WSDL 文件。 Soap 的定义似乎太复杂了，无法做到这一点。但如果它有效，那么与其手动创建它们是非常值得的。