When using this method, all entities in $targetEntities will be appended to
the source entity's property corresponding to this association object.
This method does not check link uniqueness.
### Example:
$newTags = $tags->find('relevant')->toArray();
$articles->association('tags')->link($article, $newTags);
$article->get('tags') will contain all tags in $newTags after liking
| public link ( Cake\Datasource\EntityInterface $sourceEntity, array $targetEntities, array $options = [] ) : boolean | ||
| $sourceEntity | Cake\Datasource\EntityInterface | the row belonging to the `source` side of this association |
| $targetEntities | array | list of entities belonging to the `target` side of this association |
| $options | array | list of options to be passed to the internal `save` call |
| Résultat | boolean | true on success, false otherwise |
/**
* Tests that liking entities will validate data and pass on to _saveLinks
*
* @return void
*/
public function testLinkSuccess()
{
$connection = ConnectionManager::get('test');
$joint = $this->getMockBuilder('\\Cake\\ORM\\Table')->setMethods(['save'])->setConstructorArgs([['alias' => 'ArticlesTags', 'connection' => $connection]])->getMock();
$config = ['sourceTable' => $this->article, 'targetTable' => $this->tag, 'through' => $joint, 'joinTable' => 'tags_articles'];
$assoc = new BelongsToMany('Test', $config);
$opts = ['markNew' => false];
$entity = new Entity(['id' => 1], $opts);
$tags = [new Entity(['id' => 2], $opts), new Entity(['id' => 3], $opts)];
$saveOptions = ['foo' => 'bar'];
$joint->expects($this->at(0))->method('save')->will($this->returnCallback(function ($e, $opts) use($entity) {
$expected = ['article_id' => 1, 'tag_id' => 2];
$this->assertEquals($expected, $e->toArray());
$this->assertEquals(['foo' => 'bar'], $opts);
$this->assertTrue($e->isNew());
return $entity;
}));
$joint->expects($this->at(1))->method('save')->will($this->returnCallback(function ($e, $opts) use($entity) {
$expected = ['article_id' => 1, 'tag_id' => 3];
$this->assertEquals($expected, $e->toArray());
$this->assertEquals(['foo' => 'bar'], $opts);
$this->assertTrue($e->isNew());
return $entity;
}));
$this->assertTrue($assoc->link($entity, $tags, $saveOptions));
$this->assertSame($entity->test, $tags);
}
