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
arrayArray of attributes that are passed in from the constructor, and made available in the view when a development error is displayed.
-
$_defaultCode protected
intDefault exception code
-
$_messageTemplate protected
stringTemplate string that has attributes sprintf()'ed into it.
-
$_responseHeaders protected
array|nullArray of headers to be passed to {@link \Cake\Http\Response::withHeader()}
-
$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.
-
getCode() public @method
Gets the Exception code.
-
getHeaders() public
Get the headers.
-
responseHeader() public deprecated
Get/set the response header to be used
-
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>responseHeader() ¶ public
responseHeader(array|string|null $header = null, string|null $value = null): array|nullGet/set the response header to be used
See also {@link \Cake\Http\Response::withHeader()}
Parameters
-
array|string|null$header optional A single header string or an associative array of "header name" => "header value"
-
string|null$value optional The header value.
Returns
array|nullsetHeader() ¶ public
setHeader(string $header, array<string>|string|null $value = null): voidSet a single HTTP response header.
Parameters
-
string$header Header name
-
array<string>|string|null$value optional Header value
Returns
voidsetHeaders() ¶ public
setHeaders(array<string, mixed> $headers): voidSets HTTP response headers.
Parameters
-
array<string, mixed>$headers Array of header name and value pairs.
Returns
voidProperty 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$_responseHeaders ¶ protected
Array of headers to be passed to {@link \Cake\Http\Response::withHeader()}
Type
array|null