meng-tian / soap-http-binding
A PHP library for binding SOAP messages to PSR-7 HTTP messages.
Installs: 2 042 871
Dependents: 1
Suggesters: 0
Security: 0
Stars: 16
Watchers: 3
Forks: 11
Open Issues: 0
Requires
- php: >=7.1.0
- meng-tian/php-soap-interpreter: ~2.0
- psr/http-factory: ~1.0
Requires (Dev)
- laminas/laminas-diactoros: ^2.0
- phpunit/phpunit: ~7.0|~9.3
This package is not auto-updated.
Last update: 2024-11-05 07:21:18 UTC
README
This library binds SOAP 1.1
and SOAP 1.2
messages to PSR-7 HTTP messages.
Requirement
PHP 7.1
Install
composer require meng-tian/soap-http-binding
Usage
HttpBinding::request
embeds SOAP reqeust messages into PSR-7 HTTP requests.
use Meng\Soap\HttpBinding\HttpBinding; use Meng\Soap\HttpBinding\RequestBuilder; use Meng\Soap\Interpreter; use Laminas\Diactoros\RequestFactory; use Laminas\Diactoros\StreamFactory; $interpreter = new Interpreter('http://www.webservicex.net/airport.asmx?WSDL'); $streamFactory = new StreamFactory(); $requestFactory = new RequestFactory(); $builder = new RequestBuilder($streamFactory, $requestFactory); $httpBinding = new HttpBinding($interpreter, $builder, $streamFactory); $request = $httpBinding->request('GetAirportInformationByCountry', [['country' => 'United Kingdom']]); echo \Laminas\Diactoros\Request\Serializer::toString($request);
Output:
POST /airport.asmx HTTP/1.1
Content-Length: 322
SOAPAction: http://www.webserviceX.NET/GetAirportInformationByCountry
Content-Type: text/xml; charset="utf-8"
Host: www.webservicex.net
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.webserviceX.NET"><SOAP-ENV:Body><ns1:GetAirportInformationByCountry><ns1:country>United Kingdom</ns1:country></ns1:GetAirportInformationByCountry></SOAP-ENV:Body></SOAP-ENV:Envelope>
HttpBinding::response
retrieves SOAP response messages from PSR-7 HTTP responses:
use Meng\Soap\HttpBinding\HttpBinding; use Meng\Soap\HttpBinding\RequestBuilder; use Meng\Soap\Interpreter; use Laminas\Diactoros\Response; use Laminas\Diactoros\Stream; use Laminas\Diactoros\RequestFactory; use Laminas\Diactoros\StreamFactory; $response = <<<EOD <?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <GetAirportInformationByCountryResponse xmlns="http://www.webserviceX.NET"> <GetAirportInformationByCountryResult>some result</GetAirportInformationByCountryResult> </GetAirportInformationByCountryResponse> </soap:Body> </soap:Envelope> EOD; $stream = new Stream('php://memory', 'r+'); $stream->write($response); $stream->rewind(); $response = new Response($stream, 200, ['Content-Type' => 'text/xml; charset=utf-8']); $interpreter = new Interpreter('http://www.webservicex.net/airport.asmx?WSDL'); $streamFactory = new StreamFactory(); $requestFactory = new RequestFactory(); $builder = new RequestBuilder($streamFactory, $requestFactory); $httpBinding = new HttpBinding($interpreter, $builder, $streamFactory); $response = $httpBinding->response($response, 'GetAirportInformationByCountry'); print_r($response);
Output:
stdClass Object
(
[GetAirportInformationByCountryResult] => some result
)
This library also support SOAP 1.2
HTTP GET binding through RequestBuilder
class :
use Meng\Soap\HttpBinding\RequestBuilder; use Laminas\Diactoros\RequestFactory; use Laminas\Diactoros\StreamFactory; $streamFactory = new StreamFactory(); $requestFactory = new RequestFactory(); $builder = new RequestBuilder($streamFactory, $requestFactory); $request = $builder->isSOAP12() ->setEndpoint('http://www.endpoint.com') ->setHttpMethod('GET') ->getSoapHttpRequest(); echo \Laminas\Diactoros\Request\Serializer::toString($request);
Output:
GET / HTTP/1.1
Accept: application/soap+xml
Host: www.endpoint.com
License
This library is released under MIT license.