PHP Luminova: Exceptions and Error Codes

This guide explains Luminova’s exception codes, their severity levels, and how to use them effectively.All error codes are now defined as constants in the Luminova\Exceptions\Code class. These codes represent different categories of errors, including:

• PDO SQLSTATE errors
• MySQL errors
• PostgreSQL errors
• Custom application errors

Using Error Codes

You can pass an error code when throwing exceptions.

use Luminova\Exceptions\Code;
use Luminova\Exceptions\RuntimeException;

throw new RuntimeException('Error message', Code::BAD_METHOD_CALL);

getName

Get a Human-Friendly Error Name

Translate internal error codes into descriptive names that are easier to understand.

use Luminova\Exceptions\Code;

echo Code::getName(Code::INPUT_VALIDATION_ERROR);

// Output: Validation Error

You can also ask for a longer description:

use Luminova\Exceptions\Code;

echo Code::getName(Code::INPUT_VALIDATION_ERROR, true);
// Output: Input validation failed

This is especially helpful when displaying error messages to developers or when logging meaningful details.

has

Check if a given error code is defined in the Code class.

use Luminova\Exceptions\Code;

Code::has(Code::ERROR);

Constants

All error codes are centralized in the Code class.Reference them directly whenever you need to identify or classify an error:

Luminova\Exceptions\Code::ERROR

PHP Error Codes

These constants map directly to standard PHP error types. You can use them for handling, logging, or categorizing errors in your application.

Database Error Codes

PDO SQLSTATE Codes

These constants map to SQLSTATE error codes used by PDO. They help you detect and handle database connection problems or SQL execution errors more precisely.

MySQL Error Codes

These constants correspond to common MySQL error codes. They allow you to handle database issues specific to MySQL, such as duplicate entries, missing tables, or connection problems.

PostgreSQL Error Codes

These constants represent PostgreSQL-specific error codes. They are useful when handling authentication errors, missing databases, or other PostgreSQL issues.

SQLite Error Codes

These constants represent SQLite-specific error codes. They are useful when handling storage, locking, or database file issues.

Custom Luminova Error Codes

These constants are unique to the Luminova framework. They provide a standardized way to represent application-specific errors that go beyond PHP or database engine codes. You can use them to handle issues such as database failures, validation problems, or other framework-level exceptions in a consistent way.