Fast Forward HTTP

Fast Forward HTTP is the aggregate HTTP package of the Fast Forward ecosystem.

It is designed for developers who want a practical starting point for HTTP work without wiring each piece manually. Install one package, register one provider, and you get the default Fast Forward HTTP stack in your container.

What You Get

• PSR-17 factories for requests, responses, server requests, streams, uploaded files, and URIs
• A PSR-18 HTTP client backed by Symfony HttpClient
• A ServerRequestInterface created from PHP globals
• Fast Forward convenience factories for JSON, HTML, text, redirect, empty responses, and payload streams
• One aggregate HttpServiceProvider that wires the stack together

Installation

composer require fast-forward/http

Quickstart

<?php

declare(strict_types=1);

use FastForward\Http\Message\Factory\ResponseFactoryInterface;
use FastForward\Http\ServiceProvider\HttpServiceProvider;
use function FastForward\Container\container;

$container = container(new HttpServiceProvider());

$responseFactory = $container->get(ResponseFactoryInterface::class);

$response = $responseFactory->createResponseFromPayload([
    'message' => 'Hello, Fast Forward HTTP!',
    'ok' => true,
]);

echo $response->getHeaderLine('Content-Type');
// application/json; charset=utf-8

Main Services

Identifier	Default concrete service	Purpose
Psr\Http\Message\RequestFactoryInterface	Nyholm\Psr7\Factory\Psr17Factory	Create outbound requests
Psr\Http\Message\ResponseFactoryInterface	Nyholm\Psr7\Factory\Psr17Factory	Create plain PSR-17 responses
FastForward\Http\Message\Factory\ResponseFactoryInterface	FastForward\Http\Message\Factory\ResponseFactory	Create JSON, HTML, text, redirect, and empty responses
FastForward\Http\Message\Factory\StreamFactoryInterface	FastForward\Http\Message\Factory\StreamFactory	Create payload-aware JSON streams
Psr\Http\Message\ServerRequestInterface	ServerRequestCreator::fromGlobals() result	Access the current incoming request
Psr\Http\Client\ClientInterface	Symfony\Component\HttpClient\Psr18Client	Send outbound HTTP requests

Documentation

See the documentation sources in docs/ for:

• installation and quickstart
• retrieving services from the container
• responses, streams, and server requests
• advanced customization and aliasing
• aggregated services and compatibility notes

Related Packages

• fast-forward/container
• fast-forward/http-client
• fast-forward/http-factory
• fast-forward/http-message

License

Fast Forward HTTP is licensed under the MIT license.

Consumer agent skill

The package includes fast-forward-http for application integration. It supports fast-forward/http:^1.2; inspect the installed version. See skill installation and lifecycle for optional project synchronization with llm/skills ^1.15, guarded manual project/global copies and a pinned Skills CLI alternative. Shipping files does not install tooling or activate the skill in an agent session.

Contributing

See CONTRIBUTING.md for changelog fragments, local checks and the release-review flow.