README.md

InitPHP HTTP — Documentation

This directory contains the long-form documentation. The top-level README.md covers installation and a tour; the pages here go deeper.

Reading order

1. Getting Started — install, run the test suite, the smallest possible example.
2. PSR-7 — building blocks
   • Messages (Request / Response)
   • ServerRequest
   • Streams
   • Uri
   • Uploaded Files
3. PSR-17 — factories
   • The unified Factory
4. PSR-18 — clients
   • Client basics
   • Configuration (timeouts, redirects, raw cURL options)
   • Exceptions and PSR-18 error contract
5. Emitter — turning a Response into bytes
   • Basic emission
   • Chunked bodies
   • Content-Range / partial content
6. Static facades
   • Overview and when to use them
   • Replacing the singleton with a custom instance
7. Recipes (task-oriented)
   • JSON responses
   • Redirects
   • File uploads
   • Streaming large files
   • Proxying requests
8. Reference
   • HTTP status code phrases
9. Upgrade guide (2.x → 3.x)

A note on the examples

Every code block in these pages was written against PHP 7.4 and is type-safe under PHPStan level 5. Newer PHP versions are obviously supported but no example uses 8.x-only syntax (no constructor promotion, no mixed, no enums) so you can drop snippets into a 7.4 codebase verbatim.