RequestContext

in package

• ZealPHP

Per-request state container. Lives on Coroutine::getContext() in coroutine mode (recommended default) so each request gets isolated state freed automatically when the coroutine ends. In legacy superglobals mode it's a process-wide singleton bridging declared properties to PHP's $_GET / $_POST / $_SESSION etc.

Table of Contents

Properties

$_session_started  : bool|null

$_streaming  : bool|null

$apacheContext  : ApacheContext|null

$cache_expire  : int|null

$cache_limiter  : string|null

$cookie  : array<string, mixed>

$error_exception  : Throwable|null

$error_handlers_stack  : array<int, array{0: callable, 1: int}>

$error_render_depth  : int

$error_reporting_level  : int|null

$error_status  : int|null

$exception_handlers_stack  : array<int, callable>

$files  : array<string, mixed>

$get  : array<string, mixed>

$ignore_user_abort_state  : int

$memo  : array<string, mixed>

$openswoole_request  : Request|null

$openswoole_response  : Response|null

$post  : array<string, mixed>

$request  : array<string, mixed>

$server  : array<string, scalar|null>

$session  : array<string, mixed>

$session_loaded_keys  : array<int, string>

Keys present in $g->session at session-load time. Lets zeal_session_write_close() distinguish an in-request unset() (key was loaded then removed → must be deleted from the store) from a concurrent add (key never loaded here → must be preserved through the merge). #21.

$session_module_name  : string|null

$session_params  : array<string, mixed>

$shutdown_functions  : array<int, array{0: callable, 1: array}>

$status  : int|null

$zealphp_request  : Request|null

$zealphp_response  : Response|null

$instance  : self|null

Methods

__get()  : mixed

Read by reference is only required in superglobals mode, where the proxy must hand back $GLOBALS['_SESSION'] etc. so legacy code that mutates $_SESSION['k'] = $v carries the write through. In coroutine mode (recommended default) all reads go through the typed properties declared above; returning by value avoids the autovivification footgun where &$g->nonexistent would create a property on first read.

__set()  : mixed

__set fires for undeclared properties AND for declared typed properties that have been unset() (the slot is "uninitialized" so direct access routes through __set on assignment). In superglobals mode we keep the legacy bridge to $GLOBALS[$key] so pre-coroutine code that stashed values via $g->custom = $val keeps working. In coroutine mode the typed properties are the contract; we re-initialize the declared slot (preserves PHP's type-check via direct property assignment) and reject any other write loudly so typos still surface.

forget()  : void

Discard the memoized value for $key in this request. The next once() call with the same key will recompute.

get()  : mixed

has()  : bool

True if once($key, ...) has been computed in this request.

instance()  : self

once()  : mixed

Compute once per request, cache for the rest of the request.

set()  : void

__construct()  : mixed

$user = RequestContext::once('current_user', fn() => Auth::loadUser($id));