final class RequestContextResolver (View source)

Resolves client identity and external request origin across one explicit proxy trust boundary.

Constants

private MAX_FORWARDED_HEADER_LENGTH

private MAX_PROXY_HOPS

private MAX_PREFIX_LENGTH

Methods

Binds request metadata resolution to validated server trust configuration.

resolve(ServerRequestInterface $request)

Produces a fail-closed context without consulting global server state.

Details

__construct

__construct(HttpServerConfig $config, TrustedProxyMatcher $trustedProxies)

Binds request metadata resolution to validated server trust configuration.

Parameters

HttpServerConfig $config
TrustedProxyMatcher $trustedProxies

resolve

ResolvedRequestContext resolve(ServerRequestInterface $request)

Produces a fail-closed context without consulting global server state.

Parameters

ServerRequestInterface $request

Return Value

ResolvedRequestContext

Exceptions

InvalidRequestMetadataException