codekandis/constants-classes-translator

`codekandis/constants-classes-translator` is a library to translate values from constants classes into values of another constants classes.

2.0.0 2025-09-26 08:22 UTC

Requires

• php: >=8.4
• codekandis/toolkit: ^1.0.0
• codekandis/types: ^1.0.0

Requires (Dev)

• codekandis/phpunit: ^5.0.0
• rector/rector: ^1.2.10
• roave/security-advisories: dev-master

MIT

• Christian Ramelow

• php
• class
• translator
• classes
• constant
• constants

README

codekandis/constants-classes-translator is a library to translate values from constants classes into values of another constants classes.

Index

• Installation
• Testing
• How to use
• Exceptions

Installation

Install the latest version with

$ composer require codekandis/constants-classes-translator

Testing

Test the code with

$ composer run-script test

If you want to retrieve a full coverage report run

$ composer run-script test-coverage

How to use

This example demonstrates how to simply translate between error codes and error messages.

First create interfaces or classes containing identical named constants representing error codes and error messages.

interface ErrorCodesInterface
{
    public const int ERROR_ONE   = 1;
    public const int ERROR_TWO   = 2;
    public const int ERROR_THREE = 3;
}

class ErrorMessages
{
    public const string ERROR_ONE   = 'Error one occurred.';
    public const string ERROR_TWO   = 'Error two occurred.';
    public const string ERROR_THREE = 'Error three occurred.';
}

Next translate error codes into error messages.

new ConstantsClassesTranslator( ErrorCodesInterface::class, ErrorMessages::class )
    ->translate( ErrorCodesInterface::ERROR_TWO );
/**
 * Error two occured.
 */

Or translate error messages into error codes.

new ConstantsClassesTranslator( ErrorMessages::class, ErrorCodesInterface::class )
    ->translate( ErrorMessages::ERROR_TWO );
/**
 * 2
 */

Exceptions

The ConstantsClassesTranslator throws several exceptions.

• InterfaceOrClassNotFoundException a passed constants interface or class does not exist
• InterfaceOrClassConstantNotFoundException a constant of a specific interface or class does not exist
• InterfaceOrClassConstantValueNotFoundException a constant with a specific value of a specific interface or class does not exist