PHP Luminova: HTTP Status Codes

The HttpStatus class provides HTTP status codes and their reason phrases.It is a static utility class and cannot be instantiated.

You can:

• Access all status labels via the LABELS constant
• Retrieve a label by code using get()
• Fetch a label directly using magic methods such as status200()
• isValid() protects inputs before headers are sent
• isError() avoids magic number checks (>= 400)
• phrase() gives predictable output without exceptions

Examples

Get status code

echo HttpStatus::OK // 200

Retrieve all status codes and messages:

HttpStatus::get();
// or
HttpStatus::LABELS;

Get the message for HTTP 200:

echo HttpStatus::status200(); // OK

Get the message for HTTP 503:

echo HttpStatus::status503(); // Service Unavailable

Get a message using the numeric code:

echo HttpStatus::get(400); // Bad Request

Class Definition

• Class namespace: Luminova\Http\HttpStatus
• This class is marked as final and can't be subclassed
• Instantiation: Not allowed (static access only)

Constants

HTTP Status Constants

All constants represent valid HTTP status codes and are grouped by category.Each constant maps directly to its numeric status code.

Informational (1xx)

Success (2xx)

Redirection (3xx)

Client Errors (4xx)

Server Errors (5xx)

Notes:

• Constants represent meaning, not presentation
• Labels are resolved via LABELS or helper methods
• Non-standard codes are included for real-world compatibility

LABELS

Contains all supported HTTP status codes mapped to their reason phrases.

public const LABELS = [
    200 => 'OK',
    // ...
];

Methods

isValid

Checks whether a value is within the valid HTTP status code range.

public static function isValid(int $code): bool

Parameters

Return Value:

bool Return true — if the code is between 100 and 599, false — otherwise

Example

HttpStatus::isValid(200); // true
HttpStatus::isValid(99);  // false

isError

Determines whether a status code represents an error.

A code is considered an error if it falls within:

• 4xx (client errors)
• 5xx (server errors)

public static function isError(int $code): bool

Parameters

Return Value:

bool — Return true if the code is between 400 and 599, false otherwise

Example

HttpStatus::isError(404); // true
HttpStatus::isError(503); // true
HttpStatus::isError(200); // false

phrase

Returns the HTTP status message for a given code.

If the code is not defined, the fallback value is returned.If the fallback is null, an empty string is returned.

public static function phrase(int $code, ?string $fallback = 'Invalid'): string

Parameters

Return Value:

string — Return status message or fallback value

Examples

HttpStatus::phrase(200); 
// OK

HttpStatus::phrase(999); 
// Invalid

HttpStatus::phrase(999, null); 
// ''

get

Returns a status message for a given HTTP code, or all status messages when no code is provided.

public static function get(?int $code = null): array|string|null

Parameters

Return Value:

• string — status message if the code exists
• array<int,string> — all status codes and messages if $code is null
• null — if the code is not defined

statusXXX (magic method)

Returns a status message using a magic static call.

Method name format:

status + HTTP code

Example:

HttpStatus::status404();

Signature

public static function statusXXX(): ?string

Return Value:

• string — status message
• null — if the status code is not defined