1 | <?php |
||
21 | trait SubsidiaryTrait |
||
22 | { |
||
23 | /** |
||
24 | * @var string[] Subsidiary map. |
||
25 | * Array key represents class alias, |
||
26 | * array value represents the full qualified class name corresponds to the alias. |
||
27 | * |
||
28 | * For example: |
||
29 | * ```php |
||
30 | * public $subsidiaryMap = [ |
||
31 | * 'Profile' => 'app\models\user\Profile', |
||
32 | * ]; |
||
33 | * ``` |
||
34 | * or: |
||
35 | * ```php |
||
36 | * public $subsidiaryMap = [ |
||
37 | * 'Profile' => [ |
||
38 | * 'class' => 'app\models\user\Profile', |
||
39 | * 'max' => 1, |
||
40 | * ] |
||
41 | * ]; |
||
42 | * |
||
43 | * If you want to create subsidiary model and the class is not found, the array elements will be taken. |
||
44 | */ |
||
45 | public $subsidiaryMap = []; |
||
46 | |||
47 | /** |
||
48 | * Add subsidiary. |
||
49 | * @param string $name |
||
50 | * @param string|array $config |
||
51 | * @return boolean |
||
52 | * @throws InvalidConfigException |
||
53 | */ |
||
54 | 6 | public function addSubsidiary($name, $config) |
|
55 | { |
||
56 | 6 | if (!is_string($name) || empty($name)) { |
|
57 | 1 | throw new InvalidConfigException('Subsidiary name not specified.'); |
|
58 | } |
||
59 | 6 | $name = strtolower($name); |
|
60 | 6 | if (!is_array($config)) { |
|
61 | 6 | if (is_string($config) && !empty($config)) { |
|
62 | 6 | $this->subsidiaryMap[$name] = ['class' => $config]; |
|
63 | } else { |
||
64 | throw new InvalidConfigException('Subsidiary class not specified.'); |
||
65 | } |
||
66 | } else { |
||
67 | 1 | if (isset($config['class']) && class_exists($config['class'])) { |
|
68 | 1 | $this->subsidiaryMap[$name] = $config; |
|
69 | } else { |
||
70 | 1 | throw new InvalidConfigException('Subsidiary class not specified.'); |
|
71 | } |
||
72 | } |
||
73 | 6 | return true; |
|
74 | } |
||
75 | |||
76 | /** |
||
77 | * Remove subsidiary. |
||
78 | * @param string $name |
||
79 | * @return boolean |
||
80 | */ |
||
81 | 1 | public function removeSubsidiary($name) |
|
90 | |||
91 | /** |
||
92 | * Get subsidiary class. |
||
93 | * @param string $name |
||
94 | * @return string |
||
95 | */ |
||
96 | 6 | public function getSubsidiaryClass($name) |
|
104 | |||
105 | 2 | public function getSubsidiaries($name, $limit = 'all', $page = 0) |
|
117 | |||
118 | 6 | public function __call($name, $arguments) |
|
127 | |||
128 | /** |
||
129 | * Find existed, or create new model. |
||
130 | * If model to be found doesn't exist, and $config is null, the parameter |
||
131 | * `$condition` will be regarded as properties of new model. |
||
132 | * If you want to know whether the returned model is new model, please check |
||
133 | * the return value of `getIsNewRecord()` method. |
||
134 | * @param string $className Full qualified class name. |
||
135 | * @param array $condition Search condition, or properties if not found and |
||
136 | * $config is null. |
||
137 | * @param array $config new model's configuration array. If you specify this |
||
138 | * parameter, the $condition will be skipped when created one. |
||
139 | * @return [[$className]] the existed model, or new model created by specified |
||
|
|||
140 | * condition or configuration. |
||
141 | */ |
||
142 | 1 | public function findOneOrCreate($className, $condition = [], $config = null) |
|
157 | |||
158 | /** |
||
159 | * Create new entity model associated with current user. The model to be created |
||
160 | * must be extended from [[BaseBlameableModel]], [[BaseMongoBlameableModel]], |
||
161 | * [[BaseRedisBlameableModel]], or any other classes used [[BlameableTrait]]. |
||
162 | * if $config does not specify `hostClass` property, self will be assigned to. |
||
163 | * @param string $className Full qualified class name. |
||
164 | * @param array $config name-value pairs that will be used to initialize |
||
165 | * the object properties. |
||
166 | * @param boolean $loadDefault Determines whether loading default values |
||
167 | * after entity model created. |
||
168 | * Notice! The [[\yii\mongodb\ActiveRecord]] and [[\yii\redis\ActiveRecord]] |
||
169 | * does not support loading default value. If you want to assign properties |
||
170 | * with default values, please define the `default` rule(s) for properties in |
||
171 | * `rules()` method and return them by yourself if you don't specified them in config param. |
||
172 | * @param boolean $skipIfSet whether existing value should be preserved. |
||
173 | * This will only set defaults for attributes that are `null`. |
||
174 | * @return [[$className]] new model created with specified configuration. |
||
175 | */ |
||
176 | 167 | public function create($className, $config = [], $loadDefault = true, $skipIfSet = true) |
|
191 | |||
192 | /** |
||
193 | * |
||
194 | * @param string $name |
||
195 | * @param array $config |
||
196 | * @return type |
||
197 | */ |
||
198 | 6 | public function createSubsidiary($name, $config) |
|
213 | } |
||
214 |
This check marks PHPDoc comments that could not be parsed by our parser. To see which comment annotations we can parse, please refer to our documentation on supported doc-types.