jfadich/json-property

Transform an object property into an enhanced array

, _(*1)

JsonProperty

JsonProperty provides a simple interface for storing key/value pairs to a single column on a model. This is useful for storing meta data or anything without a standard structure. The data is automatically serialized to a JSON when saving., _(*2)

Installation

Use composer to install the package, _(*3)

composer require jfadich/json-property, _(*4)

Requirements

• PHP >= 5.5.9

Configuration

1. Add the JsonPropertyTrait trait to the model
2. Set the jsonProperty property. This is the name of the method that will be called to access the JsonProperty object. You can set this to an array to enable multiple properties on a single model.

    namespace App;

    use Jfadich\JsonProperty\JsonPropertyTrait;
    use Jfadich\JsonProperty\JsonPropertyInterface;

    class SampleModel implements JsonPropertyInterface
    {
        use JsonPropertyTrait;
        protected $jsonProperty = 'meta';
    }

Usage

Call a method on the model named after the values you set to $jsonProperty to access the data stored in the JSON string, _(*5)

$model = new SampleModel();

$model->meta()->set('key', 'value');
$value = $model->meta()->get('key'); // 'value'
$value = $model->meta('key'); // 'value'

Available Methods

has($key), _(*6)

Checks if there is a value for the given key, _(*7)

if($model->meta()->has('keyName')) {
    // Do something
}

get( $key, $default = null ), _(*8)

Get a value, or default if it is not present in the array. You can use the dot notation to access nested arrays., _(*9)

set($key, $value), _(*10)

Set/Update the given key/value pair., _(*11)

merge( array $values, array $allowedKeys = [] ), _(*12)

Merge the given array into the saved object. This will not add keys that don't exist in original object unless the key is included in the whitelist., _(*13)

push( $key, $value ), _(*14)

If the value for the given $key is an array the value will be pushed to the array., _(*15)

forget($key), _(*16)

Remove element from array. This will automatically be persisted, _(*17)

all(), _(*18)

Get all the elements from the array, _(*19)

Examples

The property on the object will always be an up to date JSON string so you can use what ever persistance method you choose., _(*20)

$model = new SampleModel();

// Use dot notation to access nested values
$model->meta()->set('book.title', 'Cracking the Coding Interview');
$model->meta()->set('book.author', 'Gayle Laakmann McDowell');

// $model->meta
// { "book":{"title": "Cracking the Coding Interview", "author": "Gayle Laakmann McDowell"} }
//
// $model->meta()->all()
// array:3 [
//   "book" => array:2 [
//     "title" => "Cracking the Coding Interview"
//     "author" => "Gayle Laakmann McDowell"
//   ]
// ]

Customization

The JsonProperty object keeps the property on the model up to date with the current JSON string. If you want to automatically persist the data on update feel free to override the saveJsonString() method on the model., _(*21)

public function saveJsonString($property, $jsonString)
{
    parent::saveJsonString($property, $jsonString);

    $this->saveToSQL(); // Persist to the database or any other method
}