zmog/soap-client

Library that provides SOAP client through cURL to add support for timeouts.

0.9.2 2024-02-26 14:34 UTC

Requires

• php: >=8.1.0
• ext-curl: *
• ext-soap: *

MIT

• IDCT Bartosz Pachołek
• Mathieu Vedie

• soap
• webservices
• idct

README

Class derived from PHP SoapClient to add support for connection and read timeouts.

Requires PHP 5.4+ with SoapClient and cUrl.

usage

The usage is exactly the same as with PHP original SoapClient. The difference comes with the initialization as the constructor allows to set multiple new parameters which extend the original functionality.

Persistance Factor

Can be set in the constructor or using setPersistanceFactor method. Sets the amount of retries to conduct before treating the request as failed. By default set to 1.

Persistance Timeout

Can be set in the constructor or using setPersistanceTmeout method. Sets the amount of seconds to wait by cUrl before treating a single request as failed. Acts as a read timeout. By default set to 0 which means disabled.

Negotiation Timeout

Can be set in the constructor or using setNegotiationTimeout method. Sets the maximum amount of seconds cUrl will try to establish connection with the WebService before treating the request as failed. As a connectin timeout. By default set to 0 which means disabled.

tips

Content-Type and SOAPAction

Protocol SOAP 1.1 requires SOAPAction header to be set. Method buildHeaders automatically adds it during soap request. In SOAP 1.2 SOAPAction is included in Content-type header therefore if you need to overwrite Content-type with SOAP 1.2 be sure to include {SOAPACTION} token for automatic replacement.

contribution

If you find any issues or want to add new features please use the Issues or Pull Request functions: code addition is much appreciated!

Before sending code be sure to run fix_code.sh to clean it up.

Thanks!