Solo HTTP Client

Solo HTTP ClientFluent requests. Safe defaults.

An immutable PSR-18 client on Guzzle. Configure it once and share it; tokens stay with their origin, retries never repeat a payment, and logs never show a secret.

Get started
API reference
Solo HTTP Client
  • 🧊

    Immutable configuration

    timeout(), retry() and every with*() method return a new client. A shared instance never keeps one caller's token, and all copies reuse one connection pool.

  • 🔐

    Credentials bound to their origin

    Tokens, basic, digest and NTLM credentials go only to the origin of the base URI. Absolute URLs to other hosts and redirects to another origin go without them.

  • 🔁

    Safe retries

    Opt-in, with capped exponential backoff, jitter and Retry-After. POST and PATCH are repeated only when the server cannot have processed them.

  • 📎

    Explicit file uploads

    Only File objects become files, so forwarded form data such as avatar[path]=/etc/passwd stays text. Names are percent-encoded and cannot inject part headers.

  • 🕶️

    Redacted logs and errors

    Query values and URI credentials are masked in log lines and exception messages, path secrets after withRedaction(). The whole exception chain is safe to log.

  • 📮

    PSR-18 on Guzzle

    Implements ClientInterface with PSR-18 exceptions. Guzzle options, middleware, handlers and promises keep working, and HTTP error statuses are returned, not thrown.

Configure and send ​

php
use Solo\HttpClient\HttpClient;

$api = HttpClient::create('https://api.example.com/v1/')
    ->timeout(10)
    ->withToken($token)
    ->retry(3, 500);

$response = $api->get('users', ['query' => ['page' => 2]]);

if ($response->successful()) {
    $users = $response->json('data'); // null when the body is not valid JSON
}

$api->post('users', ['json' => ['name' => 'Ada', 'email' => 'ada@example.com']]);

The token goes only to https://api.example.com. A 404 or a 503 comes back as a response; only a failed transfer throws. Read the getting-started guide and the API reference for credentials, retries, uploads, logging and errors.

Installation ​

PHP 8.1+ is required, with Guzzle 7.15.2 or later.

sh
composer require solophp/http-client

Continue with the getting-started guide.

MIT licensed.

Copyright © 2025-2026 SoloPHP