A library to read/write values from/to objects and arrays.
It is similar to symfony/property-access, but is built in a more lightweight way and therefore has less sophisticated syntax.
- Read properties from objects/arrays
- Write properties from objects/arrays
- Built-in support for camel-case getters and setters
- Can be extended with your own access strategies
composer require scheb/property-access
$valueObject = ...; // Array or object
$strategies = [
new \Scheb\PropertyAccess\Strategy\ArrayAccessStrategy(),
new \Scheb\PropertyAccess\Strategy\ObjectPropertyAccessStrategy(),
new \Scheb\PropertyAccess\Strategy\ObjectGetterSetterAccessStrategy(),
];
$accessor = new \Scheb\PropertyAccess\PropertyAccess($strategies);
// Returns the value or null
$accessor->getPropertyValue($valueObject, 'propertyName');
// Returns the modified value object or throws FailedSettingPropertyException
$accessor->setPropertyValue($valueObject, 'propertyName', 'newValue');
To create your own access strategies, implement Scheb\PropertyAccess\Strategy\PropertyAccessStrategyInterface
and
pass in an instance of that class to the constructor argument $propertyAccessStrategies
of
Scheb\PropertyAccess\PropertyAccess
.
You're welcome to contribute to this library by creating a pull requests or feature request in the issues section. For pull requests, please follow these guidelines:
- Symfony code style
- PHP7.1 type hints for everything (including: return types,
void
, nullable types) - Please add/update test cases
- Test methods should be named
[method]_[scenario]_[expected result]
To run the test suite install the dependencies with composer install
and then execute bin/phpunit
.
This bundle is available under the MIT license.