|
1
|
|
|
<?php |
|
2
|
|
|
|
|
3
|
|
|
declare(strict_types=1); |
|
4
|
|
|
|
|
5
|
|
|
namespace Cycle\Annotated\Annotation\Relation; |
|
6
|
|
|
|
|
7
|
|
|
use Cycle\Annotated\Annotation\Relation\Traits\InverseTrait; |
|
8
|
|
|
use Doctrine\Common\Annotations\Annotation\Enum; |
|
9
|
|
|
use JetBrains\PhpStorm\ExpectedValues; |
|
10
|
|
|
use Spiral\Attributes\NamedArgumentConstructor; |
|
11
|
|
|
|
|
12
|
|
|
/** |
|
13
|
|
|
* @Annotation |
|
14
|
|
|
* @NamedArgumentConstructor |
|
15
|
|
|
* @Target("PROPERTY") |
|
16
|
|
|
*/ |
|
17
|
|
|
#[\Attribute(\Attribute::TARGET_PROPERTY), NamedArgumentConstructor] |
|
18
|
|
|
final class ManyToMany extends Relation |
|
19
|
|
|
{ |
|
20
|
|
|
use InverseTrait; |
|
21
|
|
|
|
|
22
|
|
|
protected const TYPE = 'manyToMany'; |
|
23
|
|
|
|
|
24
|
|
|
/** |
|
25
|
|
|
* @param non-empty-string $target |
|
|
|
|
|
|
26
|
|
|
* @param array|non-empty-string|null $innerKey Inner key name in source entity. Defaults to a primary key. |
|
27
|
|
|
* @param array|non-empty-string|null $outerKey Outer key name in target entity. Defaults to a primary key. |
|
28
|
|
|
* @param array|non-empty-string|null $throughInnerKey Key name connected to the innerKey of source entity. |
|
29
|
|
|
* Defaults to `{sourceRole}_{innerKey}`. |
|
30
|
|
|
* @param array|non-empty-string|null $throughOuterKey Key name connected to the outerKey of a related entity. |
|
31
|
|
|
* Defaults to `{targetRole}_{outerKey}`. |
|
32
|
|
|
* @param bool $cascade Automatically save related data with parent entity. |
|
33
|
|
|
* @param bool $nullable Defines if the relation can be nullable (child can have no parent). |
|
34
|
|
|
* @param array $where Where conditions applied to a related entity. |
|
35
|
|
|
* @param array $orderBy Additional sorting rules. |
|
36
|
|
|
* @param class-string|non-empty-string|null $through Pivot entity. |
|
37
|
|
|
* @param array $throughWhere Where conditions applied to `through` entity. |
|
38
|
|
|
* @param bool $fkCreate Set to true to automatically create FK on thoughInnerKey and thoughOuterKey. |
|
39
|
|
|
* @param non-empty-string|null $fkAction FK onDelete and onUpdate action. |
|
40
|
|
|
* @param non-empty-string|null $fkOnDelete FK onDelete action. It has higher priority than {@see $fkAction}. |
|
41
|
|
|
* Defaults to {@see $fkAction}. |
|
42
|
|
|
* @param bool $indexCreate Create index on [thoughInnerKey, thoughOuterKey]. |
|
43
|
|
|
* @param non-empty-string|null $collection Collection that will contain loaded entities. |
|
44
|
|
|
* @param non-empty-string $load Relation load approach. |
|
45
|
|
|
*/ |
|
46
|
568 |
|
public function __construct( |
|
47
|
|
|
string $target, |
|
48
|
|
|
protected array|string|null $innerKey = null, |
|
49
|
|
|
protected array|string|null $outerKey = null, |
|
50
|
|
|
protected array|string|null $throughInnerKey = null, |
|
51
|
|
|
protected array|string|null $throughOuterKey = null, |
|
52
|
|
|
protected bool $cascade = true, |
|
53
|
|
|
protected bool $nullable = false, |
|
54
|
|
|
protected array $where = [], |
|
55
|
|
|
protected array $orderBy = [], |
|
56
|
|
|
protected ?string $through = null, |
|
57
|
|
|
protected array $throughWhere = [], |
|
58
|
|
|
protected bool $fkCreate = true, |
|
59
|
|
|
/** |
|
60
|
|
|
* @Enum({"NO ACTION", "CASCADE", "SET NULL"}) |
|
61
|
|
|
*/ |
|
62
|
|
|
#[ExpectedValues(values: ['NO ACTION', 'CASCADE', 'SET NULL'])] |
|
63
|
|
|
protected ?string $fkAction = 'CASCADE', |
|
64
|
|
|
/** |
|
65
|
|
|
* @Enum({"NO ACTION", "CASCADE", "SET NULL"}) |
|
66
|
|
|
*/ |
|
67
|
|
|
#[ExpectedValues(values: ['NO ACTION', 'CASCADE', 'SET NULL'])] |
|
68
|
|
|
protected ?string $fkOnDelete = null, |
|
69
|
|
|
protected bool $indexCreate = true, |
|
70
|
|
|
protected ?string $collection = null, |
|
71
|
|
|
#[ExpectedValues(values: ['lazy', 'eager'])] |
|
72
|
|
|
string $load = 'lazy', |
|
73
|
|
|
?Inverse $inverse = null, |
|
74
|
|
|
/** @deprecated */ |
|
75
|
|
|
protected ?string $though = null, |
|
76
|
|
|
/** @deprecated */ |
|
77
|
|
|
protected array|string|null $thoughInnerKey = null, |
|
78
|
|
|
/** @deprecated */ |
|
79
|
|
|
protected array|string|null $thoughOuterKey = null, |
|
80
|
|
|
/** @deprecated */ |
|
81
|
|
|
protected array|null $thoughWhere = [], |
|
82
|
|
|
) { |
|
83
|
568 |
|
$this->inverse = $inverse; |
|
84
|
|
|
|
|
85
|
568 |
|
parent::__construct($target, $load); |
|
86
|
568 |
|
} |
|
87
|
|
|
} |
|
88
|
|
|
|