Skip to content

CHANGELOG.md

Latest commit

 

History

History
33 lines (26 loc) · 3.29 KB

CHANGELOG.md

File metadata and controls

33 lines (26 loc) · 3.29 KB
Raw

Changelog

All notable changes to this project will be documented in this file.

This project follows semantic versioning.

[Unreleased]

Changed

  • Require utopia-php/psr7 ^0.2.1 so Request\Factory::multipart always sets Content-Type with the body boundary.

Added

  • Initial PSR-18 HTTP client wrapper: Utopia\Client.
  • Immutable client defaults for headers, base URI, basic auth, and bearer auth.
  • cURL adapter for regular PHP runtimes.
  • Swoole coroutine adapter for coroutine runtimes.
  • Dependency on utopia-php/psr7 for Utopia\Psr7 PSR-7 messages and PSR-17 factories.
  • End-to-end response streaming via stream(), delivering the body to a sink chunk-by-chunk with bounded memory.
  • Utopia\Psr18\StreamingClientInterface for the streaming counterpart to PSR-18; the Adapter interface composes it with Psr\Http\Client\ClientInterface, and Utopia\Client implements Adapter.
  • Bounded-memory request uploads on the cURL adapter, streaming the body through a read callback; Stream\Factory::createStreamFromFile() opens files lazily and Stream::fromResource() wraps a resource without copying it.
  • Bounded-memory multipart file uploads on both adapters via lazy Part::file() and the Multipart\Body stream: cURL streams the serialised body from disk, while Swoole streams each file with native addFile() (zero-copy sendfile()).
  • Typed PSR-18 exception hierarchy (NetworkException/RequestException and their subtypes) thrown by both adapters.
  • Immutable timeout helpers for total and connection timeouts.
  • Portable TLS configuration helpers — withSslVerification(), withCustomCA(), withCertificate(), withMinTlsVersion() — and the Utopia\Client\Tls enum.
  • withConnectionReuse() to keep the underlying connection alive and reuse it across requests to the same origin, on both adapters (cURL persists and resets one handle; Swoole keeps a kept-alive coroutine client).
  • withFollowRedirects() to follow HTTP Location redirects on both adapters (cURL maps to CURLOPT_FOLLOWLOCATION; Swoole follows Location in the adapter because the coroutine client has no native equivalent). Off by default, so a 3xx response is returned with its Location header. Constructor CURLOPT_FOLLOWLOCATION / follow_location values do not override the helper. Relative Location values use RFC 3986 resolution. Cross-origin hops and HTTPS to HTTP downgrades strip Authorization, Cookie, Cookie2, and Proxy-Authorization. Swoole streams the final hop through its write callback rather than buffering it first.
  • Utopia\Client\Pool to borrow a reused client from a utopia-php/pools pool per request and reclaim it afterwards, sharing a bounded set of connections across concurrent callers.
  • Utopia\Client\Decorator\Retry decorator with a pluggable Strategy and a default best-practice Backoff strategy (idempotent methods only, transient transport failures and 429/502/503/504, exponential backoff with jitter, Retry-After honoured).
  • Opt-in W3C Trace Context propagation via withTracePropagation() (off by default): forwards the active utopia-php/span trace downstream as a traceparent header.
  • Utopia\Client\Decorator base class for composing adapter decorators.
  • PHP 8.4+ tooling with Pint, PHPStan level 10, Rector, PHPUnit, Composer audit, and GitHub Actions CI.