webservco / http

v2.3.0 2026-10-11 16:34 UTC

Requires

• php: ^8.4
• fig/http-message-util: ^1
• psr/http-factory: ^1
• psr/http-message: ^2
• psr/http-server-handler: ^1
• psr/http-server-middleware: ^1
• webservco/data: ^2
• webservco/http-request-service: ^2
• webservco/http-response-service: ^2

Requires (Dev)

• pds/skeleton: ^1
• phan/phan: ^6
• php-parallel-lint/php-console-highlighter: ^1
• php-parallel-lint/php-parallel-lint: ^1
• phpmd/phpmd: ^3
• phpstan/phpstan: ^2
• phpstan/phpstan-deprecation-rules: ^2
• phpstan/phpstan-phpunit: ^2
• phpstan/phpstan-strict-rules: ^2
• phpunit/phpunit: ^13
• slevomat/coding-standard: ^8
• squizlabs/php_codesniffer: ^4
• vimeo/psalm: ^6
• webservco/coding-standards: ^2
• webservco/component-common: ^2

Provides

• psr/http-factory-implementation: *
• psr/http-message-implementation: *

MIT

• Radu Maier

• component
• webservco

Published on Packagist.org on 2026-10-11 16:42 UTC

README

A PHP component/library. Please see webservco/sandbox for an example project using these types of components.

Minimal implementation of the PSR-7 HTTP message interfaces and the PSR-17 factories.

• Implements: PSR-7: HTTP message interfaces, PSR-17: HTTP Factories
• Provides: psr/http-message-implementation, psr/http-factory-implementation
• Related: webservco/http-request-service, webservco/http-response-service (helper services), webservco/http-client (sends requests created here)

Installation

composer require webservco/http

Usage

Server request from PHP globals

use WebServCo\Http\Factory\Message\Request\Server\ServerRequestFromServerDataFactory;

// \WebServCo\Http\Contract\Message\Request\Server\ServerRequestFromServerDataFactoryInterface
$serverRequestFactory = new ServerRequestFromServerDataFactory();
// \Psr\Http\Message\ServerRequestInterface
$serverRequest = $serverRequestFactory->createServerRequestFromServerData(
    ['example.ddev.site'],
    $_COOKIE,
    $_POST,
    $_GET,
    $_SERVER,
    $_FILES,
);

webservco/application-default does this for you, with the hosts taken from ALLOWED_HOSTS.

Requests and responses

use WebServCo\Http\Factory\Message\Request\RequestFactory;
use WebServCo\Http\Factory\Message\Response\ResponseFactory;
use WebServCo\Http\Factory\Message\Stream\StreamFactory;
use WebServCo\Http\Service\Message\Response\StatusCodeService;

// PSR-17: \Psr\Http\Message\RequestFactoryInterface
$requestFactory = new RequestFactory();
$request = $requestFactory->createRequest('GET', 'https://example.com/api/items');

$streamFactory = new StreamFactory();
// PSR-17: \Psr\Http\Message\ResponseFactoryInterface
$responseFactory = new ResponseFactory(new StatusCodeService(), $streamFactory);
$response = $responseFactory->createResponse(404);

Contracts

Interface	Implementation	Purpose
PSR-17 RequestFactoryInterface	Factory\Message\Request\RequestFactory	Creates a Service\Message\Request\Request.
PSR-17 ServerRequestFactoryInterface	Factory\Message\Request\Server\ServerRequestFactory	Creates a Service\Message\Request\Server\ServerRequest.
PSR-17 ResponseFactoryInterface	Factory\Message\Response\ResponseFactory	Creates a Service\Message\Response\Response.
PSR-17 StreamFactoryInterface	Factory\Message\Stream\StreamFactory	Creates a Service\Message\Stream\Stream.
PSR-17 UriFactoryInterface	Factory\Message\UriFactory	Creates a Service\Message\Uri.
PSR-17 UploadedFileFactoryInterface	Factory\Message\UploadedFileFactory	Creates a Service\Message\UploadedFile.
Contract\Message\Request\Server\ServerRequestFromServerDataFactoryInterface	Factory\Message\Request\Server\ServerRequestFromServerDataFactory	Builds the server request from PHP globals.
Contract\Message\Request\RequestHandler\RequestHandlerFactoryInterface	your factory	Creates the application's PSR-15 request handler.

Namespaces are relative to WebServCo\Http\.

Notes

The request host comes from SERVER_NAME, and it must be in the allowed hosts list or an OutOfBoundsException is thrown. This blocks requests with a forged Host header.

Using this implementation with php-http/discovery

A library that depends on php-http/discovery only looks for a fixed list of 9 "well-known" implementations and won't find this one. Register a discovery strategy to add it:

use Http\Discovery\Strategy\DiscoveryStrategy;
use Psr\Http\Message\RequestFactoryInterface;
use Psr\Http\Message\StreamFactoryInterface;
use WebServCo\Http\Factory\Message\Request\RequestFactory;
use WebServCo\Http\Factory\Message\Stream\StreamFactory;

final class Psr17DiscoveryStrategy implements DiscoveryStrategy
{
    /**
     * @param string $type
     * @return array<array<string, string>>
     */
    public static function getCandidates($type)
    {
        return match ($type) {
            RequestFactoryInterface::class => [['class' => RequestFactory::class]],
            StreamFactoryInterface::class => [['class' => StreamFactory::class]],
            default => [],
        };
    }
}

use Http\Discovery\ClassDiscovery;

// Before creating the class that uses php-http/discovery.
ClassDiscovery::prependStrategy(Psr17DiscoveryStrategy::class);

Workaround credit: Popus Razvan Adrian. See also the discovery strategies documentation.

Development

# Start project.
ddev start
# Install dependencies.
ddev c u
# Run all validations.
ddev c c
# Run unit tests.
ddev c test:dox

License

MIT