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 templatesreferences/examples.md- Integration examples
Didn't find tool you were looking for?