README

A WordPress-friendly HTTP layer providing clean request capture, sanitized input helpers, structured responses, and a middleware pipeline — all designed to work seamlessly within the WordPress ecosystem.

Namespace: WPZylos\Framework\Http

Features

• Request Capture — Automatically captures $_GET, $_POST, $_FILES, and $_SERVER with wp_unslash applied.
• Sanitized Input Helpers — 10 type-safe accessors wrapping WordPress sanitization functions (sanitize_text_field, sanitize_email, wp_kses_post, etc.).
• Structured Responses — Static factories for HTML, JSON, redirects, empty, and error responses.
• Middleware Pipeline — Laravel-inspired pipeline supporting class names, instances, and callables.
• Service Provider — Ready-to-use provider that registers the request as a singleton and the pipeline as a factory.
• Immutable Request — Final class with a clear, predictable API.

Requirements

Installation

composer require wpzylos/http

Quick Start

Capture a Request

use WPZylos\Framework\Http\Request;

$request = Request::capture();

Read Input

// POST first, then GET
$name = $request->input('name', 'Guest');

// Sanitized helpers
$email = $request->email('email');
$page  = $request->absint('page', 1);

// Subset of input
$credentials = $request->only(['username', 'password']);

Return a Response

use WPZylos\Framework\Http\Response;

// JSON response
$response = Response::json(['status' => 'ok', 'user' => $name]);
$response->send();

// Redirect
Response::redirect('/dashboard')->send();

Middleware Pipeline

use WPZylos\Framework\Http\Pipeline;

$response = (new Pipeline($container))
    ->send($request)
    ->through([AuthMiddleware::class, LoggingMiddleware::class])
    ->then(function (Request $request) {
        return Response::json(['message' => 'Hello!']);
    });

Documentation

• Usage Guide — Comprehensive guide covering request capture, input reading, responses, middleware, and the service provider.
• API Reference — Full method-by-method reference for every class and interface.

Support the Project

• GitHub Sponsors
• PayPal Donate

License

MIT License. See LICENSE for details.