PHPFUI/InstaDoc

Writes and reads values to/from an object/array graph.

author Bernhard Schussek

AbstractInterface

Public

Methods

public abstract getValue(object|array $objectOrArray, Symfony\Component\PropertyAccess\PropertyPathInterface|string $propertyPath) : ?mixed

Returns the value at the end of the property path of the object graph.

Example:

use Symfony\Component\PropertyAccess\PropertyAccess;

$propertyAccessor = PropertyAccess::createPropertyAccessor();

echo $propertyAccessor->getValue($object, 'child.name');
// equals echo $object->getChild()->getName();

This method first tries to find a public getter for each property in the
path. The name of the getter must be the camel-cased property name
prefixed with "get", "is", or "has".

If the getter does not exist, this method tries to find a public
property. The value of the property is then returned.

If none of them are found, an exception is thrown.

throws \Exception\InvalidArgumentException If the property path is invalid
throws \Exception\AccessException If a property/index does not exist or is not public
throws \Exception\UnexpectedTypeException If a value within the path is neither object
nor array

public abstract isReadable(object|array $objectOrArray, Symfony\Component\PropertyAccess\PropertyPathInterface|string $propertyPath) : bool

Returns whether a property path can be read from an object graph.

Whenever this method returns true, {@link getValue()} is guaranteed not
to throw an exception when called with the same arguments.

throws \Exception\InvalidArgumentException If the property path is invalid

public abstract isWritable(object|array $objectOrArray, Symfony\Component\PropertyAccess\PropertyPathInterface|string $propertyPath) : bool

Returns whether a value can be written at a given property path.

Whenever this method returns true, {@link setValue()} is guaranteed not
to throw an exception when called with the same arguments.

throws \Exception\InvalidArgumentException If the property path is invalid

public abstract setValue(object|array $objectOrArray, Symfony\Component\PropertyAccess\PropertyPathInterface|string $propertyPath, ?mixed $value)

Sets the value at the end of the property path of the object graph.

Example:

use Symfony\Component\PropertyAccess\PropertyAccess;

$propertyAccessor = PropertyAccess::createPropertyAccessor();

echo $propertyAccessor->setValue($object, 'child.name', 'Fabien');
// equals echo $object->getChild()->setName('Fabien');

This method first tries to find a public setter for each property in the
path. The name of the setter must be the camel-cased property name
prefixed with "set".

If the setter does not exist, this method tries to find a public
property. The value of the property is then changed.

If neither is found, an exception is thrown.

throws \Exception\InvalidArgumentException If the property path is invalid
throws \Exception\AccessException If a property/index does not exist or is not public
throws \Exception\UnexpectedTypeException If a value within the path is neither object nor array
return void