macfja / value-provider
Get/Set object value with its getter/setter/property/metadata
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
This package is auto-updated.
Last update: 2024-11-17 01:22:43 UTC
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
andprivate
properties (see below for examples and restriction)
- Works with magic
- With mutator (getter/setter) (like
$myObject->getMyProperty()
and$myObject->setMyProperty('new value')
)- Works with magic
__call
(see below for examples and restriction)
- Works with magic
- 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.