modufolio/http

PSR-7 HTTP message implementation with additional utilities

dev-main 2026-01-25 10:38 UTC

Requires

• php: ^8.2
• psr/http-factory: ^1.0
• psr/http-message: ^2.0

Requires (Dev)

• phpunit/phpunit: ^12

MIT

• Maarten Thiebou

README

PSR-7 HTTP message implementation with additional utilities for building HTTP applications.

Installation

composer require modufolio/http

Requirements

• PHP 8.2 or higher
• PSR-7 HTTP Message interfaces
• PSR-17 HTTP Factory interfaces

Features

This package provides a complete PSR-7 implementation including:

• Request/Response: Full PSR-7 HTTP message implementation
• ServerRequest: Server-side request handling with superglobal parsing
• Uri: URI parsing and manipulation
• Stream: Stream implementation for request/response bodies
• UploadedFile: File upload handling with validation
• Emitter: Response emitters for sending HTTP responses
• ServerRequestCreator: Factory for creating ServerRequest from globals

Usage

Creating a Response

use Modufolio\Psr7\Http\Response;

$response = new Response(200, ['Content-Type' => 'application/json'], '{"message":"Hello"}');

Creating a ServerRequest from globals

use Modufolio\Psr7\Http\ServerRequestCreator;

$creator = new ServerRequestCreator();
$request = $creator->fromGlobals();

Working with Streams

use Modufolio\Psr7\Http\Stream;

$stream = Stream::create('Hello World');
echo $stream->getContents(); // "Hello World"

Handling Uploaded Files

use Modufolio\Psr7\Http\UploadedFile;

$uploadedFile = new UploadedFile(
    '/tmp/phpYzdqkD',
    'document.pdf',
    'application/pdf',
    null,
    UPLOAD_ERR_OK
);

$uploadedFile->moveTo('/uploads/document.pdf');

Testing

composer test

License

MIT