demmonico/reflection

Helpers and traits for work with class reflections

Reflection

Description

Helpers and traits for work with class reflections, _(*1)

, _(*2)

Components

ReflectionHelper

Helper for work with class reflections. Is a base of other components, _(*3)

Usage

1. Get list of class methods

ReflectionHelper::getMethods($className, $filter=null, $prefix=null);

1. Get list of class constants

ReflectionHelper::getConstants(string $className, ?string $prefix = ''): array

1. Detect type of var (array, int, string etc)

ReflectionHelper::detectVarType($var, $allowTypesArr=[], $default=null)

ConstantTrait

Handle magic calls to get array of class's constant labels or single constant label by it value, _(*4)

Usage

Sourse class, _(*5)

class Simple
{
    use ConstantTrait;

    const GROUP_TEST_ONEWORD = 1;
    const GROUP_TEST_TWO_WORDS = 2;
    const GROUP_TEST_COM_plex_LAbeL = 3;

    public function test() { return $this->constGroupTest(); }
    public function testStatic() { return static::constGroupTest(); }
    public function testSingleLabel() { return $this->constGroupTest(static::GROUP_TEST_TWO_WORDS); }

    public function testInvalidPrefix() { return $this->invalidGroupTest(); }
    public function testInvalidConstGroup() { return $this->constInvalidGroup(); }
    public function testInvalidConstValue() { return $this->constGroupTest(1000); }
}

Anywhere usage, _(*6)

$simple = new Simple;

//
// will return CORRECT results
//
$simple->test();
// or
$simple->testStatic();
// or
Simple::testStatic();
// returns array(3) { [1]=> string(7) "Oneword" [2]=> string(10) "Two Words" [3]=> string(16) "COM plex LAbe L" }

$simple->testSingleLabel();
// returns string(10) "Two Words"

//
// will throw an ERRORS
//
$simple->testInvalidPrefix();
// or
$simple->testInvalidConstGroup();
// if no parent::__call and/or parent::__callStatic exists then
//      throws Error "Call to undefined method Simple::invalidGroupTest()" or "testInvalidConstGroup"
// else
//      throws error from parent

$simple->testInvalidConstValue();
// throws Error "Invalid argument '1000' while calling Simple::constGroupTest(1000)"

So correct results (not for single call) will be like this:, _(*7)

[
    1 => "Oneword",
    2 => "Two Words",
    3 => "COM plex LAbe L",
]

For single label call - Oneword, _(*8)

Customization

Change prefix for the const getter, _(*9)

Define somewhere before call const getter:, _(*10)

static::$constMagicGetterPrefix = 'get';
...
Simple::getGroupTest();

Note: attempt to override static property like below will trigger an error, _(*11)

protected static $constMagicGetterPrefix = 'get';

Add/override constant label for get complex label formatting, _(*12)

Sourse class, _(*13)

class Simple
{
    ...
    protected static $constMagicLabels = ['GroupTest' => [3 => 'COMP-lex-LaBEL', 0 => 'Extra label']];
    ...
// or
    ...
    protected static constMagicLabels() { return ['GroupTest' => [3 => 'COMP-lex-LaBEL', 0 => 'Extra label']]; }
    ...
}

Anywhere usage, _(*14)

$simple->test();
// returns array(4) { [1]=> string(7) "Oneword" [2]=> string(10) "Two Words" [3]=> string(14) "COMP-lex-LaBEL" [0]=> string(11) "Extra label" }

So correct results in such case will be like this:, _(*15)

[
    1 => "Oneword",
    2 => "Two Words",
    3 => "COMP-lex-LaBEL",  // was replaced
    0 => "Extra label",     // was added
]

Note: you could change name of property/method of label customization via set before calling getter, _(*16)

static::$constMagicCustomLabels = 'renamedConstMagicLabels';