Http Helpers

The package exposes a small helper layer in Quantum\Http\Helpers\http.php.

request()

function request(): Request

Behavior:

1. checks whether Request::class is registered in DI
2. registers it if missing
3. returns Di::get(Request::class)

That means every caller in the same container receives the same Request instance.

response()

function response(): Response

Behavior mirrors request() and returns the shared Response instance for the current container.

URL helpers

base_url(bool $withModulePrefix = false): string

This is a thin proxy to request()->getBaseUrl(...).

current_url(): string

This proxies request()->getCurrentUrl().

Redirect helpers

redirect(string $url, int $code = StatusCode::FOUND): Response

This returns response()->redirect($url, $code).

Because it returns the response object, callers can continue mutating headers or body state afterward.

redirectWith(string $url, array $data, int $code = StatusCode::FOUND): Response

This helper stores $data into the session under ReservedKeys::PREV_REQUEST and then returns a redirect response.

The helper overwrites any previous value already stored under that session key.

back(array $data = [], int $code = StatusCode::FOUND): Response

This returns response()->back($data, $code). It is the shorter form of redirect(get_referrer() ?? base_url()):

return back();

return back($request->all());

The rules for where it redirects, and how the old input is kept, are on Redirecting back.

Old input helper

old(string $key)

old() reads one key from the session entry created by redirectWith() or back().

Behavior is intentionally consumptive:

1. if the session key does not exist, returns null
2. if the stored value is not an array or the requested key is missing, returns null
3. otherwise reads the value
4. removes that one key from the stored session array
5. writes the reduced array back into the session
6. returns the value

Practical effect:

• old('email') can only return the same stored key once unless something writes it again
• consuming one key leaves the other old-input keys in place

Referrer helper

get_referrer(): ?string

This is a thin proxy to request()->getReferrer().

page_not_found_response()

function page_not_found_response(?Request $request = null): Response

When a request matches no route, Quantum answers with this helper, and you can call it yourself, for example when a record in a route does not exist:

$post = $this->postService->getPost($uuid);

if ($post->isEmpty()) {
    return page_not_found_response();
}

A browser gets your HTML error page, rendered from partial('errors' . DS . StatusCode::NOT_FOUND). A client that wants JSON, decided by Request::expectsJson(), gets:

{"status": "error", "message": "Page not found"}

Both return status code 404. Without an argument the helper checks the current request(); pass a Request to check that one instead.