README

概述

这是我对原生PHP SOAP客户端实现（\SoapClient）不足之处的尝试。

使用方法

实例化

<?php
$soapClient = new \Camcima\Soap\Client($wsdl, $options);

cURL选项

此包装器使用cURL发送HTTP请求。可以使用cURL选项自定义SOAP请求。

<?php
$curlOptions = array(
    CURLOPT_CRLF => true,
    CURLOPT_SSL_VERIFYPEER => true
);
$soapClient = new \Camcima\Soap\Client($wsdl, $options);
$soapClient->setCurlOptions($curlOptions);

但是，有一些cURL选项不能被覆盖，因为它们对包装器是必需的

<?php
// Mandatory cURL Options
CURLOPT_POST => true
CURLOPT_HEADER => true

要获取当前正在使用的cURL选项

<?php
$curlOptions = $soapClient->getCurlOptions();

使用代理

如果您需要代理请求（例如，调试），可以使用此方法设置代理主机和端口

<?php
$soapClient->useProxy('proxy.local', 8080);

此方法的默认主机名和端口号为localhost和8888，这是Fiddler Web调试代理的默认绑定（http://fiddler2.com/）。

用户代理

可以自定义客户端使用的用户代理

<?php
$soapClient->setUserAgent('MyUserAgent/1.0');

小写首字母

在我开发与基于.NET的Web服务的集成时，我发现SOAP请求负载根元素名称总是首字母小写。对于其他内部元素，首字母总是大写，这与类名常见。我不知道这是否是.NET Web服务的规范，但无论如何，我实现了一个处理此问题的选项。

<?php
$soapClient->setLowerCaseFirst(true);

此设置的默认值为false。

保留空属性

当您将对象作为SOAP参数传递时，其中一些属性可能是null（或未设置）。此客户端的默认行为是在发送请求时省略这些null属性。如果您需要发送所有属性，即使为null，也可以使用此选项

<?php
$soapClient->setKeepNullProperties(true);

此设置的默认值为true。

调试

为了调试请求和响应，您需要将调试模式设置为true，并设置调试文件名和路径。

<?php
$soapClient->setDebug(true);
$soapClient->setDebugLogFilePath(__DIR__ . '/../../../../log/debug.log');

最后请求通信日志

您可以从最后请求中获取HTTP通信日志（请求和响应）。

<?php
$soapClient->getCommunicationLog();

结果类映射

PHP原生SOAP客户端实现可以将SOAP返回映射到本地类。不幸的是，它没有按预期工作。因此，我实现了自己的结果类映射版本。

它以两种不同的方式工作

使用类映射

您必须构建一个关联数组，其中结果元素作为键，相应的本地类作为值。

<?php
$soapClient = new Client($wsdlUrl);
$soapResult = $soapClient->GetCityForecastByZIP($getForecastByZip);
$resultClassmap = array(
    'GetCityForecastByZIPResult' => '\Camcima\Soap\Test\Fixtures\GetCityForecastByZIPResult',
    'ForecastResult' => '\Camcima\Soap\Test\Fixtures\ForecastResult',
    'array|Forecast' => '\Camcima\Soap\Test\Fixtures\ForecastEntry',
    'Temperatures' => '\Camcima\Soap\Test\Fixtures\Temperatures',
    'ProbabilityOfPrecipiation' => '\Camcima\Soap\Test\Fixtures\ProbabilityOfPrecipiation'
);
$getCityForecastByZIPResult = $soapClient->mapSoapResult($soapResult, 'GetCityForecastByZIPResult', $resultClassmap);

原生的SOAP客户端将所有对象作为标准类（StdClass）返回，我的映射函数将它们转换为映射的本地类。这个函数基于包含标准类对象的属性名。这在大多数情况下表现良好，但当存在对象数组时，需要特殊的配置

<?php
$mapping = array(
    'array|Forecast' => '\Camcima\Soap\Test\Fixtures'
);

包含数组的属性的名称用作映射的标记。您还需要使用array作为前缀，并使用竖线（|）来分隔它们。

使用命名空间

如果您的所有结果类都位于同一个命名空间中，就没有必要单独映射它们。您可以告诉映射器您的类所在的命名空间，它将自动通过匹配SOAP结果名称与本地类名称来确定映射。

<?php
$resultClassNamespace = '\MyProject\SOAP\Result\\';

改进

我计划根据我的需求添加新功能。如果您需要特殊功能，您有两个选择

• 自己开发并给我发送一个拉取请求。我保证会尽快合并。

• 创建一个问题并等待我开发。这可能需要一些时间，因为我通常很忙。