rr/README.md

Infor-Request-Response

PHP library for HTTP request/response abstraction. Provides clean, static-style APIs for reading request parameters, building responses, and managing session flash messages.

Package: inforsistemas/rr Namespace: RR Requires: PHP 8.1+

---

Installation

composer require inforsistemas/rr

---

Classes

Request — Reading input parameters

Fully static class. POST always takes precedence over GET.

use RR\Request;
use RR\ParamType;

// Required param — throws Exception if missing
$id = Request::requiredParam('id', ParamType::INT);

// Optional param — returns default if missing
$search = Request::optionalParam('q', ParamType::ALPHA, '');

// Required array param — throws Exception if missing
$items = Request::requiredParamArray('items');

// Detect AJAX/fetch/API client requests
if (Request::detectAjaxRequest()) {
    // respond with JSON
}

ParamType enum values: INT, DOUBLE, ALPHA, ALPHANUM

---

Response — Building and sending responses

Singleton accessed via Response::getInstance(). All builder methods are chainable and static.

use RR\Response;

// Send a plain HTML response
Response::body('<h1>Hello</h1>')->send();

// Append/prepend to the body buffer
Response::bodyPrepend('<header>...</header>');
Response::bodyAppend('<footer>...</footer>');
Response::send();

// Set a custom header
Response::header('X-Custom', 'value')->send();

// Send a JSON response
Response::json(['status' => 'ok', 'data' => $result])->send();

// JSONP response
Response::json($data, 'myCallback')->send();

// Redirect (303 by default)
// Automatically returns JSON {"location": "..."} for AJAX requests
Response::redirect('/dashboard');
Response::redirect('/login', 302);

// Redirect back to the previous page (HTTP_REFERER)
Response::back();

// Terminate execution after sending
Response::send()->done();

---

Flash — Session-based flash messages

Singleton accessed via Flash::getInstance(). Messages are written to the session and available on the next request.

use RR\Flash;
use RR\MessageType;

// Add messages (shorthand methods)
Flash::addInfo('Profile updated.');
Flash::addSuccess('Order placed successfully!');
Flash::addWarning('Your session will expire soon.');
Flash::addError('Invalid credentials.');

// Add a message with an explicit type
Flash::addMessage('Something happened.', MessageType::INFO);

// Read messages on the next request
if (Flash::hasMessageType(MessageType::ERROR)) {
    $errors = Flash::getError();
}

$infos    = Flash::getInfos();
$successes = Flash::getSuccess();
$warnings = Flash::getWarning();
$errors   = Flash::getError();

// Get all messages of any type
$messages = Flash::getMessages(MessageType::SUCCESS);

MessageType enum values: INFO, SUCCESS, WARNING, ERROR

---

Typical usage pattern

use RR\Request;
use RR\Response;
use RR\Flash;
use RR\ParamType;

// Controller action
function store(): void
{
    try {
        $name  = Request::requiredParam('name', ParamType::ALPHA);
        $price = Request::requiredParam('price', ParamType::DOUBLE);

        // ... save to DB ...

        Flash::addSuccess('Item created successfully.');
        Response::redirect('/items');

    } catch (\Exception $e) {
        Flash::addError('Missing required fields.');
        Response::back();
    }
}

---

License

See composer.json for author information.