Class AuthenticationRequiredException
An exception for stateless authenticators when credentials are wrong/missing.
Unlike UnauthenticatedException
this class can carry authentication challenge headers.
and is used by stateless authenticators.
Property Summary
-
$_attributes protected
array
Array of attributes that are passed in from the constructor, and made available in the view when a development error is displayed.
-
$_defaultCode protected
int
Default exception code
-
$_messageTemplate protected
string
Template string that has attributes sprintf()'ed into it.
-
$body protected
string
-
$headers protected
array<string, mixed>
Method Summary
-
__construct() public
Constructor
-
getAttributes() public
Get the passed in attributes
-
getBody() public
Get the body.
-
getHeaders() public
Get the headers.
-
setHeader() public
Set a single HTTP response header.
-
setHeaders() public
Sets HTTP response headers.
Method Detail
__construct() ¶ public
__construct(array $headers, string $body = '', int $code = 401)
Constructor
Allows you to create exceptions that are treated as framework errors and disabled when debug mode is off.
Parameters
-
array
$headers The headers that should be sent in the unauthorized challenge response.
-
string
$body optional The response body that should be sent in the challenge response.
-
int
$code optional The exception code that will be used as a HTTP status code
getHeaders() ¶ public
getHeaders(): array<string, mixed>
Get the headers.
Returns
array<string, mixed>
setHeader() ¶ public
setHeader(string $header, list<string>|string|null $value = null): void
Set a single HTTP response header.
Parameters
-
string
$header Header name
-
list<string>|string|null
$value optional Header value
Returns
void
setHeaders() ¶ public
setHeaders(array<string, mixed> $headers): void
Sets HTTP response headers.
Parameters
-
array<string, mixed>
$headers Array of header name and value pairs.
Returns
void
Property Detail
$_attributes ¶ protected
Array of attributes that are passed in from the constructor, and made available in the view when a development error is displayed.
Type
array