Passed
Pull Request — 5.1 (#1748)
by guanguans
09:27
created

BelongsToMany::find()   A

Complexity

Conditions 2
Paths 2

Size

Total Lines 8
Code Lines 4

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 2
eloc 4
nc 2
nop 1
dl 0
loc 8
rs 10
c 0
b 0
f 0
1
<?php
2
// +----------------------------------------------------------------------
1 ignored issue
show
Coding Style introduced by
You must use "/**" style comments for a file comment
Loading history...
3
// | ThinkPHP [ WE CAN DO IT JUST THINK ]
4
// +----------------------------------------------------------------------
5
// | Copyright (c) 2006~2018 http://thinkphp.cn All rights reserved.
6
// +----------------------------------------------------------------------
7
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
8
// +----------------------------------------------------------------------
9
// | Author: liu21st <[email protected]>
10
// +----------------------------------------------------------------------
11
12
namespace think\model\relation;
13
14
use think\Collection;
15
use think\db\Query;
16
use think\Exception;
17
use think\Loader;
18
use think\Model;
19
use think\model\Pivot;
20
use think\model\Relation;
21
22
class BelongsToMany extends Relation
1 ignored issue
show
Coding Style introduced by
Missing class doc comment
Loading history...
23
{
24
    // 中间表表名
25
    protected $middle;
26
    // 中间表模型名称
27
    protected $pivotName;
28
    // 中间表数据名称
29
    protected $pivotDataName = 'pivot';
30
    // 中间表模型对象
31
    protected $pivot;
32
33
    /**
34
     * 架构函数
35
     * @access public
36
     * @param  Model  $parent     上级模型对象
37
     * @param  string $model      模型名
38
     * @param  string $table      中间表名
39
     * @param  string $foreignKey 关联模型外键
40
     * @param  string $localKey   当前模型关联键
41
     */
42
    public function __construct(Model $parent, $model, $table, $foreignKey, $localKey)
43
    {
44
        $this->parent     = $parent;
45
        $this->model      = $model;
0 ignored issues
show
Documentation Bug introduced by
It seems like $model of type string is incompatible with the declared type think\Model of property $model.

Our type inference engine has found an assignment to a property that is incompatible with the declared type of that property.

Either this assignment is in error or the assigned type should be added to the documentation/type hint for that property..

Loading history...
46
        $this->foreignKey = $foreignKey;
47
        $this->localKey   = $localKey;
48
49
        if (false !== strpos($table, '\\')) {
50
            $this->pivotName = $table;
51
            $this->middle    = basename(str_replace('\\', '/', $table));
52
        } else {
53
            $this->middle = $table;
54
        }
55
56
        $this->query = (new $model)->db();
57
        $this->pivot = $this->newPivot();
58
    }
59
60
    /**
0 ignored issues
show
Coding Style introduced by
Parameter $pivot should have a doc-comment as per coding-style.
Loading history...
61
     * 设置中间表模型
62
     * @access public
63
     * @param  $pivot
0 ignored issues
show
Coding Style Documentation introduced by
Missing parameter name
Loading history...
64
     * @return $this
65
     */
66
    public function pivot($pivot)
67
    {
68
        $this->pivotName = $pivot;
69
        return $this;
70
    }
71
72
    /**
73
     * 设置中间表数据名称
74
     * @access public
75
     * @param  string $name
0 ignored issues
show
Coding Style introduced by
Missing parameter comment
Loading history...
76
     * @return $this
77
     */
78
    public function pivotDataName($name)
79
    {
80
        $this->pivotDataName = $name;
81
        return $this;
82
    }
83
84
    /**
0 ignored issues
show
Coding Style introduced by
Parameter $data should have a doc-comment as per coding-style.
Loading history...
85
     * 获取中间表更新条件
86
     * @param $data
1 ignored issue
show
Coding Style Documentation introduced by
Missing parameter name
Loading history...
Coding Style introduced by
Tag value indented incorrectly; expected 2 spaces but found 1
Loading history...
87
     * @return array
88
     */
89
    protected function getUpdateWhere($data)
90
    {
91
        return [
92
            $this->localKey   => $data[$this->localKey],
93
            $this->foreignKey => $data[$this->foreignKey],
94
        ];
95
    }
96
97
    /**
98
     * 实例化中间表模型
99
     * @access public
100
     * @param  array    $data
0 ignored issues
show
Coding Style introduced by
Missing parameter comment
Loading history...
101
     * @param  bool     $isUpdate
0 ignored issues
show
Coding Style introduced by
Missing parameter comment
Loading history...
102
     * @return Pivot
103
     * @throws Exception
104
     */
105
    protected function newPivot($data = [], $isUpdate = false)
106
    {
107
        $class = $this->pivotName ?: '\\think\\model\\Pivot';
108
        $pivot = new $class($data, $this->parent, $this->middle);
109
110
        if ($pivot instanceof Pivot) {
111
            return $isUpdate ? $pivot->isUpdate(true, $this->getUpdateWhere($data)) : $pivot;
112
        }
113
114
        throw new Exception('pivot model must extends: \think\model\Pivot');
115
    }
116
117
    /**
118
     * 合成中间表模型
119
     * @access protected
120
     * @param  array|Collection|Paginator $models
0 ignored issues
show
Bug introduced by
The type think\model\relation\Paginator was not found. Maybe you did not declare it correctly or list all dependencies?

The issue could also be caused by a filter entry in the build configuration. If the path has been excluded in your configuration, e.g. excluded_paths: ["lib/*"], you can move it to the dependency path list as follows:

filter:
    dependency_paths: ["lib/*"]

For further information see https://scrutinizer-ci.com/docs/tools/php/php-scrutinizer/#list-dependency-paths

Loading history...
Coding Style introduced by
Missing parameter comment
Loading history...
121
     */
0 ignored issues
show
Coding Style introduced by
Missing @return tag in function comment
Loading history...
122
    protected function hydratePivot($models)
123
    {
124
        foreach ($models as $model) {
125
            $pivot = [];
126
127
            foreach ($model->getData() as $key => $val) {
128
                if (strpos($key, '__')) {
129
                    list($name, $attr) = explode('__', $key, 2);
130
131
                    if ('pivot' == $name) {
132
                        $pivot[$attr] = $val;
133
                        unset($model->$key);
134
                    }
135
                }
136
            }
137
138
            $model->setRelation($this->pivotDataName, $this->newPivot($pivot, true));
139
        }
140
    }
141
142
    /**
143
     * 创建关联查询Query对象
144
     * @access protected
145
     * @return Query
146
     */
147
    protected function buildQuery()
148
    {
149
        $foreignKey = $this->foreignKey;
150
        $localKey   = $this->localKey;
151
152
        // 关联查询
153
        $pk = $this->parent->getPk();
154
155
        $condition[] = ['pivot.' . $localKey, '=', $this->parent->$pk];
0 ignored issues
show
Comprehensibility Best Practice introduced by
$condition was never initialized. Although not strictly required by PHP, it is generally a good practice to add $condition = array(); before regardless.
Loading history...
156
157
        return $this->belongsToManyQuery($foreignKey, $localKey, $condition);
158
    }
159
160
    /**
161
     * 延迟获取关联数据
162
     * @access public
163
     * @param  string   $subRelation 子关联名
164
     * @param  \Closure $closure     闭包查询条件
165
     * @return Collection
166
     */
167
    public function getRelation($subRelation = '', $closure = null)
168
    {
169
        if ($closure) {
170
            $closure($this->query);
171
        }
172
173
        $result = $this->buildQuery()->relation($subRelation)->select();
174
        $this->hydratePivot($result);
0 ignored issues
show
Bug introduced by
It seems like $result can also be of type string; however, parameter $models of think\model\relation\BelongsToMany::hydratePivot() does only seem to accept array|think\Collection|t...odel\relation\Paginator, maybe add an additional type check? ( Ignorable by Annotation )

If this is a false-positive, you can also ignore this issue in your code via the ignore-type  annotation

174
        $this->hydratePivot(/** @scrutinizer ignore-type */ $result);
Loading history...
175
176
        return $result;
0 ignored issues
show
Bug Best Practice introduced by
The expression return $result also could return the type PDOStatement|array|string which is incompatible with the documented return type think\Collection.
Loading history...
177
    }
178
179
    /**
180
     * 重载select方法
181
     * @access public
182
     * @param  mixed $data
0 ignored issues
show
Coding Style introduced by
Missing parameter comment
Loading history...
183
     * @return Collection
184
     */
185
    public function select($data = null)
186
    {
187
        $result = $this->buildQuery()->select($data);
188
        $this->hydratePivot($result);
0 ignored issues
show
Bug introduced by
It seems like $result can also be of type string; however, parameter $models of think\model\relation\BelongsToMany::hydratePivot() does only seem to accept array|think\Collection|t...odel\relation\Paginator, maybe add an additional type check? ( Ignorable by Annotation )

If this is a false-positive, you can also ignore this issue in your code via the ignore-type  annotation

188
        $this->hydratePivot(/** @scrutinizer ignore-type */ $result);
Loading history...
189
190
        return $result;
0 ignored issues
show
Bug Best Practice introduced by
The expression return $result also could return the type PDOStatement|array|string which is incompatible with the documented return type think\Collection.
Loading history...
191
    }
192
193
    /**
194
     * 重载paginate方法
195
     * @access public
196
     * @param  null  $listRows
0 ignored issues
show
Documentation Bug introduced by
Are you sure the doc-type for parameter $listRows is correct as it would always require null to be passed?
Loading history...
Coding Style introduced by
Missing parameter comment
Loading history...
197
     * @param  bool  $simple
0 ignored issues
show
Coding Style introduced by
Missing parameter comment
Loading history...
198
     * @param  array $config
0 ignored issues
show
Coding Style introduced by
Missing parameter comment
Loading history...
199
     * @return Paginator
200
     */
201
    public function paginate($listRows = null, $simple = false, $config = [])
202
    {
203
        $result = $this->buildQuery()->paginate($listRows, $simple, $config);
204
        $this->hydratePivot($result);
205
206
        return $result;
0 ignored issues
show
Bug Best Practice introduced by
The expression return $result returns the type think\Paginator which is incompatible with the documented return type think\model\relation\Paginator.
Loading history...
207
    }
208
209
    /**
210
     * 重载find方法
211
     * @access public
212
     * @param  mixed $data
0 ignored issues
show
Coding Style introduced by
Missing parameter comment
Loading history...
213
     * @return Model
214
     */
215
    public function find($data = null)
216
    {
217
        $result = $this->buildQuery()->find($data);
218
        if ($result) {
219
            $this->hydratePivot([$result]);
220
        }
221
222
        return $result;
0 ignored issues
show
Bug Best Practice introduced by
The expression return $result also could return the type PDOStatement|array|string which is incompatible with the documented return type think\Model.
Loading history...
223
    }
224
225
    /**
226
     * 查找多条记录 如果不存在则抛出异常
227
     * @access public
228
     * @param  array|string|Query|\Closure $data
0 ignored issues
show
Coding Style introduced by
Missing parameter comment
Loading history...
229
     * @return Collection
230
     */
231
    public function selectOrFail($data = null)
232
    {
233
        return $this->failException(true)->select($data);
0 ignored issues
show
Bug introduced by
The method failException() does not exist on think\model\relation\BelongsToMany. Since you implemented __call, consider adding a @method annotation. ( Ignorable by Annotation )

If this is a false-positive, you can also ignore this issue in your code via the ignore-call  annotation

233
        return $this->/** @scrutinizer ignore-call */ failException(true)->select($data);
Loading history...
234
    }
235
236
    /**
237
     * 查找单条记录 如果不存在则抛出异常
238
     * @access public
239
     * @param  array|string|Query|\Closure $data
0 ignored issues
show
Coding Style introduced by
Missing parameter comment
Loading history...
240
     * @return Model
241
     */
242
    public function findOrFail($data = null)
243
    {
244
        return $this->failException(true)->find($data);
245
    }
246
247
    /**
248
     * 根据关联条件查询当前模型
249
     * @access public
250
     * @param  string  $operator 比较操作符
251
     * @param  integer $count    个数
252
     * @param  string  $id       关联表的统计字段
253
     * @param  string  $joinType JOIN类型
254
     * @return Query
255
     */
256
    public function has($operator = '>=', $count = 1, $id = '*', $joinType = 'INNER')
257
    {
258
        return $this->parent;
259
    }
260
261
    /**
262
     * 根据关联条件查询当前模型
263
     * @access public
264
     * @param  mixed     $where 查询条件(数组或者闭包)
0 ignored issues
show
Coding Style introduced by
Expected 2 spaces after parameter name; 1 found
Loading history...
265
     * @param  mixed     $fields 字段
266
     * @return Query
267
     * @throws Exception
268
     */
269
    public function hasWhere($where = [], $fields = null)
270
    {
271
        throw new Exception('relation not support: hasWhere');
272
    }
273
274
    /**
275
     * 设置中间表的查询条件
276
     * @access public
277
     * @param  string    $field
0 ignored issues
show
Coding Style introduced by
Missing parameter comment
Loading history...
278
     * @param  string    $op
0 ignored issues
show
Coding Style introduced by
Missing parameter comment
Loading history...
279
     * @param  mixed     $condition
0 ignored issues
show
Coding Style introduced by
Missing parameter comment
Loading history...
280
     * @return $this
281
     */
282
    public function wherePivot($field, $op = null, $condition = null)
283
    {
284
        $this->query->where('pivot.' . $field, $op, $condition);
285
        return $this;
286
    }
287
288
    /**
289
     * 预载入关联查询(数据集)
290
     * @access public
291
     * @param  array    $resultSet   数据集
292
     * @param  string   $relation    当前关联名
293
     * @param  string   $subRelation 子关联名
294
     * @param  \Closure $closure     闭包
295
     * @return void
296
     */
297
    public function eagerlyResultSet(&$resultSet, $relation, $subRelation, $closure)
298
    {
299
        $localKey   = $this->localKey;
300
        $foreignKey = $this->foreignKey;
0 ignored issues
show
Unused Code introduced by
The assignment to $foreignKey is dead and can be removed.
Loading history...
301
302
        $pk    = $resultSet[0]->getPk();
303
        $range = [];
304
        foreach ($resultSet as $result) {
305
            // 获取关联外键列表
306
            if (isset($result->$pk)) {
307
                $range[] = $result->$pk;
308
            }
309
        }
310
311
        if (!empty($range)) {
312
            // 查询关联数据
313
            $data = $this->eagerlyManyToMany([
0 ignored issues
show
Coding Style introduced by
The opening parenthesis of a multi-line function call should be the last content on the line.
Loading history...
314
                ['pivot.' . $localKey, 'in', $range],
315
            ], $relation, $subRelation, $closure);
0 ignored issues
show
Coding Style introduced by
For multi-line function calls, the closing parenthesis should be on a new line.

If a function call spawns multiple lines, the coding standard suggests to move the closing parenthesis to a new line:

someFunctionCall(
    $firstArgument,
    $secondArgument,
    $thirdArgument
); // Closing parenthesis on a new line.
Loading history...
316
317
            // 关联属性名
318
            $attr = Loader::parseName($relation);
319
320
            // 关联数据封装
321
            foreach ($resultSet as $result) {
322
                if (!isset($data[$result->$pk])) {
323
                    $data[$result->$pk] = [];
324
                }
325
326
                $result->setRelation($attr, $this->resultSetBuild($data[$result->$pk]));
327
            }
328
        }
329
    }
330
331
    /**
332
     * 预载入关联查询(单个数据)
333
     * @access public
334
     * @param  Model    $result      数据对象
335
     * @param  string   $relation    当前关联名
336
     * @param  string   $subRelation 子关联名
337
     * @param  \Closure $closure     闭包
338
     * @return void
339
     */
340
    public function eagerlyResult(&$result, $relation, $subRelation, $closure)
341
    {
342
        $pk = $result->getPk();
343
344
        if (isset($result->$pk)) {
345
            $pk = $result->$pk;
346
            // 查询管理数据
347
            $data = $this->eagerlyManyToMany([
0 ignored issues
show
Coding Style introduced by
The opening parenthesis of a multi-line function call should be the last content on the line.
Loading history...
348
                ['pivot.' . $this->localKey, '=', $pk],
349
            ], $relation, $subRelation, $closure);
0 ignored issues
show
Coding Style introduced by
For multi-line function calls, the closing parenthesis should be on a new line.

If a function call spawns multiple lines, the coding standard suggests to move the closing parenthesis to a new line:

someFunctionCall(
    $firstArgument,
    $secondArgument,
    $thirdArgument
); // Closing parenthesis on a new line.
Loading history...
350
351
            // 关联数据封装
352
            if (!isset($data[$pk])) {
353
                $data[$pk] = [];
354
            }
355
356
            $result->setRelation(Loader::parseName($relation), $this->resultSetBuild($data[$pk]));
357
        }
358
    }
359
360
    /**
361
     * 关联统计
362
     * @access public
363
     * @param  Model    $result  数据对象
0 ignored issues
show
Coding Style introduced by
Expected 4 spaces after parameter name; 2 found
Loading history...
364
     * @param  \Closure $closure 闭包
0 ignored issues
show
Coding Style introduced by
Expected 3 spaces after parameter name; 1 found
Loading history...
365
     * @param  string   $aggregate 聚合查询方法
366
     * @param  string   $field 字段
0 ignored issues
show
Coding Style introduced by
Expected 5 spaces after parameter name; 1 found
Loading history...
367
     * @param  string   $name 统计字段别名
0 ignored issues
show
Coding Style introduced by
Expected 6 spaces after parameter name; 1 found
Loading history...
368
     * @return integer
369
     */
370
    public function relationCount($result, $closure, $aggregate = 'count', $field = '*', &$name = '')
371
    {
372
        $pk = $result->getPk();
373
374
        if (!isset($result->$pk)) {
375
            return 0;
376
        }
377
378
        $pk = $result->$pk;
379
380
        if ($closure) {
0 ignored issues
show
introduced by
$closure is of type Closure, thus it always evaluated to true.
Loading history...
381
            $return = $closure($this->query);
382
383
            if ($return && is_string($return)) {
384
                $name = $return;
385
            }
386
        }
387
388
        return $this->belongsToManyQuery($this->foreignKey, $this->localKey, [
0 ignored issues
show
Coding Style introduced by
The opening parenthesis of a multi-line function call should be the last content on the line.
Loading history...
389
            ['pivot.' . $this->localKey, '=', $pk],
390
        ])->$aggregate($field);
0 ignored issues
show
Coding Style introduced by
For multi-line function calls, the closing parenthesis should be on a new line.

If a function call spawns multiple lines, the coding standard suggests to move the closing parenthesis to a new line:

someFunctionCall(
    $firstArgument,
    $secondArgument,
    $thirdArgument
); // Closing parenthesis on a new line.
Loading history...
391
    }
392
393
    /**
394
     * 获取关联统计子查询
395
     * @access public
396
     * @param  \Closure $closure 闭包
0 ignored issues
show
Coding Style introduced by
Expected 8 spaces after parameter name; 1 found
Loading history...
397
     * @param  string   $aggregate 聚合查询方法
0 ignored issues
show
Coding Style introduced by
Expected 6 spaces after parameter name; 1 found
Loading history...
398
     * @param  string   $field 字段
0 ignored issues
show
Coding Style introduced by
Expected 10 spaces after parameter name; 1 found
Loading history...
399
     * @param  string   $aggregateAlias 聚合字段别名
400
     * @return array
401
     */
402
    public function getRelationCountQuery($closure, $aggregate = 'count', $field = '*', &$aggregateAlias = '')
403
    {
404
        if ($closure) {
0 ignored issues
show
introduced by
$closure is of type Closure, thus it always evaluated to true.
Loading history...
405
            $return = $closure($this->query);
406
407
            if ($return && is_string($return)) {
408
                $aggregateAlias = $return;
409
            }
410
        }
411
412
        return $this->belongsToManyQuery($this->foreignKey, $this->localKey, [
0 ignored issues
show
Coding Style introduced by
The opening parenthesis of a multi-line function call should be the last content on the line.
Loading history...
413
            [
414
                'pivot.' . $this->localKey, 'exp', $this->query->raw('=' . $this->parent->getTable() . '.' . $this->parent->getPk()),
415
            ],
416
        ])->fetchSql()->$aggregate($field);
0 ignored issues
show
Coding Style introduced by
For multi-line function calls, the closing parenthesis should be on a new line.

If a function call spawns multiple lines, the coding standard suggests to move the closing parenthesis to a new line:

someFunctionCall(
    $firstArgument,
    $secondArgument,
    $thirdArgument
); // Closing parenthesis on a new line.
Loading history...
417
    }
418
419
    /**
420
     * 多对多 关联模型预查询
421
     * @access protected
422
     * @param  array    $where       关联预查询条件
423
     * @param  string   $relation    关联名
424
     * @param  string   $subRelation 子关联
425
     * @param  \Closure $closure     闭包
426
     * @return array
427
     */
428
    protected function eagerlyManyToMany($where, $relation, $subRelation = '', $closure = null)
429
    {
430
        // 预载入关联查询 支持嵌套预载入
431
        if ($closure) {
432
            $closure($this->query);
433
        }
434
435
        $list = $this->belongsToManyQuery($this->foreignKey, $this->localKey, $where)
436
            ->with($subRelation)
437
            ->select();
438
439
        // 组装模型数据
440
        $data = [];
441
        foreach ($list as $set) {
442
            $pivot = [];
443
            foreach ($set->getData() as $key => $val) {
444
                if (strpos($key, '__')) {
445
                    list($name, $attr) = explode('__', $key, 2);
446
                    if ('pivot' == $name) {
447
                        $pivot[$attr] = $val;
448
                        unset($set->$key);
449
                    }
450
                }
451
            }
452
453
            $set->setRelation($this->pivotDataName, $this->newPivot($pivot, true));
454
455
            $data[$pivot[$this->localKey]][] = $set;
456
        }
457
458
        return $data;
459
    }
460
461
    /**
462
     * BELONGS TO MANY 关联查询
463
     * @access protected
464
     * @param  string   $foreignKey 关联模型关联键
465
     * @param  string   $localKey   当前模型关联键
466
     * @param  array    $condition  关联查询条件
467
     * @return Query
468
     */
469
    protected function belongsToManyQuery($foreignKey, $localKey, $condition = [])
470
    {
471
        // 关联查询封装
472
        $tableName = $this->query->getTable();
473
        $table     = $this->pivot->getTable();
0 ignored issues
show
Bug introduced by
The method getTable() does not exist on think\model\Pivot. Since you implemented __call, consider adding a @method annotation. ( Ignorable by Annotation )

If this is a false-positive, you can also ignore this issue in your code via the ignore-call  annotation

473
        /** @scrutinizer ignore-call */ 
474
        $table     = $this->pivot->getTable();
Loading history...
474
        $fields    = $this->getQueryFields($tableName);
475
476
        $query = $this->query
477
            ->field($fields)
478
            ->field(true, false, $table, 'pivot', 'pivot__');
479
480
        if (empty($this->baseQuery)) {
481
            $relationFk = $this->query->getPk();
482
            $query->join([$table => 'pivot'], 'pivot.' . $foreignKey . '=' . $tableName . '.' . $relationFk)
0 ignored issues
show
Bug introduced by
Are you sure $relationFk of type array|string can be used in concatenation? ( Ignorable by Annotation )

If this is a false-positive, you can also ignore this issue in your code via the ignore-type  annotation

482
            $query->join([$table => 'pivot'], 'pivot.' . $foreignKey . '=' . $tableName . '.' . /** @scrutinizer ignore-type */ $relationFk)
Loading history...
483
                ->where($condition);
484
        }
485
486
        return $query;
487
    }
488
489
    /**
490
     * 保存(新增)当前关联数据对象
491
     * @access public
492
     * @param  mixed $data  数据 可以使用数组 关联模型对象 和 关联对象的主键
493
     * @param  array $pivot 中间表额外数据
494
     * @return array|Pivot
495
     */
496
    public function save($data, array $pivot = [])
497
    {
498
        // 保存关联表/中间表数据
499
        return $this->attach($data, $pivot);
500
    }
501
502
    /**
503
     * 批量保存当前关联数据对象
504
     * @access public
505
     * @param  array $dataSet   数据集
506
     * @param  array $pivot     中间表额外数据
507
     * @param  bool  $samePivot 额外数据是否相同
508
     * @return array|false
509
     */
510
    public function saveAll(array $dataSet, array $pivot = [], $samePivot = false)
511
    {
512
        $result = [];
513
514
        foreach ($dataSet as $key => $data) {
515
            if (!$samePivot) {
516
                $pivotData = isset($pivot[$key]) ? $pivot[$key] : [];
517
            } else {
518
                $pivotData = $pivot;
519
            }
520
521
            $result[] = $this->attach($data, $pivotData);
522
        }
523
524
        return empty($result) ? false : $result;
525
    }
526
527
    /**
528
     * 附加关联的一个中间表数据
529
     * @access public
530
     * @param  mixed $data  数据 可以使用数组、关联模型对象 或者 关联对象的主键
531
     * @param  array $pivot 中间表额外数据
532
     * @return array|Pivot
533
     * @throws Exception
534
     */
535
    public function attach($data, $pivot = [])
536
    {
537
        if (is_array($data)) {
538
            if (key($data) === 0) {
539
                $id = $data;
540
            } else {
541
                // 保存关联表数据
542
                $model = new $this->model;
543
                $id    = $model->insertGetId($data);
544
            }
545
        } elseif (is_numeric($data) || is_string($data)) {
546
            // 根据关联表主键直接写入中间表
547
            $id = $data;
548
        } elseif ($data instanceof Model) {
549
            // 根据关联表主键直接写入中间表
550
            $relationFk = $data->getPk();
551
            $id         = $data->$relationFk;
552
        }
553
554
        if ($id) {
0 ignored issues
show
Comprehensibility Best Practice introduced by
The variable $id does not seem to be defined for all execution paths leading up to this point.
Loading history...
555
            // 保存中间表数据
556
            $pk                     = $this->parent->getPk();
557
            $pivot[$this->localKey] = $this->parent->$pk;
558
            $ids                    = (array) $id;
559
560
            foreach ($ids as $id) {
561
                $pivot[$this->foreignKey] = $id;
562
                $this->pivot->replace()
563
                    ->exists(false)
564
                    ->data([])
565
                    ->save($pivot);
566
                $result[] = $this->newPivot($pivot, true);
567
            }
568
569
            if (count($result) == 1) {
0 ignored issues
show
Comprehensibility Best Practice introduced by
The variable $result seems to be defined by a foreach iteration on line 560. Are you sure the iterator is never empty, otherwise this variable is not defined?
Loading history...
570
                // 返回中间表模型对象
571
                $result = $result[0];
572
            }
573
574
            return $result;
575
        } else {
576
            throw new Exception('miss relation data');
577
        }
578
    }
579
580
    /**
581
     * 判断是否存在关联数据
582
     * @access public
583
     * @param  mixed $data  数据 可以使用关联模型对象 或者 关联对象的主键
0 ignored issues
show
Coding Style introduced by
Expected 1 spaces after parameter name; 2 found
Loading history...
584
     * @return Pivot
585
     * @throws Exception
586
     */
587
    public function attached($data)
588
    {
589
        if ($data instanceof Model) {
590
            $id = $data->getKey();
591
        } else {
592
            $id = $data;
593
        }
594
595
        $pivot = $this->pivot
596
            ->where($this->localKey, $this->parent->getKey())
597
            ->where($this->foreignKey, $id)
598
            ->find();
599
600
        return $pivot ?: false;
601
    }
602
603
    /**
604
     * 解除关联的一个中间表数据
605
     * @access public
606
     * @param  integer|array $data        数据 可以使用关联对象的主键
607
     * @param  bool          $relationDel 是否同时删除关联表数据
608
     * @return integer
609
     */
610
    public function detach($data = null, $relationDel = false)
611
    {
612
        if (is_array($data)) {
613
            $id = $data;
614
        } elseif (is_numeric($data) || is_string($data)) {
615
            // 根据关联表主键直接写入中间表
616
            $id = $data;
617
        } elseif ($data instanceof Model) {
618
            // 根据关联表主键直接写入中间表
619
            $relationFk = $data->getPk();
620
            $id         = $data->$relationFk;
621
        }
622
623
        // 删除中间表数据
624
        $pk      = $this->parent->getPk();
625
        $pivot[] = [$this->localKey, '=', $this->parent->$pk];
0 ignored issues
show
Comprehensibility Best Practice introduced by
$pivot was never initialized. Although not strictly required by PHP, it is generally a good practice to add $pivot = array(); before regardless.
Loading history...
626
627
        if (isset($id)) {
628
            $pivot[] = [$this->foreignKey, is_array($id) ? 'in' : '=', $id];
629
        }
630
631
        $result = $this->pivot->where($pivot)->delete();
632
633
        // 删除关联表数据
634
        if (isset($id) && $relationDel) {
635
            $model = $this->model;
636
            $model::destroy($id);
637
        }
638
639
        return $result;
640
    }
641
642
    /**
643
     * 数据同步
644
     * @access public
645
     * @param  array $ids
0 ignored issues
show
Coding Style introduced by
Missing parameter comment
Loading history...
646
     * @param  bool  $detaching
0 ignored issues
show
Coding Style introduced by
Missing parameter comment
Loading history...
647
     * @return array
648
     */
649
    public function sync($ids, $detaching = true)
650
    {
651
        $changes = [
652
            'attached' => [],
653
            'detached' => [],
654
            'updated'  => [],
655
        ];
656
657
        $pk = $this->parent->getPk();
658
659
        $current = $this->pivot
660
            ->where($this->localKey, $this->parent->$pk)
661
            ->column($this->foreignKey);
662
663
        $records = [];
664
665
        foreach ($ids as $key => $value) {
666
            if (!is_array($value)) {
667
                $records[$value] = [];
668
            } else {
669
                $records[$key] = $value;
670
            }
671
        }
672
673
        $detach = array_diff($current, array_keys($records));
674
675
        if ($detaching && count($detach) > 0) {
676
            $this->detach($detach);
677
            $changes['detached'] = $detach;
678
        }
679
680
        foreach ($records as $id => $attributes) {
681
            if (!in_array($id, $current)) {
682
                $this->attach($id, $attributes);
683
                $changes['attached'][] = $id;
684
            } elseif (count($attributes) > 0 && $this->attach($id, $attributes)) {
685
                $changes['updated'][] = $id;
686
            }
687
        }
688
689
        return $changes;
690
    }
691
692
    /**
693
     * 执行基础查询(仅执行一次)
694
     * @access protected
695
     * @return void
696
     */
697
    protected function baseQuery()
698
    {
699
        if (empty($this->baseQuery) && $this->parent->getData()) {
700
            $pk    = $this->parent->getPk();
701
            $table = $this->pivot->getTable();
702
703
            $this->query
704
                ->join([$table => 'pivot'], 'pivot.' . $this->foreignKey . '=' . $this->query->getTable() . '.' . $this->query->getPk())
0 ignored issues
show
Bug introduced by
Are you sure $this->query->getPk() of type array|string can be used in concatenation? ( Ignorable by Annotation )

If this is a false-positive, you can also ignore this issue in your code via the ignore-type  annotation

704
                ->join([$table => 'pivot'], 'pivot.' . $this->foreignKey . '=' . $this->query->getTable() . '.' . /** @scrutinizer ignore-type */ $this->query->getPk())
Loading history...
705
                ->where('pivot.' . $this->localKey, $this->parent->$pk);
706
            $this->baseQuery = true;
707
        }
708
    }
709
710
}
711