Reflections

The GenericDatabase\Helpers\Reflections class provides various reflection-based methods to interact with classes and objects in PHP.

It allows you to perform tasks such as getting class instances, retrieving constants and properties, creating objects, and setting properties in a case-insensitive manner.

Example Usage:

// Get a singleton instance of a class
$instance = Reflections::getSingletonInstance(MyClass::class);

// Check if a method exists in a class
$exists = Reflections::isSingletonMethodExists(MyClass::class);

// Get a class instance
$classInstance = Reflections::getClassInstance(MyClass::class);

// Get all constants of a class
$constants = Reflections::getClassConstants(MyClass::class);

// Get the name of a constant by its value
$constantName = Reflections::getClassConstantName(MyClass::class, $constantValue);

// Get the value of a class property by its name
$propertyValue = Reflections::getClassPropertyName(MyClass::class, 'propertyName');

// Create an object and set properties in a case-insensitive manner
$object = Reflections::createObjectAndSetPropertiesCaseInsensitive(MyClass::class, $constructorArgs, $propertyList);

// Convert multiple arguments into an associative array
$argsArray = Reflections::argsToArray($arg1, $arg2, $arg3);

Main functionalities:

• Get the singleton instance of a class by calling a static method
• Check if a method exists and is static in a class
• Get a ReflectionClass instance for a class
• Get all constants defined in a class
• Get the name of a constant by its value
• Get the value of a class property by its name
• Create objects and set properties in a case-insensitive manner
• Convert multiple arguments into an associative array

Methods:

• getSingletonInstance($class): Retrieves the singleton instance of a class by calling a static method. Throws an exception if the method does not exist.
• isSingletonMethodExists($class): Checks if a method exists and is static in a class. Throws an exception if the method does not exist or is not static.
• getClassInstance($class): Returns a ReflectionClass instance for the given class.
• getClassConstants($class): Returns an array of all constants defined in the class.
• getClassConstantName($class, $field): Returns the name of a constant by its value.
• getClassPropertyName($class, $prop): Returns the value of a class property by its name.
• createObjectAndSetPropertiesCaseInsensitive($classOrObject, $constructorArgArray, $propertyList): Creates an object and sets its properties in a case-insensitive manner.
• argsToArray(...$args): Converts multiple arguments into an associative array.

Fields:

• defaultMethod: A static field that stores the default method name (getInstance) used for getting singleton instances.