mits87/eloquent-nested-attributes

Nested attributes allow you to save attributes on associated records through the parent. By default nested attribute updating is turned off and you can enable it using the $nested attribute. When you enable nested attributes an attribute writer is defined on the model.

eloquent-nested-attributes

![Software License][ico-license] ![Total Downloads][ico-downloads], _(*1)

Nested attributes allow you to save attributes on associated records through the parent. By default nested attribute updating is turned off and you can enable it using the $nested attribute. When you enable nested attributes an attribute writer is defined on the model., _(*2)

Structure

If any of the following are applicable to your project, then the directory structure should follow industry best practises by being named the following., _(*3)

src/
tests/
vendor/

Install

Via Composer, _(*4)

``` bash $ composer require mits87/eloquent-nested-attributes, <sub>(*5)</sub>

## Usage

``` php
namespace App;

use Eloquent\NestedAttributes\Model;

class Post extends Model
{
    protected $fillable = ['title'];

    protected $nested = ['option', 'comments'];

    public function option() {
        //it can be also morphOne
        return $this->hasOne('App\Option');
    }

    public function comments() {
        //it can be also morphMany
        return $this->hasMany('App\Comment');
    }
}

or, <sub>(*6)</sub>

``` php namespace App;, <sub>(*7)</sub>

use Illuminate\Database\Eloquent\Model; use Eloquent\NestedAttributes\Traits\HasNestedAttributesTrait;, <sub>(*8)</sub>

class Post extends Model { use HasNestedAttributesTrait;, <sub>(*9)</sub>

...

}, <sub>(*10)</sub>

usage:

``` php
\App\Post::create([
    'title' => 'Some text',

    'option' => [
        'info' => 'some info'
    ],

    'comments' => [
        [
            'text' => 'Comment 1'
        ], [
            'text' => 'Comment 2'
        ],
    ]
]);


\App\Post::findOrFail(1)->update([
    'title' => 'Better text',

    'option' => [
        'info' => 'better info'
    ],

    'comments' => [
        [
            'id' => 2,
            'text' => 'Comment 2'
        ],
    ]
]);

to delete nested row you should pass _destroy attribute:, <sub>(*11)</sub>

``` php \App\Post::findOrFail(1)->update([ 'title' => 'Better text',, <sub>(*12)</sub>

'option' => [
    'info' => 'better info'
],

'comments' => [
    [
        'id' => 2,
        '_destroy' => true
    ],
]

]);, <sub>(*13)</sub>

## Change log

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

## Testing

``` bash
$ composer test

Contributing

Please see CONTRIBUTING and CODE_OF_CONDUCT for details., <sub>(*14)</sub>

Security

If you discover any security related issues, please email mits87@gmail.com instead of using the issue tracker., <sub>(*15)</sub>

Credits

• Piotr Krajewski
• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*16)</sub>