PHPackages                             meabed/asynchronous-soap - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP & Networking](/categories/http)
4. /
5. meabed/asynchronous-soap

ActiveLibrary[HTTP & Networking](/categories/http)

meabed/asynchronous-soap
========================

Parallel, multi-curl PHP SoapClient that performs many SOAP requests concurrently

4.0.0(2w ago)4411.7k—8.6%18[1 issues](https://github.com/meabed/php-parallel-soap/issues)[1 PRs](https://github.com/meabed/php-parallel-soap/pulls)MITPHPPHP >=8.0CI passing

Since Jun 17Pushed 2d ago4 watchersCompare

[ Source](https://github.com/meabed/php-parallel-soap)[ Packagist](https://packagist.org/packages/meabed/asynchronous-soap)[ Docs](https://github.com/meabed/php-parallel-soap)[ RSS](/packages/meabed-asynchronous-soap/feed)WikiDiscussions master Synced today

READMEChangelog (1)Dependencies (10)Versions (15)Used By (0)

Parallel, Multi-Curl PHP SoapClient
===================================

[](#parallel-multi-curl-php-soapclient)

 [ ![CI Status](https://github.com/meabed/php-parallel-soap/actions/workflows/ci.yml/badge.svg) ](https://github.com/meabed/php-parallel-soap/actions/workflows/ci.yml) [ ![Latest Version](https://camo.githubusercontent.com/d36e9d19a46458f712384f53461d80b467df2b40b8d1f328abccba79276de033/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d65616265642f7068702d706172616c6c656c2d736f61702e7376673f7374796c653d666c61742d737175617265) ](https://packagist.org/packages/meabed/php-parallel-soap) [ ![PHP Version](https://camo.githubusercontent.com/38262028e51a5a588004713d08254f2c20d7854a78faab7e47e8630ae4a53967/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6d65616265642f7068702d706172616c6c656c2d736f61702e7376673f7374796c653d666c61742d737175617265) ](https://packagist.org/packages/meabed/php-parallel-soap) [ ![Total Downloads](https://camo.githubusercontent.com/f8ab6e9b9242e3736e4f520decf010f86a6ba64be64538a1bb17cc69174993c8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f6d65616265642f7068702d706172616c6c656c2d736f61702e7376673f7374796c653d666c61742d737175617265) ](https://packagist.org/packages/meabed/php-parallel-soap) [ ![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265) ](LICENSE.md)

A drop-in replacement for PHP's native `SoapClient` that can fire **many SOAP requests in parallel** using curl's multi handle, while keeping the familiar synchronous SoapClient API when you need it.

Working with SOAP is often painful:

- SOAP messages are verbose and obscure.
- Performance suffers because the native client has no connection pooling, TLS session reuse, or low-level TCP tuning.
- A list of calls can only be sent sequentially — you loop and wait for each response.
- Debugging the underlying HTTP (headers / payloads / errors) is hard.

`ParallelSoapClient` lets you send requests concurrently and gives you hooks for a PSR-3 logger, response parsing, custom `SOAPAction` headers, XML formatting and arbitrary curl options (such as TLS session sharing and connection reuse).

Features
--------

[](#features)

- **Single and parallel modes** — switch with `setMulti(true|false)`.
- **True concurrency** via `curl_multi_exec` — consecutive calls no longer block each other.
- **TLS / DNS / cookie session sharing** through a shared curl handle per endpoint.
- **Per-request curl metadata** captured in `$client->curlInfo`.
- **Deterministic request ids** — identical payloads hash to the same id, so duplicate calls are sent only once.
- **First-class exception handling** in both single and parallel modes.
- **Pluggable hooks** — logger, result parser, `SOAPAction` builder, XML formatter, debug callback.

Requirements
------------

[](#requirements)

- PHP **8.0+**
- `ext-soap`, `ext-curl`, `ext-libxml`

The library is tested in CI against PHP **8.1, 8.2, 8.3, 8.4 and 8.5** (including a TLS suite).

> **Upgrading from 3.x?** 4.0 moves the client out of the now-reserved `Soap\` namespace into `Meabed\ParallelSoap\`. Change `use Soap\ParallelSoapClient;` to `use Meabed\ParallelSoap\ParallelSoapClient;` — the API is otherwise unchanged. 3.x also fatal-errors on PHP 8.4/8.5, so upgrading is required there. See [UPGRADING.md](UPGRADING.md)and the [CHANGELOG](CHANGELOG.md).

Installation
------------

[](#installation)

```
composer require meabed/php-parallel-soap
```

Usage
-----

[](#usage)

### Synchronous (single) call

[](#synchronous-single-call)

Behaves exactly like the native `SoapClient`, but the transport is curl:

```
use Meabed\ParallelSoap\ParallelSoapClient;

$client = new ParallelSoapClient($wsdl, [
    'trace' => true,
    'exceptions' => true,
    'soap_version' => SOAP_1_1,
    // Optional: unwrap the "" envelope into a scalar value.
    'resFn' => fn ($method, $res) => $res->{$method . 'Result'} ?? $res,
]);

$client->setMulti(false); // default

$sum = $client->Add(['intA' => 4, 'intB' => 3]); // 7
```

### Parallel (multi) call

[](#parallel-multi-call)

Queue any number of calls, then execute them all at once with `run()`:

```
$client->setMulti(true);
$client->setCurlOptions([
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => true,
]);

// Each call returns a request id instead of a result while in parallel mode.
$id1 = $client->Add(['intA' => 4,  'intB' => 3]);
$id2 = $client->Add(['intA' => 10, 'intB' => 20]);
$id3 = $client->Add(['intA' => 10, 'intB' => 20]); // identical payload => same id as $id2

// Fire every queued request concurrently. The client resets to single mode afterwards.
$responses = $client->run();

echo $responses[$id1]; // 7
echo $responses[$id2]; // 30
```

### Handling errors in parallel mode

[](#handling-errors-in-parallel-mode)

In parallel mode exceptions are **not** thrown; instead each result is either the parsed response or a `SoapFault` object, so you inspect the result type:

```
$responses = $client->run();

foreach ($responses as $id => $response) {
    if ($response instanceof SoapFault) {
        // Network error, malformed response, server fault, ...
        echo "Error for {$id}: {$response->getMessage()}\n";
        continue;
    }
    echo "OK {$id}: {$response}\n";
}
```

Calling a method that does not exist in the WSDL short-circuits before any HTTP request and returns a string prefixed with `ParallelSoapClient::ERROR_STR` (`*ERROR*`).

### Running a subset of queued requests

[](#running-a-subset-of-queued-requests)

```
$responses = $client->run([$id1, $id3]); // only execute these two
```

Configuration
-------------

[](#configuration)

All hooks are passed through the constructor `$options` array (and are removed before being handed to the native `SoapClient`):

OptionTypePurpose`logger``Psr\Log\LoggerInterface`PSR-3 logger; defaults to `NullLogger`.`resFn``callable($method, $res)`Transform/unwrap each parsed response.`soapActionFn``callable($action, $headers)`Build the outgoing `SOAPAction` header(s).`formatXmlFn``callable($xml)`Format the request XML before it is logged.`debugFn``callable($res, $id)`Receive each response/exception for debugging or metadata capture.Plus the runtime setters:

- `setMulti(bool)` — toggle parallel mode.
- `setCurlOptions(array)` — any `CURLOPT_*` options (TLS, timeouts, proxies, verbosity…).
- `setLogSoapRequest(bool)` — log every request payload through the PSR-3 logger.

See the [`example/`](example) directory for complete, runnable scripts.

How it works
------------

[](#how-it-works)

`__doRequest()` is overridden to build a curl handle per call instead of sending the request immediately. In parallel mode the handles are accumulated and executed together through `curl_multi_*`; the raw responses are then fed back through the native SOAP parser so you get ordinary PHP objects (or `SoapFault`s) out the other end. A shared curl handle per endpoint enables TLS session, DNS and cookie reuse across the batch.

For a deeper walkthrough — the request lifecycle, the local SOAP server used by the tests, and diagrams — see [docs/development.md](docs/development.md).

Testing
-------

[](#testing)

The test suite has two layers:

- **Hermetic tests** (`tests/Hermetic`) run against a local SOAP server started on a free port — over both **HTTP** and **TLS** (with a generated self-signed certificate). They need no network access and run by default.
- **External integration tests** (`tests/Crcind`, `tests/Dne`) hit public demo SOAP services. They are tagged with the `external` group, excluded from the default run, and skip automatically when the host is unreachable.

```
composer install

composer test          # hermetic suite only (default)
composer check-style   # PSR-2 coding standard
composer stan          # PHPStan static analysis
composer lint          # php-l syntax lint
composer ci            # lint + style + stan + tests

vendor/bin/phpunit --group external   # opt into the external integration tests
```

You can also run the local SOAP server on its own with `composer dev-server` and call it directly — see [docs/development.md](docs/development.md) for a worked example.

Contributing
------------

[](#contributing)

Contributions are welcome — please review the [guidelines](CONTRIBUTING.md):

- [One feature or change per pull request](CONTRIBUTING.md#only-one-feature-or-change-per-pull-request)
- [Write meaningful commit messages](CONTRIBUTING.md#write-meaningful-commit-messages)
- [Follow the existing coding standards](CONTRIBUTING.md#follow-the-existing-coding-standards)

Changelog
---------

[](#changelog)

See [CHANGELOG.md](CHANGELOG.md) for a list of notable changes.

Acknowledgements
----------------

[](#acknowledgements)

Thanks to everyone who has reported issues and contributed fixes, including [@c266](https://github.com/c266) for independently diagnosing the PHP 8.5 `__doRequest()`signature break ([\#180](https://github.com/meabed/php-parallel-soap/pull/180), [\#179](https://github.com/meabed/php-parallel-soap/issues/179)).

License
-------

[](#license)

Released under the [MIT license](LICENSE.md).

###  Health Score

61

—

FairBetter than 98% of packages

Maintenance98

Actively maintained with recent releases

Popularity37

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity76

Established project with proven stability

 Bus Factor1

Top contributor holds 62.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~584 days

Recently: every ~703 days

Total

6

Last Release

16d ago

Major Versions

1.0.1 → 2.02019-02-12

2.0 → 3.0.02023-07-24

3.0.1 → 4.0.02026-06-17

PHP version history (4 changes)1.0.0PHP >=7.0

2.0PHP >=7.2

3.0.0PHP >=8

4.0.0PHP >=8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/e0688fa386c5dbcbb27c78b325cf9a957ddf8b07c3bf53271060e2a32aa91975?d=identicon)[meabed](/maintainers/meabed)

---

Top Contributors

[![meabed](https://avatars.githubusercontent.com/u/45731?v=4)](https://github.com/meabed "meabed (251 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (98 commits)")[![renovate-bot](https://avatars.githubusercontent.com/u/25180681?v=4)](https://github.com/renovate-bot "renovate-bot (53 commits)")[![rstrong-pica9](https://avatars.githubusercontent.com/u/3339806?v=4)](https://github.com/rstrong-pica9 "rstrong-pica9 (2 commits)")

---

Tags

asynchronouscurlcurl-multiparallelsoapsoap-clientsoap-serverasyncasynchronouscurlconcurrentparallelsoapwsdlphp8soap-clientmulticurlcurl\_multi

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/meabed-asynchronous-soap/health.svg)

```
[![Health](https://phpackages.com/badges/meabed-asynchronous-soap/health.svg)](https://phpackages.com/packages/meabed-asynchronous-soap)
```

###  Alternatives

[meabed/php-parallel-soap

Parallel, multi-curl PHP SoapClient that performs many SOAP requests concurrently

4393.5k](/packages/meabed-php-parallel-soap)[api-platform/metadata

API Resource-oriented metadata attributes and factories

275.0M219](/packages/api-platform-metadata)[chuyskywalker/rolling-curl

Rolling-Curl: A non-blocking, non-dos multi-curl library for PHP

213461.0k6](/packages/chuyskywalker-rolling-curl)[phpgt/fetch

Asynchronous HTTP client with promises.

3726.1k5](/packages/phpgt-fetch)[khr/php-mcurl-client

wrap curl client (http client) for PHP 5.3; using php multi curl, parallel request and write asynchronous code

71230.4k6](/packages/khr-php-mcurl-client)[aalfiann/parallel-request-php

A PHP class to create multiple request in parallel (non-blocking).

1219.8k3](/packages/aalfiann-parallel-request-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)