Project Icon

soap-client

通用PHP SOAP客户端库助力开发

soap-client是一个通用PHP SOAP客户端库,简化了SOAP集成流程。该项目提供代码生成工具、类型转换和事件监听功能,支持自定义HTTP客户端和PSR标准。丰富的文档和示例有助于开发者快速构建高效的SOAP集成。项目还包括脚手架向导,进一步提升开发体验。

构建状态 安装量 Packagist

通用PHP SOAP客户端

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

演示

Soap客户端演示

想要帮忙吗?💚

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

先决条件

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

  • PSR-6: psr/cache-implementation,如symfony/cachecache/*-adapter
  • PSR-7: psr/http-message-implementation,如nyholm/psr7guzzlehttp/psr7
  • PSR-17: psr/http-factory-implementation,如nyholm/psr7guzzlehttp/psr7
  • PSR-18: psr/http-client-implementation,如symfony/http-clientguzzlehttp/guzzle

示例:

$ composer require symfony/http-client nyholm/psr7

安装

$ composer require phpro/soap-client

脚手架向导

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

./vendor/bin/soap-client wizard

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

让你的SOAP集成运行起来

  1. 创建你自己的SOAP客户端。
  2. 基于SOAP类型生成PHP类。
  3. 生成类映射
  4. 生成你自己的SOAP客户端。
  5. 生成客户端工厂。
  6. 使用你的SOAP客户端。
  7. 测试你的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调用,你也可以在测试用例中使用自定义的TransportCaller。 测试你的SOAP客户端将非常快速,并且在集成的第三方一侧不会出现任何错误。

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

项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手,通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能,支持100+编程语言,与主流编辑器无缝集成,显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台,能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐,Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案,通过智能技术简化视频制作流程。无论是企业宣传还是个人分享,有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持,能够阅读和理解用户上传的文件内容,解析网页信息,并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题,Kimi都能以友好、专业的方式提供帮助。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术,为商家提供一键生成商品图和营销文案的服务,显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台,让商品第一时间被种草。

Project Cover

吐司

探索Tensor.Art平台的独特AI模型,免费访问各种图像生成与AI训练工具,从Stable Diffusion等基础模型开始,轻松实现创新图像生成。体验前沿的AI技术,推动个人和企业的创新发展。

Project Cover

SubCat字幕猫

SubCat字幕猫APP是一款创新的视频播放器,它将改变您观看视频的方式!SubCat结合了先进的人工智能技术,为您提供即时视频字幕翻译,无论是本地视频还是网络流媒体,让您轻松享受各种语言的内容。

Project Cover

美间AI

美间AI创意设计平台,利用前沿AI技术,为设计师和营销人员提供一站式设计解决方案。从智能海报到3D效果图,再到文案生成,美间让创意设计更简单、更高效。

Project Cover

稿定AI

稿定设计 是一个多功能的在线设计和创意平台,提供广泛的设计工具和资源,以满足不同用户的需求。从专业的图形设计师到普通用户,无论是进行图片处理、智能抠图、H5页面制作还是视频剪辑,稿定设计都能提供简单、高效的解决方案。该平台以其用户友好的界面和强大的功能集合,帮助用户轻松实现创意设计。

投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号