[WIP] New method linkSync to update junction tables

[alex-code]

Allow junction tables to be updated via the relation.

$model-id	other-id
1	1
1	2
1	3
1	4

$model->linkSync('relation', [1, 2, 5, 6]);
This would remove the relation to 3 & 4 and insert new relations to 5 & 6.
Based this off laravel->sync() from an article I read.

This is more of a demo to get some thoughts as it would need updating to support relations more strongly.

[githubjeka]

A good method. I often use it.
Need tests!

[alex-code]

Need to write some tests but should support composite keys now.

The method can take either an array of foreign key ids or an array of foreign models.

e.g.
Using Html::checkboxList you could do,
$model->linkSync('relation', \Yii::$app->request->post((new OtherModel)->formName(), []));
or
$model->linkSync('relation', OtherModel::findAll(\Yii::$app->request->post((new OtherModel)->formName(), [])))

Thoughts?

[Faryshta]

Very good, what is needed for integration?

[samdark]

Tests, docs.

[Faryshta]

@samdark the name of the method is ok? I think setRelation or syncRelation are easier to understand.

@alex-code can I change the function signature to add $columns = [] and $delete = false ?

[samdark]

No, method name is not OK. Totally confusing.

[Faryshta]

@samdark which method name would you prefer?

[samdark]

Something like updateLink. "link" is OK because we have link and unlink methods.

[alex-code]

@Faryshta Please do make changes, I put this up so it can be improved and expanded.

[Faryshta]

@samdark I was thinking more along the lines of setRelation since we already have a getRelation method.

[samdark]

It's not really about relations. It's about junction table...

[alex-code]

Maybe linkMultiple, I don't think setRelation says enough about what the function would do.

[yii-bot]

Thank you for putting effort in the improvement of the Yii framework.
We have reviewed your pull request.

In order for the framework and your solution to remain stable in the future, we have a unit test requirement in place. Therefore we can only accept your pull request if it is covered by unit tests.

Could you add these please?

Thanks!

P.S. If you have any questions about the creation of unit tests? Don't hesitate to ask for support. More information about unit tests

This is an automated comment, triggered by adding the label pr:request for unit tests.

[samdark]

Won't make it into 2.0.