通用PHP SOAP客户端

厌倦了构建糟糕的SOAP实现？这个包旨在帮助你解决PHP中一些常见的SOAP集成问题。它的目标是让SOAP集成变得有趣起来！

演示

想要帮忙吗？💚

想了解更多关于这个项目未来的信息？查看我们将要进行的下一个大项目列表。

先决条件

你可以选择想要使用的HTTP客户端。这个包需要一些PSR实现才能安装：

PSR-6: psr/cache-implementation，如symfony/cache或cache/*-adapter
PSR-7: psr/http-message-implementation，如nyholm/psr7或guzzlehttp/psr7
PSR-17: psr/http-factory-implementation，如nyholm/psr7或guzzlehttp/psr7
PSR-18: psr/http-client-implementation，如symfony/http-client或guzzlehttp/guzzle

示例：

$ composer require symfony/http-client nyholm/psr7

安装

$ composer require phpro/soap-client

脚手架向导

由于生命太短不该浪费在阅读文档上，我们添加了一个脚手架向导，它可以让你快速与SOAP服务器通信！你只需要做的是：

./vendor/bin/soap-client wizard

你可以根据下一章的手动安装页面来自定义生成的代码。

让你的SOAP集成运行起来

高级配置

这是基于php-soap的客户端实现。更高级的配置，你可以查看php-soap包中的文档。

自定义代码生成

为什么要创建这个soap客户端

默认情况下，SoapClient使用数组、stdClass和其他标量类型的混合。在现代OOP世界中，这不是一个好的做法，因为：

它使你的代码难以测试。
它破坏代码补全
很难跟踪响应和请求对象的变化。
结果的内容从未明确。

为了解决上述问题，这个包将强制你使用值对象来处理请求和响应。我们知道维护这些值对象可能是一项繁重的工作。别担心！有一些命令行工具可以帮助你生成一个良好的起点。因为SoapClient需要WSDL到PHP类的类映射，所以还提供了一个类映射生成器。这肯定会为你节省大量时间！通过添加SOAP类型转换器，可以将特定SOAP类型的值从PHP类型转换或转换为PHP类型。该包包含一些用于日期和日期时间的基本转换器。此外，创建自己的转换器也非常容易。

另一个问题是，原生的SoapClient使用了很多魔术方法。这些魔术方法很难调试，因为没有代码补全。 SOAP和实现方法都在同一个对象上。

这个包将强制你将SoapClient包装到你自己的客户端中。你可以选择只暴露你需要的方法。对开发者来说，你的客户端中有什么，它如何工作以及返回什么总是很清楚的。我们甚至为你提供了一个基础客户端，其中包含一些常用的调试、身份验证和事件系统方法。

在许多SOAP集成中，日志记录、缓存和Soap调用都在同一个方法中。这使你的代码难以阅读，并依赖于其他类/包。

创建一个出色的面向对象的SOAP客户端意味着你必须创建大量代码。这可能是一项繁琐的任务，可以自动化。这就是为什么我们添加了工具，可以从WSDL内的XSD模式自动生成SOAP对象。甚至可以指定你自己的代码生成规则和代码组装器，或使用我们众多内置类之一。

保持代码整洁很重要。因此，我们在Soap客户端中添加了一个事件监听器。你可以在SOAP流程的每个重要步骤中插入。这样就可以通过事件订阅器添加日志记录、验证和错误处理。很酷吧？！

实现SOAP扩展是一件很麻烦的事。它迫使你重写内置SOAP客户端的核心方法。如果你曾经不得不在SOAP中实现WSA或WSSE，你就知道核心有问题。因此，我们让你可以轻松扩展我们的SOAP客户端。你可以指定想要使用的数据传输处理程序，例如Guzzle。根据所选的处理程序，你可以轻松地通过HTTP中间件添加对SOAP扩展或高级身份验证的支持。

处理ext-soap并不适合所有开发者。你需要了解一些棘手的问题。因此，我们让你可以使用任何你想使用的驱动程序。默认情况下，我们仍然会提供一个ext-soap驱动程序，但它是完全可选的。如果你将任何用户级SoapClient实现包装在我们自己的驱动程序接口中，你就可以使用它。

测试Web服务很困难！这个包提供了一些测试SOAP服务的各种方法。由于传输是基于HTTP的，你可以使用php-vcr实现。如果你不想进行实际的HTTP调用，你也可以在测试用例中使用自定义的Transport或Caller。测试你的SOAP客户端将非常快速，并且在集成的第三方一侧不会出现任何错误。

最后但同样重要的是，我们希望让你能轻松配置SoapClient。这就是为什么我们包含了一个生成的ClientFactory，你可以在其中配置自定义客户端。你想在开发和生产环境中使用不同的设置吗？没问题！坐下来让工厂处理你的客户端初始化。