consik/yii2-fluent

Yii2 behavior that implements fluent interface for changing component's properties

Yii2 Fluent Component Behavior

Behavior that implements fluent interface methods for component attributes., _(*1)

, _(*2)

Installation

The preferred way to install this extension is through composer., _(*3)

Either run, _(*4)

composer require consik/yii2-fluent

or add, _(*5)

"consik/yii2-fluent": "^1.0"

FluentComponentBehavior class description

Properties

• array $attributes = []

Associative or simple array of attributes that can be changed using fluent interface. For associative definition key is alias for attributes methods; Value is always component attribute name;, _(*6)

• string $initArraysIfEmpty = true

Defines need bahavior to initialize property as array if it's empty and !is_array() when calling array-access fluent methods(like add*Property*($item)), _(*7)

Public methods

Universal fluent methods for owner component, _(*8)

• $this setProperty(string $property, mixed $value)

Sets value to component property, _(*9)

• $this unsetProperty(string $property)

Unsets component property, _(*10)

• $this addItemTo(string $arrName, mixed $value, bool $initOnEmpty = true)

Adds $item to array property with name $arrName;, _(*11)

Throws exception if $component->{$arrName} is !empty() && !is_array();, _(*12)

initializes $component->{$arrName} as empty array if ($initOnEmpty && empty($component->{$arrName})) ;, _(*13)

Examples

Short definition of behavior. Behavior will implement all available fluent methods for ALL component attributes

<?php
use consik\yii2fluent\FluentComponentBehavior;

class Test extends \yii\base\Component
{
    public $isNew;
    public $comments;

    public function behaviors()
     {
         return [
            FluentComponentBehavior::className()
         ];
     }
}

Available fluent methods for this definition: * (new Test()) * ->setProperty($name, $value) * ->unsetProperty($name) * ->addItemTo($arrName, $arrayItem) * ->setIsNew($value) * ->unsetIsNew() * ->addIsNew($arrayItem) * ->setComments($value) * ->unsetComments() * ->addComments($arrayItem), _(*14)

Extended definition of behavior, for enumerated properties, with alias for one of property.

<?php
use consik\yii2fluent\FluentComponentBehavior;

class Test extends \yii\base\Component
{
    public $isNew;
    public $comments;
    public $fluentUnaccessable;

    public function behaviors()
     {
         return [
            [
                'class' => FluentComponentBehavior::className(),
                'attributes' => [
                    'new' => 'isNew',
                    'comments'
                ]
         ];
     }
}

Available fluent methods for this definition: * (new Test()) * ->setProperty($name, $value) * ->unsetProperty($name) * ->addItemTo($arrName, $arrayItem) * ->setNew($value) * ->unsetNew() * ->addNew($arrayItem) * ->setComments($value) * ->unsetComments() * ->addComments($arrayItem), _(*15)

Be helpful!

Don't forget about other developers and write comments for your classes!, _(*16)

Basic comment for all components with attached FluentInterfaceBehavior, _(*17)

@method $this setProperty(string $name, $value)
@method $this unsetProperty(string $name)
@method $this addItemTo(string $arrName, mixed $item, bool $initOnEmpty = true)

<?php
/*
 * Class YourClass
 * @method $this setProperty(string $name, $value)
 * @method $this unsetProperty(string $name)
 * @method $this addItemTo(string $arrName, mixed $item, bool $initOnEmpty = true)
 */
 class YourClass extends \yii\base\components { ... }

And, please, don't forget writing comments about defined fluent methods for your component properties!!!, _(*18)

Best regards, Sergey Poltaranin., _(*19)