README

General purpose PHP SOAP-client

Sick and tired of building crappy SOAP implementations? This package aims to help you with some common SOAP integration pains in PHP. Its goal is to make integrating with SOAP fun again!

Demo

Want to help out? 💚

Want more information about the future of this project? Check out this list of the next big projects we'll be working on.

Prerequisites

You can choose what HTTP client you want to use. This package expects some PSR implementations to be present in order to be installed:

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

Example:

$ composer require symfony/http-client nyholm/psr7

Installation

$ composer require phpro/soap-client

Scafolding Wizard

Since life is too short to read documentation, we've added a scafolding wizard which will get you communicating with your SOAP server in no time! All you need to do is:

./vendor/bin/soap-client wizard

You can customize the generated code based on the manual installation pages in the next chapter.

Getting your SOAP integration up and running

Advanced configuration

This is a client implementation on top of php-soap. For more advanced configuration, you can check the documentation inside the php-soap packages.

Customize the code generation

Why this soap client was made

By default, the SoapClient works with a mix of arrays, stdClasses and other scalar types. This is not a good practice in a modern OOP world because:

It makes your code hard to test.
It breaks Code Completion
It is hard to track changes in the response and request objects.
The content of a result is never explicit.

To solve the above problems, this package will force you into using Value-objects for Requests and Responses. We know that maintaining these value-objects can be a load of work. No worries! There are some commandline tools available that will help you with generating a good base to start with. Because the SoapClient will need a classmap of WSDL to PHP Classes, there is also a classmap generator available. This will surely save you a lot of time! By adding SOAP type converters, it is possible to transform the values of a specific SOAP type from/to a PHP type. The package comes included with some basic transformers for date and datetime. On, top of that, it is very easy to create your own transformers.

Another problem is that the native SoapClient works with a lot of magic methods. It is hard to debug these magic methods hence there is no code completion. Both SOAP and implementation methods are on the same object.

This package will force you into wrapping a SoapClient into your own Client. You can choose to only expose the methods you need. It will always be clear to the developer what's in your client, how it works and what it returns. We even provided a base Client for you to use with some common used methods for debugging, authentication and an event system.

In lots of SOAP integrations, the logging, caching and Soap calls are in the same method. This makes your code hard to read and dependent on other classes / packages.

Creating a great OO SOAP client means that you'll have to create a lot of code. This can be a tedious task which can be automated. That is why we've added the tools to automatically generate the SOAP objects from the XSD scheme inside the WSDL. It is even possible to specify your own code-generation rules and code assemblers or use one of our many built-in classes.

It is important keep your code clean. Therefore, we added an event-listener to your Soap client. You can hook in at every important step of the SOAP flow. This way it is possible to add logging, validation and error handling with event subscribers. Pretty cool right?!

Implementing SOAP extensions is a real pain in the ass. It forces you to overwrite core methods of the built-in SOAP client. If you ever had to implement WSA or WSSE in SOAP, you know that there is something wrong in the core. Therefore, we made it easy for you to extend our SOAP client. You can specify which data transfer handler like e.g. Guzzle you want to use. Depending on the selected handler, you can easily add support for SOAP extensions or advanced authentication through HTTP middlewares.

Dealing with ext-soap is not for all developers. There are some nasty quirks you need to know about. Therefore, we made it possible for you to use which ever driver you want to use. By default we will still ship an ext-soap driver, but it is completely opt-in. You can use any user-land SoapClient implementation if you wrap it in our own driver interfaces.

Testing webservices is hard! This package provide some various ways of testing a SOAP service. Since the transport is HTTP based, you could use a php-vcr implementation. If you don't want to do actual HTTP calls, you could also use a custom Transport or Caller in your test cases. Testing your SOAP client will be very fast and without any errors at the 3th party side of the integration.

Last but not least, we want to make it easy for you to configure your SoapClient. That is why we included a generated ClientFactory on which you can configure your custom Client. You want some other settings during development and in production? No problem! Sit back and let the factory handle your Client initialization.

phpro / soap-client

Maintainers

Details