Agent skill

acc-create-psr7-http-message

Generates PSR-7 HTTP Message implementations for PHP 8.5. Creates Request, Response, Stream, Uri, and ServerRequest classes with immutability. Includes unit tests.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/acc-create-psr7-http-message

SKILL.md

PSR-7 HTTP Message Generator

Overview

Generates PSR-7 compliant HTTP message implementations following Psr\Http\Message interfaces.

When to Use

  • Building custom HTTP framework
  • Creating lightweight HTTP message handling
  • Need for immutable request/response objects
  • Testing HTTP interactions

Generated Components

Component Interface Location
Request RequestInterface src/Infrastructure/Http/Message/
Response ResponseInterface src/Infrastructure/Http/Message/
ServerRequest ServerRequestInterface src/Infrastructure/Http/Message/
Stream StreamInterface src/Infrastructure/Http/Message/
Uri UriInterface src/Infrastructure/Http/Message/
UploadedFile UploadedFileInterface src/Infrastructure/Http/Message/

Quick Template: Response

php
<?php

declare(strict_types=1);

namespace App\Infrastructure\Http\Message;

use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\StreamInterface;

final readonly class Response implements ResponseInterface
{
    private const PHRASES = [
        200 => 'OK', 201 => 'Created', 204 => 'No Content',
        400 => 'Bad Request', 401 => 'Unauthorized', 403 => 'Forbidden',
        404 => 'Not Found', 500 => 'Internal Server Error',
    ];

    public function __construct(
        private int $statusCode = 200,
        private string $reasonPhrase = '',
        private array $headers = [],
        private StreamInterface $body = new Stream(''),
        private string $protocolVersion = '1.1',
    ) {}

    public function getStatusCode(): int { return $this->statusCode; }
    public function getReasonPhrase(): string { return $this->reasonPhrase; }
    public function getHeaders(): array { return $this->headers; }
    public function getBody(): StreamInterface { return $this->body; }

    public function withStatus(int $code, string $reasonPhrase = ''): static
    {
        return new self($code, $reasonPhrase ?: (self::PHRASES[$code] ?? ''),
            $this->headers, $this->body, $this->protocolVersion);
    }

    public function withHeader(string $name, $value): static
    {
        $headers = $this->headers;
        $headers[strtolower($name)] = is_array($value) ? $value : [$value];
        return new self($this->statusCode, $this->reasonPhrase, $headers,
            $this->body, $this->protocolVersion);
    }

    public function withBody(StreamInterface $body): static
    {
        return new self($this->statusCode, $this->reasonPhrase,
            $this->headers, $body, $this->protocolVersion);
    }

    // ... other MessageInterface methods
}

Usage Example

php
<?php

use App\Infrastructure\Http\Message\Response;
use App\Infrastructure\Http\Message\Stream;

// Create response
$response = new Response(200);
$response = $response
    ->withHeader('Content-Type', 'application/json')
    ->withBody(new Stream(json_encode(['status' => 'ok'])));

// Read response
echo $response->getStatusCode();           // 200
echo $response->getHeaderLine('Content-Type'); // application/json
echo (string) $response->getBody();        // {"status":"ok"}

Requirements

json
{
    "require": {
        "psr/http-message": "^2.0"
    }
}

See Also

  • references/templates.md - Full Response, Stream, Uri, Request, ServerRequest, UploadedFile templates
  • references/examples.md - Integration examples

Didn't find tool you were looking for?

Be as detailed as possible for better results