macfja/value-provider

Get/Set object value with its getter/setter/property/metadata

v0.3.1 2016-02-19 20:46 UTC

Requires (Dev)

• doctrine/orm: ^2.5
• phpunit/phpunit: ^5.2
• sebastian/phpcpd: ^2.0
• squizlabs/php_codesniffer: ^2.5

Suggests

• doctrine/orm: For Metadata value provider

MIT

• MacFJA

• metadata
• doctrine
• access
• provider
• value
• mutator
• property
• getter
• setter

README

ValueProvider allow you to access to your object's property value without knowing the way the object have defined to do so. Property, getter/setter? Let's GuessProvider take care of this.

Features

Can access to object's properties values:

• With direct property access (like $myObject->myProperty)
  • Works with magic __get and __set (see below for examples and restriction)
  • Works with protected and private properties (see below for examples and restriction)
• With mutator (getter/setter) (like $myObject->getMyProperty() and $myObject->setMyProperty('new value'))
  • Works with magic __call (see below for examples and restriction)
• With doctrine Metadata (see below for examples)

Installation

Composer

composer require macfja/value-provider

Examples

Property Access

Class Person

class Person {
    public $firstName = '';
    public $lastName = '';
}

Somewhere in your code

$jdoe = new Person();
$provider = new PropertyProvider();

// ...

$provider->setValue($jdoe, 'firstName', 'John');
$provider->setValue($jdoe, 'lastName', 'Doe');

// ...

echo 'Hello ' . $provider->getValue($jdoe, 'firstName') . ' ' . $provider->getValue($jdoe, 'lastName');
//Output : "Hello John Doe"

Notice

The properties have to be public to be accessed. (For protected and private properties, see ReflectorProvider)

Magic __get and __set properties access

Class Person

class Person {
    private $_firstName = 'John';
    private $_lastName = 'Doe';

    function __get($name) {
        if (in_array($name, array('firstName', 'lastName')) {
            $propertyName = '_' . $name;
            return $this->$propertyName;
        }

        throw new \BadFunctionCallException;
    }

    function __set($name, $value) {
        if (in_array($name, array('firstName', 'lastName')) {
            $propertyName = '_' . $name;
            $this->$propertyName = $value;
            return;
        }

        throw new \BadFunctionCallException;
    }

    function __isset($name) {
        return in_array($name, array('firstName', 'lastName');
    }
}

Somewhere in your code

$jdoe = new Person();
$provider = new PropertyProvider();

// ...

$provider->setValue($jdoe, 'firstName', 'John');
$provider->setValue($jdoe, 'lastName', 'Doe');

// ...

echo 'Hello ' . $provider->getValue($jdoe, 'firstName') . ' ' . $provider->getValue($jdoe, 'lastName');
//Output : "Hello John Doe"

Notice

The class rely on the __isset function to know if the property can be used with __get and __set

Mutator Access (getter/setter)

Class Person

class Person {
    private $_firstName = '';
    private $_lastName = '';
    private $_known = true;

    public function getFirstName() {
        return $this->_firstName;
    }
    public function setFirstName($value) {
        $this->_firstName = $value;
    }
    public function getLastName() {
        return $this->_lastName;
    }
    public function setLastName($value) {
        $this->_firstName = $value;
    }
    public function isKnown() {
        return $this->_known;
    }
    public function setKnown($flag) {
        $this->_known = $flag;
    }
}

Somewhere in your code

$jdoe = new Person();
$provider = new MutatorProvider();

// ...

$provider->setValue($jdoe, 'firstName', 'John');
$provider->setValue($jdoe, 'lastName', 'Doe');
$provider->setValue($jdoe, 'known', false);

// ...

echo 'Hello ' . $provider->getValue($jdoe, 'firstName') . ' ' . $provider->getValue($jdoe, 'lastName');
echo ', you are ' . ($provider->getValue($jdoe, 'known') ? '' : 'un') . 'known';
//Output : "Hello John Doe, you are unknown"

Notice

The mutator have to be public to be accessed. Getter are search in this order

• getMyProperty
• isMyProperty

Magic __call mutator access

Class Person

class Person {
    private $_firstName = 'John';
    private $_lastName = 'Doe';
    private $_known = true;

    function __call($name, $arguments) {
        switch ($name) {
            case 'getFirstName':
                return $this->_firstName;
            case 'getLastName':
                return $this->_lastName;
            case 'isKnown':
                return $this->_known;
            case 'setFirstName':
                $this->_firstName = $argument[0];
                return;
            case 'setLastName':
                $this->_lastName = $argument[0];
                return;
            case 'setKnown':
                $this->_known = $argument[0];
                return;
        }

        throw new \BadFunctionCallException;
    }
}

Somewhere in your code

$jdoe = new Person();
$provider = new MutatorProvider();

// ...

$provider->setValue($jdoe, 'firstName', 'John');
$provider->setValue($jdoe, 'lastName', 'Doe');
$provider->setValue($jdoe, 'known', false);

// ...

echo 'Hello ' . $provider->getValue($jdoe, 'firstName') . ' ' . $provider->getValue($jdoe, 'lastName');
echo ', you are ' . ($provider->getValue($jdoe, 'known') ? '' : 'un') . 'known';
//Output : "Hello John Doe, you are unknown"

Notice

The class rely on the implementation of the __call function: the function MUST throw either \BadFunctionCallException or \InvalidArgumentException if the getter/setter doesn't exist

Doctrine Metadata

Somewhere in your code

/** @type EntityManager $entityManager */
$class = 'MyClass';
$id = 1234;

$provider = new MetadataProvider();
MetadataProvider::setEntityManager($entityManager);

jdoe = $entityManager->find($class, $id);

// ...

$provider->setValue($jdoe, 'firstName', 'John');
$provider->setValue($jdoe, 'lastName', 'Doe');
$provider->setValue($jdoe, 'known', false);

// ...

echo 'Hello ' . $provider->getValue($jdoe, 'firstName') . ' ' . $provider->getValue($jdoe, 'lastName');
echo ', you are ' . ($provider->getValue($jdoe, 'known') ? '' : 'un') . 'known';
//Output : "Hello John Doe, you are unknown"

Notice

You have to set the Doctrine EntityManager to the MetadataProvider

ReflectorProvider

Class Person

class Person {
    public $firstName = 'John';
    protected $lastName = 'Doe';
    private $known = true;
}

Somewhere in your code

$jdoe = new Person();
$provider = new ReflectorProvider();

// ...

$provider->setValue($jdoe, 'firstName', 'John');
$provider->setValue($jdoe, 'lastName', 'Doe');
$provider->setValue($jdoe, 'known', false);

// ...

echo 'Hello ' . $provider->getValue($jdoe, 'firstName') . ' ' . $provider->getValue($jdoe, 'lastName');
echo ', you are ' . ($provider->getValue($jdoe, 'known') ? '' : 'un') . 'known';
//Output : "Hello John Doe, you are unknown"

Notice

The class can access to private/protected property if you are running PHP 5.3 or newer

GuessProvider

This class try to access to the value with mutator or property or reflection. It first try the mutator, if not success then try the property, and finish by trying with reflector.

ChainProvider

This class allow you to try through multiple Provider. For instance, the GuessProvider is based on the ChainProvider.

Information

This library respect PSR-1, PSR-2, PSR-4. It have PHPUnit tests for each provider.