README

简单访问器特性

• 变更日志

特性

• 获取器
• 设置器
• 访问器：获取器 + 设置器

基本用法

use b2r\Component\SimpleAccessor\Accessor;

class Foo
{
    use Accessor;

    private $value = 0;

    public function getSquare()
    {
        return $this->value * $this->value;
    }

    public function setValue($value)
    {
        $this->value = (int)$value;
    }
}

$foo = new Foo();
$foo->value = '10'; // Invoke `setValue()`
var_dump($foo->value); #=>int(10)
var_dump($foo->square); #=>int(100) Invoke `getSquare()`

//$foo->undefined = 'Undefined'; #=> throw b2r\Component\Exception\InvalidPropertyException

Getter::getPropertyValue

获取器核心方法

protected function getPropertyValue($name, array $options = null)

$options = [
    'default'  => null,    # Undefined property default value
    'prefixes' => ['get'], # Getter method prefixes
    'read'     => true,    # Read private/protected property?
    'strict'   => true,    # Thorw exception?
]

Setter::setPropertyValue

设置器核心方法

protected function setPropertyValue($name, $value, array $options = null)

$options = [
    'create'    => false,   # Create undefined property?
    'immutable' => false,   # Immutable?
    'prefixes'  => ['set'], # Setter method prefixes
    'update'    => false,   # Update private/protected property?
    'strict'    => true,    # Thorw exception?
]

更多示例

宽松

不抛出异常

use b2r\Component\SimpleAccessor\Accessor;

class Foo
{
    use Accessor;

    private $value = 0;

    public function __get($name)
    {
        return $this->getPropertyValue($name, [
            'strict'  => false,
            'default' => 'Default value for undefined property'
        ]);
    }
}

$foo = new Foo();
var_dump($foo->undefined); #=>"Default value for undefined property"

不可变

不可变（只写一次）

use b2r\Component\SimpleAccessor\Accessor;

class Foo
{
    use Accessor;

    private $value = 0;

    public function __set($name, $value)
    {
        return $this->setPropertyValue($name, $value, ['immutable' => true]);
    }

    protected function setValue($value)
    {
        $this->value = (int)$value;
    }
}

$foo = new Foo();
$foo->value = '10'; # Invoke `setValue()`
var_dump($foo->value); #=>int(10)
$foo->value = 100; #=>b2r\Component\Exception\InvalidPropertyException: Invalid property Foo::$value is immutable