Passed
Push — master ( b7b77b...565dd3 )
by Glynn
05:12 queued 03:02
created
src/QueryBuilder/WPDBAdapter.php 2 patches
Indentation   +711 added lines, -711 removed lines patch added patch discarded remove patch
@@ -17,715 +17,715 @@
 block discarded – undo
17 17
 
18 18
 class WPDBAdapter
19 19
 {
20
-    /**
21
-     * @var string
22
-     */
23
-    protected $sanitizer = '';
24
-
25
-    /**
26
-     * @var \Pixie\Connection
27
-     */
28
-    protected $connection;
29
-
30
-    /**
31
-     * @var \Viocon\Container
32
-     */
33
-    protected $container;
34
-
35
-    public function __construct(Connection $connection)
36
-    {
37
-        $this->connection = $connection;
38
-        $this->container  = $this->connection->getContainer();
39
-    }
40
-
41
-    /**
42
-     * Build select query string and bindings
43
-     *
44
-     * @param array<string|Closure, mixed|mixed[]> $statements
45
-     *
46
-     * @throws Exception
47
-     *
48
-     * @return array{sql:string,bindings:mixed[]}
49
-     */
50
-    public function select(array $statements): array
51
-    {
52
-        if (!array_key_exists('tables', $statements)) {
53
-            throw new Exception('No table specified.', 3);
54
-        } elseif (!array_key_exists('selects', $statements)) {
55
-            $statements['selects'][] = '*';
56
-        }
57
-
58
-        // From
59
-        $tables = $this->arrayStr($statements['tables'], ', ');
60
-        // Select
61
-        $selects = $this->arrayStr($statements['selects'], ', ');
62
-
63
-        // Wheres
64
-        list($whereCriteria, $whereBindings) = $this->buildCriteriaWithType($statements, 'wheres', 'WHERE');
65
-
66
-        // Group bys
67
-        $groupBys = '';
68
-        if (isset($statements['groupBys']) && $groupBys = $this->arrayStr($statements['groupBys'], ', ')) {
69
-            $groupBys = 'GROUP BY ' . $groupBys;
70
-        }
71
-
72
-        // Order bys
73
-        $orderBys = '';
74
-        if (isset($statements['orderBys']) && is_array($statements['orderBys'])) {
75
-            foreach ($statements['orderBys'] as $orderBy) {
76
-                $field = $this->wrapSanitizer($orderBy['field']);
77
-                if ($field instanceof Closure) {
78
-                    continue;
79
-                }
80
-                $orderBys .= $field . ' ' . $orderBy['type'] . ', ';
81
-            }
82
-
83
-            if ($orderBys = trim($orderBys, ', ')) {
84
-                $orderBys = 'ORDER BY ' . $orderBys;
85
-            }
86
-        }
87
-
88
-        // Limit and offset
89
-        $limit  = isset($statements['limit']) ? 'LIMIT ' . (int) $statements['limit'] : '';
90
-        $offset = isset($statements['offset']) ? 'OFFSET ' . (int) $statements['offset'] : '';
91
-
92
-        // Having
93
-        list($havingCriteria, $havingBindings) = $this->buildCriteriaWithType($statements, 'havings', 'HAVING');
94
-
95
-        // Joins
96
-        $joinString = $this->buildJoin($statements);
97
-
98
-        /** @var string[] */
99
-        $sqlArray = [
100
-            'SELECT' . (isset($statements['distinct']) ? ' DISTINCT' : ''),
101
-            $selects,
102
-            'FROM',
103
-            $tables,
104
-            $joinString,
105
-            $whereCriteria,
106
-            $groupBys,
107
-            $havingCriteria,
108
-            $orderBys,
109
-            $limit,
110
-            $offset,
111
-        ];
112
-
113
-        $sql = $this->concatenateQuery($sqlArray);
114
-
115
-        $bindings = array_merge(
116
-            $whereBindings,
117
-            $havingBindings
118
-        );
119
-
120
-        return compact('sql', 'bindings');
121
-    }
122
-
123
-    /**
124
-     * Build just criteria part of the query
125
-     *
126
-     * @param array<string|Closure, mixed|mixed[]> $statements
127
-     * @param bool $bindValues
128
-     *
129
-     * @return array{sql:string[]|string, bindings:array<mixed>}
130
-     */
131
-    public function criteriaOnly(array $statements, bool $bindValues = true): array
132
-    {
133
-        $sql = $bindings = [];
134
-        if (!isset($statements['criteria'])) {
135
-            return compact('sql', 'bindings');
136
-        }
137
-
138
-        list($sql, $bindings) = $this->buildCriteria($statements['criteria'], $bindValues);
139
-
140
-        return compact('sql', 'bindings');
141
-    }
142
-
143
-    /**
144
-     * Build a generic insert/ignore/replace query
145
-     *
146
-     * @param array<string|Closure, mixed|mixed[]> $statements
147
-     * @param array<string, mixed> $data
148
-     * @param string $type
149
-     *
150
-     * @return array{sql:string, bindings:mixed[]}
151
-     *
152
-     * @throws Exception
153
-     */
154
-    private function doInsert(array $statements, array $data, string $type): array
155
-    {
156
-        if (!isset($statements['tables'])) {
157
-            throw new Exception('No table specified', 3);
158
-        }
159
-
160
-        $table = end($statements['tables']);
161
-
162
-        $bindings = $keys = $values = [];
163
-
164
-        foreach ($data as $key => $value) {
165
-            $keys[] = $key;
166
-
167
-            // Handle value as bindings
168
-            $isBindings = $value instanceof Binding;
169
-            // If this is a raw binding, extract the Raw and replace value.
170
-            if ($isBindings && $value->isRaw()) {
171
-                $value = $value->getValue();
172
-            }
173
-
174
-            if ($value instanceof Raw) {
175
-                $values[] = $this->parseRaw($value);
176
-            } elseif ($isBindings) {
177
-                $values[]   =  $value->getType();
178
-                $bindings[] = $value->getValue();
179
-            } else {
180
-                $values[]   =  $this->inferType($value);
181
-                $bindings[] = $value;
182
-            }
183
-        }
184
-
185
-        $sqlArray = [
186
-        $type . ' INTO',
187
-        $this->wrapSanitizer($table),
188
-        '(' . $this->arrayStr($keys, ',') . ')',
189
-        'VALUES',
190
-        '(' . $this->arrayStr($values, ',') . ')',
191
-        ];
192
-
193
-        if (isset($statements['onduplicate'])) {
194
-            if (count($statements['onduplicate']) < 1) {
195
-                throw new Exception('No data given.', 4);
196
-            }
197
-            list($updateStatement, $updateBindings) = $this->getUpdateStatement($statements['onduplicate']);
198
-            $sqlArray[]                             = 'ON DUPLICATE KEY UPDATE ' . $updateStatement;
199
-            $bindings                               = array_merge($bindings, $updateBindings);
200
-        }
201
-
202
-        $sql = $this->concatenateQuery($this->stringifyValues($sqlArray));
203
-
204
-        return compact('sql', 'bindings');
205
-    }
206
-
207
-    /**
208
-     * Attempts to stringify an array of values.
209
-     *
210
-     * @param array<string|int, string|Closure> $values
211
-     *
212
-     * @return string[]
213
-     */
214
-    protected function stringifyValues(array $values): array
215
-    {
216
-        return array_filter(array_map([$this, 'stringifyValue'], $values));
217
-    }
218
-
219
-    /**
220
-     * Attempts to stringify a single of values.
221
-     *
222
-     * @param string|Closure|Raw $value
223
-     *
224
-     * @return string|null
225
-     */
226
-    protected function stringifyValue($value): ?string
227
-    {
228
-        if ($value instanceof Closure) {
229
-            $value = $value();
230
-
231
-            return is_string($value) ? $value : null;
232
-        }
233
-
234
-        if ($value instanceof Raw) {
235
-            return $this->parseRaw($value);
236
-        }
237
-
238
-        return $value;
239
-    }
240
-
241
-    /**
242
-     * Build Insert query
243
-     *
244
-     * @param array<string|Closure, mixed|mixed[]> $statements
245
-     * @param array<string, mixed> $data $data
246
-     *
247
-     * @return array{sql:string, bindings:mixed[]}
248
-     *
249
-     * @throws Exception
250
-     */
251
-    public function insert($statements, array $data)
252
-    {
253
-        return $this->doInsert($statements, $data, 'INSERT');
254
-    }
255
-
256
-    /**
257
-     * Build Insert Ignore query
258
-     *
259
-     * @param array<string|Closure, mixed|mixed[]> $statements
260
-     * @param array<string, mixed> $data $data
261
-     *
262
-     * @return array{sql:string, bindings:mixed[]}
263
-     *
264
-     * @throws Exception
265
-     */
266
-    public function insertIgnore($statements, array $data)
267
-    {
268
-        return $this->doInsert($statements, $data, 'INSERT IGNORE');
269
-    }
270
-
271
-    /**
272
-     * Build Insert Ignore query
273
-     *
274
-     * @param array<string|Closure, mixed|mixed[]> $statements
275
-     * @param array<string, mixed> $data $data
276
-     *
277
-     * @return array{sql:string, bindings:mixed[]}
278
-     *
279
-     * @throws Exception
280
-     */
281
-    public function replace($statements, array $data)
282
-    {
283
-        return $this->doInsert($statements, $data, 'REPLACE');
284
-    }
285
-
286
-    /**
287
-     * Build fields assignment part of SET ... or ON DUBLICATE KEY UPDATE ... statements
288
-     *
289
-     * @param array<string, mixed> $data
290
-     *
291
-     * @return array{0:string,1:mixed[]}
292
-     */
293
-    private function getUpdateStatement(array $data): array
294
-    {
295
-        $bindings  = [];
296
-        $statement = '';
297
-
298
-        foreach ($data as $key => $value) {
299
-            $isBindings = $value instanceof Binding;
300
-            // If this is a raw binding, extract the Raw and replace value.
301
-            if ($isBindings && $value->isRaw()) {
302
-                $value = $value->getValue();
303
-            }
304
-
305
-            if ($value instanceof Raw) {
306
-                $statement .= $this->stringifyValue($this->wrapSanitizer($key)) . '=' . $value . ',';
307
-            } elseif ($isBindings) {
308
-                $statement .= $this->stringifyValue($this->wrapSanitizer($key)) . sprintf('=%s,', $value->getType());
309
-                $bindings[] = $value->getValue();
310
-            } else {
311
-                $statement .= $this->stringifyValue($this->wrapSanitizer($key)) . sprintf('=%s,', $this->inferType($value));
312
-                $bindings[] = $value;
313
-            }
314
-        }
315
-
316
-        $statement = trim($statement, ',');
317
-
318
-        return [$statement, $bindings];
319
-    }
320
-
321
-    /**
322
-     * Build update query
323
-     *
324
-     * @param array<string|Closure, mixed|mixed[]> $statements
325
-     * @param array<string, mixed> $data
326
-     *
327
-     * @return array{sql:string, bindings:mixed[]}
328
-     *
329
-     * @throws Exception
330
-     */
331
-    public function update($statements, array $data)
332
-    {
333
-        if (!isset($statements['tables'])) {
334
-            throw new Exception('No table specified', 3);
335
-        } elseif (count($data) < 1) {
336
-            throw new Exception('No data given.', 4);
337
-        }
338
-
339
-        $table = end($statements['tables']);
340
-
341
-        // Update statement
342
-        list($updateStatement, $bindings) = $this->getUpdateStatement($data);
343
-
344
-        // Wheres
345
-        list($whereCriteria, $whereBindings) = $this->buildCriteriaWithType($statements, 'wheres', 'WHERE');
346
-
347
-        // Limit
348
-        $limit = isset($statements['limit']) ? 'LIMIT ' . $statements['limit'] : '';
349
-
350
-        $sqlArray = [
351
-            'UPDATE',
352
-            $this->wrapSanitizer($table),
353
-            'SET ' . $updateStatement,
354
-            $whereCriteria,
355
-            $limit,
356
-        ];
357
-
358
-        $sql = $this->concatenateQuery($this->stringifyValues($sqlArray));
359
-
360
-        $bindings = array_merge($bindings, $whereBindings);
361
-
362
-        return compact('sql', 'bindings');
363
-    }
364
-
365
-    /**
366
-     * Build delete query
367
-     *
368
-     * @param array<string|Closure, mixed|mixed[]> $statements
369
-     *
370
-     * @return array{sql:string, bindings:mixed[]}
371
-     *
372
-     * @throws Exception
373
-     */
374
-    public function delete($statements)
375
-    {
376
-        if (!isset($statements['tables'])) {
377
-            throw new Exception('No table specified', 3);
378
-        }
379
-
380
-        $table = end($statements['tables']);
381
-        // Ensure table name is a string
382
-        $table = $this->stringifyValue($this->wrapSanitizer($table));
383
-        if (null === $table) {
384
-            throw new Exception('Table must be a valid string.', 5);
385
-        }
386
-
387
-        // Wheres
388
-        list($whereCriteria, $whereBindings) = $this->buildCriteriaWithType($statements, 'wheres', 'WHERE');
389
-
390
-        // Limit
391
-        $limit = isset($statements['limit']) ? 'LIMIT ' . $statements['limit'] : '';
392
-
393
-        $sqlArray = ['DELETE FROM', $table, $whereCriteria];
394
-        $sql      = $this->concatenateQuery($sqlArray);
395
-        $bindings = $whereBindings;
396
-
397
-        return compact('sql', 'bindings');
398
-    }
399
-
400
-    /**
401
-     * Array concatenating method, like implode.
402
-     * But it does wrap sanitizer and trims last glue
403
-     *
404
-     * @param array<string|int, string> $pieces
405
-     * @param string $glue
406
-     *
407
-     * @return string
408
-     */
409
-    protected function arrayStr(array $pieces, string $glue): string
410
-    {
411
-        $str = '';
412
-        foreach ($pieces as $key => $piece) {
413
-            if (!is_int($key)) {
414
-                $piece = $key . ' AS ' . $piece;
415
-            }
416
-
417
-            $str .= $piece . $glue;
418
-        }
419
-
420
-        return trim($str, $glue);
421
-    }
422
-
423
-    /**
424
-     * Join different part of queries with a space.
425
-     *
426
-     * @param array<string|int, string> $pieces
427
-     *
428
-     * @return string
429
-     */
430
-    protected function concatenateQuery(array $pieces): string
431
-    {
432
-        $str = '';
433
-        foreach ($pieces as $piece) {
434
-            $str = trim($str) . ' ' . trim($piece);
435
-        }
436
-
437
-        return trim($str);
438
-    }
439
-
440
-    /**
441
-     * Gets the type of a value, either from a binding or infered
442
-     *
443
-     * @param mixed $value
444
-     * @return string
445
-     */
446
-    public function getType($value): string
447
-    {
448
-        return $value instanceof Binding && $value->getType() !== null
449
-            ? $value->getType() : $this->inferType($value) ;
450
-    }
451
-
452
-    /**
453
-     * Get the value from a possible Bindings object.
454
-     *
455
-     * @param mixed $value
456
-     * @return mixed
457
-     */
458
-    public function getValue($value)
459
-    {
460
-        return $value instanceof Binding ? $value->getValue() : $value;
461
-    }
462
-
463
-    /**
464
-     * Attempts to parse a raw query, if bindings are defined then they will be bound first.
465
-     *
466
-     * @param Raw $raw
467
-     * @requires string
468
-     */
469
-    public function parseRaw(Raw $raw): string
470
-    {
471
-        $bindings = $raw->getBindings();
472
-        return 0 === count($bindings)
473
-            ? (string) $raw
474
-            : $this->interpolateQuery($raw->getValue(), $bindings);
475
-    }
476
-
477
-    /**
478
-     * Interpolates a query
479
-     *
480
-     * @param string $query
481
-     * @param array<mixed> $bindings
482
-     * @return string
483
-     */
484
-    public function interpolateQuery(string $query, array $bindings = []): string
485
-    {
486
-        if (0 === count($bindings)) {
487
-            return $query;
488
-        }
489
-
490
-
491
-        $bindings = array_map([$this, 'getValue'], $bindings);
492
-        $query = $this->connection->getDbInstance()->prepare($query, $bindings) ;
493
-        return is_string($query) ? $query : '';
494
-    }
495
-
496
-    /**
497
-     * Build generic criteria string and bindings from statements, like "a = b and c = ?"
498
-     *
499
-     * @param array<string|Closure, mixed|mixed[]> $statements
500
-     * @param bool $bindValues
501
-     *
502
-     * @return array{0:string,1:string[]}
503
-     */
504
-    protected function buildCriteria(array $statements, bool $bindValues = true): array
505
-    {
506
-        $criteria = '';
507
-        $bindings = [];
508
-        foreach ($statements as $statement) {
509
-            $key   = $statement['key'];
510
-            $value = $statement['value'];
511
-
512
-            // If the value is a Raw Binding, cast to raw
513
-            if ($value instanceof Binding && Binding::RAW === $value->getType()) {
514
-                /** @var Raw */
515
-                $value = $value->getValue();
516
-            }
517
-
518
-            if (is_null($value) && $key instanceof Closure) {
519
-                // We have a closure, a nested criteria
520
-
521
-                // Build a new NestedCriteria class, keep it by reference so any changes made
522
-                // in the closure should reflect here
523
-                $nestedCriteria = $this->container->build(NestedCriteria::class, [$this->connection]);
524
-
525
-                $nestedCriteria = &$nestedCriteria;
526
-                // Call the closure with our new nestedCriteria object
527
-                $key($nestedCriteria);
528
-                // Get the criteria only query from the nestedCriteria object
529
-                $queryObject = $nestedCriteria->getQuery('criteriaOnly', true);
530
-                // Merge the bindings we get from nestedCriteria object
531
-                $bindings = array_merge($bindings, $queryObject->getBindings());
532
-                // Append the sql we get from the nestedCriteria object
533
-                $criteria .= $statement['joiner'] . ' (' . $queryObject->getSql() . ') ';
534
-            } elseif (is_array($value)) {
535
-                // where_in or between like query
536
-                $criteria .= $statement['joiner'] . ' ' . $key . ' ' . $statement['operator'];
537
-
538
-                switch ($statement['operator']) {
539
-                    case 'BETWEEN':
540
-                        $bindings = array_merge($bindings, $statement['value']);
541
-                        $criteria .= sprintf(
542
-                            ' %s AND %s ',
543
-                            $this->getType($value[0]),
544
-                            $this->getType($value[1])
545
-                        );
546
-
547
-                        // Maybe cast the values bindings.
548
-                        $value[0] = $this->getValue($value[0]);
549
-                        $value[1] = $this->getValue($value[1]);
550
-
551
-                        // Parse any raws.
552
-                        $value = array_map(function ($value) {
553
-                            return $value instanceof Raw
554
-                                ? $this->parseRaw($value)
555
-                                : $value;
556
-                        }, $value);
557
-                        break;
558
-                    default:
559
-                        $valuePlaceholder = '';
560
-                        foreach ($statement['value'] as $subValue) {
561
-                            // Get its value.
562
-                            if ($this->getValue($subValue) instanceof Raw) {
563
-                                /** @var Raw $subValue */
564
-                                $subValue = $this->getValue($subValue);
565
-                                $valuePlaceholder .= sprintf('%s, ', $this->parseRaw($subValue));
566
-                                continue;
567
-                            }
568
-
569
-
570
-                            // Add in format placeholders.
571
-                            $valuePlaceholder .= sprintf('%s, ', $this->getType($subValue)); // glynn
572
-                            $bindings[] = $this->getValue($subValue);
573
-                        }
574
-
575
-                        $valuePlaceholder = trim($valuePlaceholder, ', ');
576
-                        $criteria .= ' (' . $valuePlaceholder . ') ';
577
-                        break;
578
-                }
579
-            } elseif ($value instanceof Raw) {
580
-                $value = $this->parseRaw($value);
581
-                $criteria .= "{$statement['joiner']} {$key} {$statement['operator']} $value ";
582
-            } else {
583
-                // Usual where like criteria
584
-                if (!$bindValues) {
585
-                    // Specially for joins
586
-                    // We are not binding values, lets sanitize then
587
-                    $value = $this->stringifyValue($this->wrapSanitizer($value)) ?? '';
588
-                    $criteria .= $statement['joiner'] . ' ' . $key . ' ' . $statement['operator'] . ' ' . $value . ' ';
589
-                } elseif ($statement['key'] instanceof Raw) {
590
-                    $criteria .= $statement['joiner'] . ' ' . $key . ' ';
591
-                    $bindings = array_merge($bindings, $statement['key']->getBindings());
592
-                } else {
593
-                    // For wheres
594
-                    $bindings[] = $this->getValue($value);
595
-
596
-                    $criteria .= $statement['joiner'] . ' ' . $key . ' ' . $statement['operator'] . ' '
597
-                    . $this->getType($value) . ' ';
598
-                }
599
-            }
600
-        }
601
-
602
-        // Clear all white spaces, and, or from beginning and white spaces from ending
603
-        $criteria = preg_replace('/^(\s?AND ?|\s?OR ?)|\s$/i', '', $criteria);
604
-
605
-        return [$criteria ?? '', $bindings];
606
-    }
607
-
608
-    /**
609
-     * Asserts the types place holder based on its value
610
-     *
611
-     * @param mixed $value
612
-     *
613
-     * @return string
614
-     */
615
-    public function inferType($value): string
616
-    {
617
-        switch (true) {
618
-            case is_string($value):
619
-                return '%s';
620
-            case \is_int($value):
621
-            case is_bool($value):
622
-                return '%d';
623
-            case is_float($value):
624
-                return '%f';
625
-            default:
626
-                return '';
627
-        }
628
-    }
629
-
630
-    /**
631
-     * Wrap values with adapter's sanitizer like, '`'
632
-     *
633
-     * @param string|Raw|Closure $value
634
-     *
635
-     * @return string|Closure
636
-     */
637
-    public function wrapSanitizer($value)
638
-    {
639
-        // Its a raw query, just cast as string, object has __toString()
640
-        if ($value instanceof Raw) {
641
-            return $this->parseRaw($value);
642
-        } elseif ($value instanceof Closure) {
643
-            return $value;
644
-        }
645
-
646
-        // Separate our table and fields which are joined with a ".",
647
-        // like my_table.id
648
-        $valueArr = explode('.', $value, 2);
649
-
650
-        foreach ($valueArr as $key => $subValue) {
651
-            // Don't wrap if we have *, which is not a usual field
652
-            $valueArr[$key] = '*' == trim($subValue) ? $subValue : $this->sanitizer . $subValue . $this->sanitizer;
653
-        }
654
-
655
-        // Join these back with "." and return
656
-        return implode('.', $valueArr);
657
-    }
658
-
659
-    /**
660
-     * Build criteria string and binding with various types added, like WHERE and Having
661
-     *
662
-     * @param array<string|Closure, mixed|mixed[]> $statements
663
-     * @param string $key
664
-     * @param string $type
665
-     * @param bool $bindValues
666
-     *
667
-     * @return array{0:string, 1:string[]}
668
-     */
669
-    protected function buildCriteriaWithType(array $statements, string $key, string $type, bool $bindValues = true)
670
-    {
671
-        $criteria = '';
672
-        $bindings = [];
673
-
674
-        if (isset($statements[$key])) {
675
-            // Get the generic/adapter agnostic criteria string from parent
676
-            list($criteria, $bindings) = $this->buildCriteria($statements[$key], $bindValues);
677
-
678
-            if ($criteria) {
679
-                $criteria = $type . ' ' . $criteria;
680
-            }
681
-        }
682
-
683
-        // Remove any multiple whitespace.
684
-        $criteria = (string) preg_replace('!\s+!', ' ', $criteria);
685
-
686
-        return [$criteria, $bindings];
687
-    }
688
-
689
-    /**
690
-     * Build join string
691
-     *
692
-     * @param array<string|Closure, mixed|mixed[]> $statements
693
-     *
694
-     * @return string
695
-     */
696
-    protected function buildJoin(array $statements): string
697
-    {
698
-        $sql = '';
699
-
700
-        if (!array_key_exists('joins', $statements) || !is_array($statements['joins'])) {
701
-            return $sql;
702
-        }
703
-
704
-        foreach ($statements['joins'] as $joinArr) {
705
-            if (is_array($joinArr['table'])) {
706
-                $mainTable  = $this->stringifyValue($this->wrapSanitizer($joinArr['table'][0]));
707
-                $aliasTable = $this->stringifyValue($this->wrapSanitizer($joinArr['table'][1]));
708
-                $table      = $mainTable . ' AS ' . $aliasTable;
709
-            } else {
710
-                $table = $joinArr['table'] instanceof Raw
711
-                    ? $this->parseRaw($joinArr['table'])
712
-                    : $this->wrapSanitizer($joinArr['table']);
713
-            }
714
-            $joinBuilder = $joinArr['joinBuilder'];
715
-
716
-            /** @var string[] */
717
-            $sqlArr = [
718
-                $sql,
719
-                strtoupper($joinArr['type']),
720
-                'JOIN',
721
-                $table,
722
-                'ON',
723
-                $joinBuilder->getQuery('criteriaOnly', false)->getSql(),
724
-            ];
725
-
726
-            $sql = $this->concatenateQuery($sqlArr);
727
-        }
728
-
729
-        return $sql;
730
-    }
20
+	/**
21
+	 * @var string
22
+	 */
23
+	protected $sanitizer = '';
24
+
25
+	/**
26
+	 * @var \Pixie\Connection
27
+	 */
28
+	protected $connection;
29
+
30
+	/**
31
+	 * @var \Viocon\Container
32
+	 */
33
+	protected $container;
34
+
35
+	public function __construct(Connection $connection)
36
+	{
37
+		$this->connection = $connection;
38
+		$this->container  = $this->connection->getContainer();
39
+	}
40
+
41
+	/**
42
+	 * Build select query string and bindings
43
+	 *
44
+	 * @param array<string|Closure, mixed|mixed[]> $statements
45
+	 *
46
+	 * @throws Exception
47
+	 *
48
+	 * @return array{sql:string,bindings:mixed[]}
49
+	 */
50
+	public function select(array $statements): array
51
+	{
52
+		if (!array_key_exists('tables', $statements)) {
53
+			throw new Exception('No table specified.', 3);
54
+		} elseif (!array_key_exists('selects', $statements)) {
55
+			$statements['selects'][] = '*';
56
+		}
57
+
58
+		// From
59
+		$tables = $this->arrayStr($statements['tables'], ', ');
60
+		// Select
61
+		$selects = $this->arrayStr($statements['selects'], ', ');
62
+
63
+		// Wheres
64
+		list($whereCriteria, $whereBindings) = $this->buildCriteriaWithType($statements, 'wheres', 'WHERE');
65
+
66
+		// Group bys
67
+		$groupBys = '';
68
+		if (isset($statements['groupBys']) && $groupBys = $this->arrayStr($statements['groupBys'], ', ')) {
69
+			$groupBys = 'GROUP BY ' . $groupBys;
70
+		}
71
+
72
+		// Order bys
73
+		$orderBys = '';
74
+		if (isset($statements['orderBys']) && is_array($statements['orderBys'])) {
75
+			foreach ($statements['orderBys'] as $orderBy) {
76
+				$field = $this->wrapSanitizer($orderBy['field']);
77
+				if ($field instanceof Closure) {
78
+					continue;
79
+				}
80
+				$orderBys .= $field . ' ' . $orderBy['type'] . ', ';
81
+			}
82
+
83
+			if ($orderBys = trim($orderBys, ', ')) {
84
+				$orderBys = 'ORDER BY ' . $orderBys;
85
+			}
86
+		}
87
+
88
+		// Limit and offset
89
+		$limit  = isset($statements['limit']) ? 'LIMIT ' . (int) $statements['limit'] : '';
90
+		$offset = isset($statements['offset']) ? 'OFFSET ' . (int) $statements['offset'] : '';
91
+
92
+		// Having
93
+		list($havingCriteria, $havingBindings) = $this->buildCriteriaWithType($statements, 'havings', 'HAVING');
94
+
95
+		// Joins
96
+		$joinString = $this->buildJoin($statements);
97
+
98
+		/** @var string[] */
99
+		$sqlArray = [
100
+			'SELECT' . (isset($statements['distinct']) ? ' DISTINCT' : ''),
101
+			$selects,
102
+			'FROM',
103
+			$tables,
104
+			$joinString,
105
+			$whereCriteria,
106
+			$groupBys,
107
+			$havingCriteria,
108
+			$orderBys,
109
+			$limit,
110
+			$offset,
111
+		];
112
+
113
+		$sql = $this->concatenateQuery($sqlArray);
114
+
115
+		$bindings = array_merge(
116
+			$whereBindings,
117
+			$havingBindings
118
+		);
119
+
120
+		return compact('sql', 'bindings');
121
+	}
122
+
123
+	/**
124
+	 * Build just criteria part of the query
125
+	 *
126
+	 * @param array<string|Closure, mixed|mixed[]> $statements
127
+	 * @param bool $bindValues
128
+	 *
129
+	 * @return array{sql:string[]|string, bindings:array<mixed>}
130
+	 */
131
+	public function criteriaOnly(array $statements, bool $bindValues = true): array
132
+	{
133
+		$sql = $bindings = [];
134
+		if (!isset($statements['criteria'])) {
135
+			return compact('sql', 'bindings');
136
+		}
137
+
138
+		list($sql, $bindings) = $this->buildCriteria($statements['criteria'], $bindValues);
139
+
140
+		return compact('sql', 'bindings');
141
+	}
142
+
143
+	/**
144
+	 * Build a generic insert/ignore/replace query
145
+	 *
146
+	 * @param array<string|Closure, mixed|mixed[]> $statements
147
+	 * @param array<string, mixed> $data
148
+	 * @param string $type
149
+	 *
150
+	 * @return array{sql:string, bindings:mixed[]}
151
+	 *
152
+	 * @throws Exception
153
+	 */
154
+	private function doInsert(array $statements, array $data, string $type): array
155
+	{
156
+		if (!isset($statements['tables'])) {
157
+			throw new Exception('No table specified', 3);
158
+		}
159
+
160
+		$table = end($statements['tables']);
161
+
162
+		$bindings = $keys = $values = [];
163
+
164
+		foreach ($data as $key => $value) {
165
+			$keys[] = $key;
166
+
167
+			// Handle value as bindings
168
+			$isBindings = $value instanceof Binding;
169
+			// If this is a raw binding, extract the Raw and replace value.
170
+			if ($isBindings && $value->isRaw()) {
171
+				$value = $value->getValue();
172
+			}
173
+
174
+			if ($value instanceof Raw) {
175
+				$values[] = $this->parseRaw($value);
176
+			} elseif ($isBindings) {
177
+				$values[]   =  $value->getType();
178
+				$bindings[] = $value->getValue();
179
+			} else {
180
+				$values[]   =  $this->inferType($value);
181
+				$bindings[] = $value;
182
+			}
183
+		}
184
+
185
+		$sqlArray = [
186
+		$type . ' INTO',
187
+		$this->wrapSanitizer($table),
188
+		'(' . $this->arrayStr($keys, ',') . ')',
189
+		'VALUES',
190
+		'(' . $this->arrayStr($values, ',') . ')',
191
+		];
192
+
193
+		if (isset($statements['onduplicate'])) {
194
+			if (count($statements['onduplicate']) < 1) {
195
+				throw new Exception('No data given.', 4);
196
+			}
197
+			list($updateStatement, $updateBindings) = $this->getUpdateStatement($statements['onduplicate']);
198
+			$sqlArray[]                             = 'ON DUPLICATE KEY UPDATE ' . $updateStatement;
199
+			$bindings                               = array_merge($bindings, $updateBindings);
200
+		}
201
+
202
+		$sql = $this->concatenateQuery($this->stringifyValues($sqlArray));
203
+
204
+		return compact('sql', 'bindings');
205
+	}
206
+
207
+	/**
208
+	 * Attempts to stringify an array of values.
209
+	 *
210
+	 * @param array<string|int, string|Closure> $values
211
+	 *
212
+	 * @return string[]
213
+	 */
214
+	protected function stringifyValues(array $values): array
215
+	{
216
+		return array_filter(array_map([$this, 'stringifyValue'], $values));
217
+	}
218
+
219
+	/**
220
+	 * Attempts to stringify a single of values.
221
+	 *
222
+	 * @param string|Closure|Raw $value
223
+	 *
224
+	 * @return string|null
225
+	 */
226
+	protected function stringifyValue($value): ?string
227
+	{
228
+		if ($value instanceof Closure) {
229
+			$value = $value();
230
+
231
+			return is_string($value) ? $value : null;
232
+		}
233
+
234
+		if ($value instanceof Raw) {
235
+			return $this->parseRaw($value);
236
+		}
237
+
238
+		return $value;
239
+	}
240
+
241
+	/**
242
+	 * Build Insert query
243
+	 *
244
+	 * @param array<string|Closure, mixed|mixed[]> $statements
245
+	 * @param array<string, mixed> $data $data
246
+	 *
247
+	 * @return array{sql:string, bindings:mixed[]}
248
+	 *
249
+	 * @throws Exception
250
+	 */
251
+	public function insert($statements, array $data)
252
+	{
253
+		return $this->doInsert($statements, $data, 'INSERT');
254
+	}
255
+
256
+	/**
257
+	 * Build Insert Ignore query
258
+	 *
259
+	 * @param array<string|Closure, mixed|mixed[]> $statements
260
+	 * @param array<string, mixed> $data $data
261
+	 *
262
+	 * @return array{sql:string, bindings:mixed[]}
263
+	 *
264
+	 * @throws Exception
265
+	 */
266
+	public function insertIgnore($statements, array $data)
267
+	{
268
+		return $this->doInsert($statements, $data, 'INSERT IGNORE');
269
+	}
270
+
271
+	/**
272
+	 * Build Insert Ignore query
273
+	 *
274
+	 * @param array<string|Closure, mixed|mixed[]> $statements
275
+	 * @param array<string, mixed> $data $data
276
+	 *
277
+	 * @return array{sql:string, bindings:mixed[]}
278
+	 *
279
+	 * @throws Exception
280
+	 */
281
+	public function replace($statements, array $data)
282
+	{
283
+		return $this->doInsert($statements, $data, 'REPLACE');
284
+	}
285
+
286
+	/**
287
+	 * Build fields assignment part of SET ... or ON DUBLICATE KEY UPDATE ... statements
288
+	 *
289
+	 * @param array<string, mixed> $data
290
+	 *
291
+	 * @return array{0:string,1:mixed[]}
292
+	 */
293
+	private function getUpdateStatement(array $data): array
294
+	{
295
+		$bindings  = [];
296
+		$statement = '';
297
+
298
+		foreach ($data as $key => $value) {
299
+			$isBindings = $value instanceof Binding;
300
+			// If this is a raw binding, extract the Raw and replace value.
301
+			if ($isBindings && $value->isRaw()) {
302
+				$value = $value->getValue();
303
+			}
304
+
305
+			if ($value instanceof Raw) {
306
+				$statement .= $this->stringifyValue($this->wrapSanitizer($key)) . '=' . $value . ',';
307
+			} elseif ($isBindings) {
308
+				$statement .= $this->stringifyValue($this->wrapSanitizer($key)) . sprintf('=%s,', $value->getType());
309
+				$bindings[] = $value->getValue();
310
+			} else {
311
+				$statement .= $this->stringifyValue($this->wrapSanitizer($key)) . sprintf('=%s,', $this->inferType($value));
312
+				$bindings[] = $value;
313
+			}
314
+		}
315
+
316
+		$statement = trim($statement, ',');
317
+
318
+		return [$statement, $bindings];
319
+	}
320
+
321
+	/**
322
+	 * Build update query
323
+	 *
324
+	 * @param array<string|Closure, mixed|mixed[]> $statements
325
+	 * @param array<string, mixed> $data
326
+	 *
327
+	 * @return array{sql:string, bindings:mixed[]}
328
+	 *
329
+	 * @throws Exception
330
+	 */
331
+	public function update($statements, array $data)
332
+	{
333
+		if (!isset($statements['tables'])) {
334
+			throw new Exception('No table specified', 3);
335
+		} elseif (count($data) < 1) {
336
+			throw new Exception('No data given.', 4);
337
+		}
338
+
339
+		$table = end($statements['tables']);
340
+
341
+		// Update statement
342
+		list($updateStatement, $bindings) = $this->getUpdateStatement($data);
343
+
344
+		// Wheres
345
+		list($whereCriteria, $whereBindings) = $this->buildCriteriaWithType($statements, 'wheres', 'WHERE');
346
+
347
+		// Limit
348
+		$limit = isset($statements['limit']) ? 'LIMIT ' . $statements['limit'] : '';
349
+
350
+		$sqlArray = [
351
+			'UPDATE',
352
+			$this->wrapSanitizer($table),
353
+			'SET ' . $updateStatement,
354
+			$whereCriteria,
355
+			$limit,
356
+		];
357
+
358
+		$sql = $this->concatenateQuery($this->stringifyValues($sqlArray));
359
+
360
+		$bindings = array_merge($bindings, $whereBindings);
361
+
362
+		return compact('sql', 'bindings');
363
+	}
364
+
365
+	/**
366
+	 * Build delete query
367
+	 *
368
+	 * @param array<string|Closure, mixed|mixed[]> $statements
369
+	 *
370
+	 * @return array{sql:string, bindings:mixed[]}
371
+	 *
372
+	 * @throws Exception
373
+	 */
374
+	public function delete($statements)
375
+	{
376
+		if (!isset($statements['tables'])) {
377
+			throw new Exception('No table specified', 3);
378
+		}
379
+
380
+		$table = end($statements['tables']);
381
+		// Ensure table name is a string
382
+		$table = $this->stringifyValue($this->wrapSanitizer($table));
383
+		if (null === $table) {
384
+			throw new Exception('Table must be a valid string.', 5);
385
+		}
386
+
387
+		// Wheres
388
+		list($whereCriteria, $whereBindings) = $this->buildCriteriaWithType($statements, 'wheres', 'WHERE');
389
+
390
+		// Limit
391
+		$limit = isset($statements['limit']) ? 'LIMIT ' . $statements['limit'] : '';
392
+
393
+		$sqlArray = ['DELETE FROM', $table, $whereCriteria];
394
+		$sql      = $this->concatenateQuery($sqlArray);
395
+		$bindings = $whereBindings;
396
+
397
+		return compact('sql', 'bindings');
398
+	}
399
+
400
+	/**
401
+	 * Array concatenating method, like implode.
402
+	 * But it does wrap sanitizer and trims last glue
403
+	 *
404
+	 * @param array<string|int, string> $pieces
405
+	 * @param string $glue
406
+	 *
407
+	 * @return string
408
+	 */
409
+	protected function arrayStr(array $pieces, string $glue): string
410
+	{
411
+		$str = '';
412
+		foreach ($pieces as $key => $piece) {
413
+			if (!is_int($key)) {
414
+				$piece = $key . ' AS ' . $piece;
415
+			}
416
+
417
+			$str .= $piece . $glue;
418
+		}
419
+
420
+		return trim($str, $glue);
421
+	}
422
+
423
+	/**
424
+	 * Join different part of queries with a space.
425
+	 *
426
+	 * @param array<string|int, string> $pieces
427
+	 *
428
+	 * @return string
429
+	 */
430
+	protected function concatenateQuery(array $pieces): string
431
+	{
432
+		$str = '';
433
+		foreach ($pieces as $piece) {
434
+			$str = trim($str) . ' ' . trim($piece);
435
+		}
436
+
437
+		return trim($str);
438
+	}
439
+
440
+	/**
441
+	 * Gets the type of a value, either from a binding or infered
442
+	 *
443
+	 * @param mixed $value
444
+	 * @return string
445
+	 */
446
+	public function getType($value): string
447
+	{
448
+		return $value instanceof Binding && $value->getType() !== null
449
+			? $value->getType() : $this->inferType($value) ;
450
+	}
451
+
452
+	/**
453
+	 * Get the value from a possible Bindings object.
454
+	 *
455
+	 * @param mixed $value
456
+	 * @return mixed
457
+	 */
458
+	public function getValue($value)
459
+	{
460
+		return $value instanceof Binding ? $value->getValue() : $value;
461
+	}
462
+
463
+	/**
464
+	 * Attempts to parse a raw query, if bindings are defined then they will be bound first.
465
+	 *
466
+	 * @param Raw $raw
467
+	 * @requires string
468
+	 */
469
+	public function parseRaw(Raw $raw): string
470
+	{
471
+		$bindings = $raw->getBindings();
472
+		return 0 === count($bindings)
473
+			? (string) $raw
474
+			: $this->interpolateQuery($raw->getValue(), $bindings);
475
+	}
476
+
477
+	/**
478
+	 * Interpolates a query
479
+	 *
480
+	 * @param string $query
481
+	 * @param array<mixed> $bindings
482
+	 * @return string
483
+	 */
484
+	public function interpolateQuery(string $query, array $bindings = []): string
485
+	{
486
+		if (0 === count($bindings)) {
487
+			return $query;
488
+		}
489
+
490
+
491
+		$bindings = array_map([$this, 'getValue'], $bindings);
492
+		$query = $this->connection->getDbInstance()->prepare($query, $bindings) ;
493
+		return is_string($query) ? $query : '';
494
+	}
495
+
496
+	/**
497
+	 * Build generic criteria string and bindings from statements, like "a = b and c = ?"
498
+	 *
499
+	 * @param array<string|Closure, mixed|mixed[]> $statements
500
+	 * @param bool $bindValues
501
+	 *
502
+	 * @return array{0:string,1:string[]}
503
+	 */
504
+	protected function buildCriteria(array $statements, bool $bindValues = true): array
505
+	{
506
+		$criteria = '';
507
+		$bindings = [];
508
+		foreach ($statements as $statement) {
509
+			$key   = $statement['key'];
510
+			$value = $statement['value'];
511
+
512
+			// If the value is a Raw Binding, cast to raw
513
+			if ($value instanceof Binding && Binding::RAW === $value->getType()) {
514
+				/** @var Raw */
515
+				$value = $value->getValue();
516
+			}
517
+
518
+			if (is_null($value) && $key instanceof Closure) {
519
+				// We have a closure, a nested criteria
520
+
521
+				// Build a new NestedCriteria class, keep it by reference so any changes made
522
+				// in the closure should reflect here
523
+				$nestedCriteria = $this->container->build(NestedCriteria::class, [$this->connection]);
524
+
525
+				$nestedCriteria = &$nestedCriteria;
526
+				// Call the closure with our new nestedCriteria object
527
+				$key($nestedCriteria);
528
+				// Get the criteria only query from the nestedCriteria object
529
+				$queryObject = $nestedCriteria->getQuery('criteriaOnly', true);
530
+				// Merge the bindings we get from nestedCriteria object
531
+				$bindings = array_merge($bindings, $queryObject->getBindings());
532
+				// Append the sql we get from the nestedCriteria object
533
+				$criteria .= $statement['joiner'] . ' (' . $queryObject->getSql() . ') ';
534
+			} elseif (is_array($value)) {
535
+				// where_in or between like query
536
+				$criteria .= $statement['joiner'] . ' ' . $key . ' ' . $statement['operator'];
537
+
538
+				switch ($statement['operator']) {
539
+					case 'BETWEEN':
540
+						$bindings = array_merge($bindings, $statement['value']);
541
+						$criteria .= sprintf(
542
+							' %s AND %s ',
543
+							$this->getType($value[0]),
544
+							$this->getType($value[1])
545
+						);
546
+
547
+						// Maybe cast the values bindings.
548
+						$value[0] = $this->getValue($value[0]);
549
+						$value[1] = $this->getValue($value[1]);
550
+
551
+						// Parse any raws.
552
+						$value = array_map(function ($value) {
553
+							return $value instanceof Raw
554
+								? $this->parseRaw($value)
555
+								: $value;
556
+						}, $value);
557
+						break;
558
+					default:
559
+						$valuePlaceholder = '';
560
+						foreach ($statement['value'] as $subValue) {
561
+							// Get its value.
562
+							if ($this->getValue($subValue) instanceof Raw) {
563
+								/** @var Raw $subValue */
564
+								$subValue = $this->getValue($subValue);
565
+								$valuePlaceholder .= sprintf('%s, ', $this->parseRaw($subValue));
566
+								continue;
567
+							}
568
+
569
+
570
+							// Add in format placeholders.
571
+							$valuePlaceholder .= sprintf('%s, ', $this->getType($subValue)); // glynn
572
+							$bindings[] = $this->getValue($subValue);
573
+						}
574
+
575
+						$valuePlaceholder = trim($valuePlaceholder, ', ');
576
+						$criteria .= ' (' . $valuePlaceholder . ') ';
577
+						break;
578
+				}
579
+			} elseif ($value instanceof Raw) {
580
+				$value = $this->parseRaw($value);
581
+				$criteria .= "{$statement['joiner']} {$key} {$statement['operator']} $value ";
582
+			} else {
583
+				// Usual where like criteria
584
+				if (!$bindValues) {
585
+					// Specially for joins
586
+					// We are not binding values, lets sanitize then
587
+					$value = $this->stringifyValue($this->wrapSanitizer($value)) ?? '';
588
+					$criteria .= $statement['joiner'] . ' ' . $key . ' ' . $statement['operator'] . ' ' . $value . ' ';
589
+				} elseif ($statement['key'] instanceof Raw) {
590
+					$criteria .= $statement['joiner'] . ' ' . $key . ' ';
591
+					$bindings = array_merge($bindings, $statement['key']->getBindings());
592
+				} else {
593
+					// For wheres
594
+					$bindings[] = $this->getValue($value);
595
+
596
+					$criteria .= $statement['joiner'] . ' ' . $key . ' ' . $statement['operator'] . ' '
597
+					. $this->getType($value) . ' ';
598
+				}
599
+			}
600
+		}
601
+
602
+		// Clear all white spaces, and, or from beginning and white spaces from ending
603
+		$criteria = preg_replace('/^(\s?AND ?|\s?OR ?)|\s$/i', '', $criteria);
604
+
605
+		return [$criteria ?? '', $bindings];
606
+	}
607
+
608
+	/**
609
+	 * Asserts the types place holder based on its value
610
+	 *
611
+	 * @param mixed $value
612
+	 *
613
+	 * @return string
614
+	 */
615
+	public function inferType($value): string
616
+	{
617
+		switch (true) {
618
+			case is_string($value):
619
+				return '%s';
620
+			case \is_int($value):
621
+			case is_bool($value):
622
+				return '%d';
623
+			case is_float($value):
624
+				return '%f';
625
+			default:
626
+				return '';
627
+		}
628
+	}
629
+
630
+	/**
631
+	 * Wrap values with adapter's sanitizer like, '`'
632
+	 *
633
+	 * @param string|Raw|Closure $value
634
+	 *
635
+	 * @return string|Closure
636
+	 */
637
+	public function wrapSanitizer($value)
638
+	{
639
+		// Its a raw query, just cast as string, object has __toString()
640
+		if ($value instanceof Raw) {
641
+			return $this->parseRaw($value);
642
+		} elseif ($value instanceof Closure) {
643
+			return $value;
644
+		}
645
+
646
+		// Separate our table and fields which are joined with a ".",
647
+		// like my_table.id
648
+		$valueArr = explode('.', $value, 2);
649
+
650
+		foreach ($valueArr as $key => $subValue) {
651
+			// Don't wrap if we have *, which is not a usual field
652
+			$valueArr[$key] = '*' == trim($subValue) ? $subValue : $this->sanitizer . $subValue . $this->sanitizer;
653
+		}
654
+
655
+		// Join these back with "." and return
656
+		return implode('.', $valueArr);
657
+	}
658
+
659
+	/**
660
+	 * Build criteria string and binding with various types added, like WHERE and Having
661
+	 *
662
+	 * @param array<string|Closure, mixed|mixed[]> $statements
663
+	 * @param string $key
664
+	 * @param string $type
665
+	 * @param bool $bindValues
666
+	 *
667
+	 * @return array{0:string, 1:string[]}
668
+	 */
669
+	protected function buildCriteriaWithType(array $statements, string $key, string $type, bool $bindValues = true)
670
+	{
671
+		$criteria = '';
672
+		$bindings = [];
673
+
674
+		if (isset($statements[$key])) {
675
+			// Get the generic/adapter agnostic criteria string from parent
676
+			list($criteria, $bindings) = $this->buildCriteria($statements[$key], $bindValues);
677
+
678
+			if ($criteria) {
679
+				$criteria = $type . ' ' . $criteria;
680
+			}
681
+		}
682
+
683
+		// Remove any multiple whitespace.
684
+		$criteria = (string) preg_replace('!\s+!', ' ', $criteria);
685
+
686
+		return [$criteria, $bindings];
687
+	}
688
+
689
+	/**
690
+	 * Build join string
691
+	 *
692
+	 * @param array<string|Closure, mixed|mixed[]> $statements
693
+	 *
694
+	 * @return string
695
+	 */
696
+	protected function buildJoin(array $statements): string
697
+	{
698
+		$sql = '';
699
+
700
+		if (!array_key_exists('joins', $statements) || !is_array($statements['joins'])) {
701
+			return $sql;
702
+		}
703
+
704
+		foreach ($statements['joins'] as $joinArr) {
705
+			if (is_array($joinArr['table'])) {
706
+				$mainTable  = $this->stringifyValue($this->wrapSanitizer($joinArr['table'][0]));
707
+				$aliasTable = $this->stringifyValue($this->wrapSanitizer($joinArr['table'][1]));
708
+				$table      = $mainTable . ' AS ' . $aliasTable;
709
+			} else {
710
+				$table = $joinArr['table'] instanceof Raw
711
+					? $this->parseRaw($joinArr['table'])
712
+					: $this->wrapSanitizer($joinArr['table']);
713
+			}
714
+			$joinBuilder = $joinArr['joinBuilder'];
715
+
716
+			/** @var string[] */
717
+			$sqlArr = [
718
+				$sql,
719
+				strtoupper($joinArr['type']),
720
+				'JOIN',
721
+				$table,
722
+				'ON',
723
+				$joinBuilder->getQuery('criteriaOnly', false)->getSql(),
724
+			];
725
+
726
+			$sql = $this->concatenateQuery($sqlArr);
727
+		}
728
+
729
+		return $sql;
730
+	}
731 731
 }
Please login to merge, or discard this patch.
Spacing   +43 added lines, -43 removed lines patch added patch discarded remove patch
@@ -49,9 +49,9 @@  discard block
 block discarded – undo
49 49
      */
50 50
     public function select(array $statements): array
51 51
     {
52
-        if (!array_key_exists('tables', $statements)) {
52
+        if ( ! array_key_exists('tables', $statements)) {
53 53
             throw new Exception('No table specified.', 3);
54
-        } elseif (!array_key_exists('selects', $statements)) {
54
+        } elseif ( ! array_key_exists('selects', $statements)) {
55 55
             $statements['selects'][] = '*';
56 56
         }
57 57
 
@@ -66,7 +66,7 @@  discard block
 block discarded – undo
66 66
         // Group bys
67 67
         $groupBys = '';
68 68
         if (isset($statements['groupBys']) && $groupBys = $this->arrayStr($statements['groupBys'], ', ')) {
69
-            $groupBys = 'GROUP BY ' . $groupBys;
69
+            $groupBys = 'GROUP BY '.$groupBys;
70 70
         }
71 71
 
72 72
         // Order bys
@@ -77,17 +77,17 @@  discard block
 block discarded – undo
77 77
                 if ($field instanceof Closure) {
78 78
                     continue;
79 79
                 }
80
-                $orderBys .= $field . ' ' . $orderBy['type'] . ', ';
80
+                $orderBys .= $field.' '.$orderBy['type'].', ';
81 81
             }
82 82
 
83 83
             if ($orderBys = trim($orderBys, ', ')) {
84
-                $orderBys = 'ORDER BY ' . $orderBys;
84
+                $orderBys = 'ORDER BY '.$orderBys;
85 85
             }
86 86
         }
87 87
 
88 88
         // Limit and offset
89
-        $limit  = isset($statements['limit']) ? 'LIMIT ' . (int) $statements['limit'] : '';
90
-        $offset = isset($statements['offset']) ? 'OFFSET ' . (int) $statements['offset'] : '';
89
+        $limit  = isset($statements['limit']) ? 'LIMIT '.(int) $statements['limit'] : '';
90
+        $offset = isset($statements['offset']) ? 'OFFSET '.(int) $statements['offset'] : '';
91 91
 
92 92
         // Having
93 93
         list($havingCriteria, $havingBindings) = $this->buildCriteriaWithType($statements, 'havings', 'HAVING');
@@ -97,7 +97,7 @@  discard block
 block discarded – undo
97 97
 
98 98
         /** @var string[] */
99 99
         $sqlArray = [
100
-            'SELECT' . (isset($statements['distinct']) ? ' DISTINCT' : ''),
100
+            'SELECT'.(isset($statements['distinct']) ? ' DISTINCT' : ''),
101 101
             $selects,
102 102
             'FROM',
103 103
             $tables,
@@ -131,7 +131,7 @@  discard block
 block discarded – undo
131 131
     public function criteriaOnly(array $statements, bool $bindValues = true): array
132 132
     {
133 133
         $sql = $bindings = [];
134
-        if (!isset($statements['criteria'])) {
134
+        if ( ! isset($statements['criteria'])) {
135 135
             return compact('sql', 'bindings');
136 136
         }
137 137
 
@@ -153,7 +153,7 @@  discard block
 block discarded – undo
153 153
      */
154 154
     private function doInsert(array $statements, array $data, string $type): array
155 155
     {
156
-        if (!isset($statements['tables'])) {
156
+        if ( ! isset($statements['tables'])) {
157 157
             throw new Exception('No table specified', 3);
158 158
         }
159 159
 
@@ -174,20 +174,20 @@  discard block
 block discarded – undo
174 174
             if ($value instanceof Raw) {
175 175
                 $values[] = $this->parseRaw($value);
176 176
             } elseif ($isBindings) {
177
-                $values[]   =  $value->getType();
177
+                $values[]   = $value->getType();
178 178
                 $bindings[] = $value->getValue();
179 179
             } else {
180
-                $values[]   =  $this->inferType($value);
180
+                $values[]   = $this->inferType($value);
181 181
                 $bindings[] = $value;
182 182
             }
183 183
         }
184 184
 
185 185
         $sqlArray = [
186
-        $type . ' INTO',
186
+        $type.' INTO',
187 187
         $this->wrapSanitizer($table),
188
-        '(' . $this->arrayStr($keys, ',') . ')',
188
+        '('.$this->arrayStr($keys, ',').')',
189 189
         'VALUES',
190
-        '(' . $this->arrayStr($values, ',') . ')',
190
+        '('.$this->arrayStr($values, ',').')',
191 191
         ];
192 192
 
193 193
         if (isset($statements['onduplicate'])) {
@@ -195,7 +195,7 @@  discard block
 block discarded – undo
195 195
                 throw new Exception('No data given.', 4);
196 196
             }
197 197
             list($updateStatement, $updateBindings) = $this->getUpdateStatement($statements['onduplicate']);
198
-            $sqlArray[]                             = 'ON DUPLICATE KEY UPDATE ' . $updateStatement;
198
+            $sqlArray[]                             = 'ON DUPLICATE KEY UPDATE '.$updateStatement;
199 199
             $bindings                               = array_merge($bindings, $updateBindings);
200 200
         }
201 201
 
@@ -303,12 +303,12 @@  discard block
 block discarded – undo
303 303
             }
304 304
 
305 305
             if ($value instanceof Raw) {
306
-                $statement .= $this->stringifyValue($this->wrapSanitizer($key)) . '=' . $value . ',';
306
+                $statement .= $this->stringifyValue($this->wrapSanitizer($key)).'='.$value.',';
307 307
             } elseif ($isBindings) {
308
-                $statement .= $this->stringifyValue($this->wrapSanitizer($key)) . sprintf('=%s,', $value->getType());
308
+                $statement .= $this->stringifyValue($this->wrapSanitizer($key)).sprintf('=%s,', $value->getType());
309 309
                 $bindings[] = $value->getValue();
310 310
             } else {
311
-                $statement .= $this->stringifyValue($this->wrapSanitizer($key)) . sprintf('=%s,', $this->inferType($value));
311
+                $statement .= $this->stringifyValue($this->wrapSanitizer($key)).sprintf('=%s,', $this->inferType($value));
312 312
                 $bindings[] = $value;
313 313
             }
314 314
         }
@@ -330,7 +330,7 @@  discard block
 block discarded – undo
330 330
      */
331 331
     public function update($statements, array $data)
332 332
     {
333
-        if (!isset($statements['tables'])) {
333
+        if ( ! isset($statements['tables'])) {
334 334
             throw new Exception('No table specified', 3);
335 335
         } elseif (count($data) < 1) {
336 336
             throw new Exception('No data given.', 4);
@@ -345,12 +345,12 @@  discard block
 block discarded – undo
345 345
         list($whereCriteria, $whereBindings) = $this->buildCriteriaWithType($statements, 'wheres', 'WHERE');
346 346
 
347 347
         // Limit
348
-        $limit = isset($statements['limit']) ? 'LIMIT ' . $statements['limit'] : '';
348
+        $limit = isset($statements['limit']) ? 'LIMIT '.$statements['limit'] : '';
349 349
 
350 350
         $sqlArray = [
351 351
             'UPDATE',
352 352
             $this->wrapSanitizer($table),
353
-            'SET ' . $updateStatement,
353
+            'SET '.$updateStatement,
354 354
             $whereCriteria,
355 355
             $limit,
356 356
         ];
@@ -373,7 +373,7 @@  discard block
 block discarded – undo
373 373
      */
374 374
     public function delete($statements)
375 375
     {
376
-        if (!isset($statements['tables'])) {
376
+        if ( ! isset($statements['tables'])) {
377 377
             throw new Exception('No table specified', 3);
378 378
         }
379 379
 
@@ -388,7 +388,7 @@  discard block
 block discarded – undo
388 388
         list($whereCriteria, $whereBindings) = $this->buildCriteriaWithType($statements, 'wheres', 'WHERE');
389 389
 
390 390
         // Limit
391
-        $limit = isset($statements['limit']) ? 'LIMIT ' . $statements['limit'] : '';
391
+        $limit = isset($statements['limit']) ? 'LIMIT '.$statements['limit'] : '';
392 392
 
393 393
         $sqlArray = ['DELETE FROM', $table, $whereCriteria];
394 394
         $sql      = $this->concatenateQuery($sqlArray);
@@ -410,11 +410,11 @@  discard block
 block discarded – undo
410 410
     {
411 411
         $str = '';
412 412
         foreach ($pieces as $key => $piece) {
413
-            if (!is_int($key)) {
414
-                $piece = $key . ' AS ' . $piece;
413
+            if ( ! is_int($key)) {
414
+                $piece = $key.' AS '.$piece;
415 415
             }
416 416
 
417
-            $str .= $piece . $glue;
417
+            $str .= $piece.$glue;
418 418
         }
419 419
 
420 420
         return trim($str, $glue);
@@ -431,7 +431,7 @@  discard block
 block discarded – undo
431 431
     {
432 432
         $str = '';
433 433
         foreach ($pieces as $piece) {
434
-            $str = trim($str) . ' ' . trim($piece);
434
+            $str = trim($str).' '.trim($piece);
435 435
         }
436 436
 
437 437
         return trim($str);
@@ -446,7 +446,7 @@  discard block
 block discarded – undo
446 446
     public function getType($value): string
447 447
     {
448 448
         return $value instanceof Binding && $value->getType() !== null
449
-            ? $value->getType() : $this->inferType($value) ;
449
+            ? $value->getType() : $this->inferType($value);
450 450
     }
451 451
 
452 452
     /**
@@ -489,7 +489,7 @@  discard block
 block discarded – undo
489 489
 
490 490
 
491 491
         $bindings = array_map([$this, 'getValue'], $bindings);
492
-        $query = $this->connection->getDbInstance()->prepare($query, $bindings) ;
492
+        $query = $this->connection->getDbInstance()->prepare($query, $bindings);
493 493
         return is_string($query) ? $query : '';
494 494
     }
495 495
 
@@ -530,10 +530,10 @@  discard block
 block discarded – undo
530 530
                 // Merge the bindings we get from nestedCriteria object
531 531
                 $bindings = array_merge($bindings, $queryObject->getBindings());
532 532
                 // Append the sql we get from the nestedCriteria object
533
-                $criteria .= $statement['joiner'] . ' (' . $queryObject->getSql() . ') ';
533
+                $criteria .= $statement['joiner'].' ('.$queryObject->getSql().') ';
534 534
             } elseif (is_array($value)) {
535 535
                 // where_in or between like query
536
-                $criteria .= $statement['joiner'] . ' ' . $key . ' ' . $statement['operator'];
536
+                $criteria .= $statement['joiner'].' '.$key.' '.$statement['operator'];
537 537
 
538 538
                 switch ($statement['operator']) {
539 539
                     case 'BETWEEN':
@@ -549,7 +549,7 @@  discard block
 block discarded – undo
549 549
                         $value[1] = $this->getValue($value[1]);
550 550
 
551 551
                         // Parse any raws.
552
-                        $value = array_map(function ($value) {
552
+                        $value = array_map(function($value) {
553 553
                             return $value instanceof Raw
554 554
                                 ? $this->parseRaw($value)
555 555
                                 : $value;
@@ -573,7 +573,7 @@  discard block
 block discarded – undo
573 573
                         }
574 574
 
575 575
                         $valuePlaceholder = trim($valuePlaceholder, ', ');
576
-                        $criteria .= ' (' . $valuePlaceholder . ') ';
576
+                        $criteria .= ' ('.$valuePlaceholder.') ';
577 577
                         break;
578 578
                 }
579 579
             } elseif ($value instanceof Raw) {
@@ -581,20 +581,20 @@  discard block
 block discarded – undo
581 581
                 $criteria .= "{$statement['joiner']} {$key} {$statement['operator']} $value ";
582 582
             } else {
583 583
                 // Usual where like criteria
584
-                if (!$bindValues) {
584
+                if ( ! $bindValues) {
585 585
                     // Specially for joins
586 586
                     // We are not binding values, lets sanitize then
587 587
                     $value = $this->stringifyValue($this->wrapSanitizer($value)) ?? '';
588
-                    $criteria .= $statement['joiner'] . ' ' . $key . ' ' . $statement['operator'] . ' ' . $value . ' ';
588
+                    $criteria .= $statement['joiner'].' '.$key.' '.$statement['operator'].' '.$value.' ';
589 589
                 } elseif ($statement['key'] instanceof Raw) {
590
-                    $criteria .= $statement['joiner'] . ' ' . $key . ' ';
590
+                    $criteria .= $statement['joiner'].' '.$key.' ';
591 591
                     $bindings = array_merge($bindings, $statement['key']->getBindings());
592 592
                 } else {
593 593
                     // For wheres
594 594
                     $bindings[] = $this->getValue($value);
595 595
 
596
-                    $criteria .= $statement['joiner'] . ' ' . $key . ' ' . $statement['operator'] . ' '
597
-                    . $this->getType($value) . ' ';
596
+                    $criteria .= $statement['joiner'].' '.$key.' '.$statement['operator'].' '
597
+                    . $this->getType($value).' ';
598 598
                 }
599 599
             }
600 600
         }
@@ -649,7 +649,7 @@  discard block
 block discarded – undo
649 649
 
650 650
         foreach ($valueArr as $key => $subValue) {
651 651
             // Don't wrap if we have *, which is not a usual field
652
-            $valueArr[$key] = '*' == trim($subValue) ? $subValue : $this->sanitizer . $subValue . $this->sanitizer;
652
+            $valueArr[$key] = '*' == trim($subValue) ? $subValue : $this->sanitizer.$subValue.$this->sanitizer;
653 653
         }
654 654
 
655 655
         // Join these back with "." and return
@@ -676,7 +676,7 @@  discard block
 block discarded – undo
676 676
             list($criteria, $bindings) = $this->buildCriteria($statements[$key], $bindValues);
677 677
 
678 678
             if ($criteria) {
679
-                $criteria = $type . ' ' . $criteria;
679
+                $criteria = $type.' '.$criteria;
680 680
             }
681 681
         }
682 682
 
@@ -697,7 +697,7 @@  discard block
 block discarded – undo
697 697
     {
698 698
         $sql = '';
699 699
 
700
-        if (!array_key_exists('joins', $statements) || !is_array($statements['joins'])) {
700
+        if ( ! array_key_exists('joins', $statements) || ! is_array($statements['joins'])) {
701 701
             return $sql;
702 702
         }
703 703
 
@@ -705,7 +705,7 @@  discard block
 block discarded – undo
705 705
             if (is_array($joinArr['table'])) {
706 706
                 $mainTable  = $this->stringifyValue($this->wrapSanitizer($joinArr['table'][0]));
707 707
                 $aliasTable = $this->stringifyValue($this->wrapSanitizer($joinArr['table'][1]));
708
-                $table      = $mainTable . ' AS ' . $aliasTable;
708
+                $table      = $mainTable.' AS '.$aliasTable;
709 709
             } else {
710 710
                 $table = $joinArr['table'] instanceof Raw
711 711
                     ? $this->parseRaw($joinArr['table'])
Please login to merge, or discard this patch.
src/QueryBuilder/TablePrefixer.php 2 patches
Indentation   +63 added lines, -63 removed lines patch added patch discarded remove patch
@@ -9,77 +9,77 @@
 block discarded – undo
9 9
 
10 10
 trait TablePrefixer
11 11
 {
12
-    /**
13
-         * Add table prefix (if given) on given string.
14
-         *
15
-         * @param array<string|int, string|int|float|bool|Raw|Closure>|string|int|float|bool|Raw|Closure     $values
16
-         * @param bool $tableFieldMix If we have mixes of field and table names with a "."
17
-         *
18
-         * @return mixed|mixed[]
19
-         */
20
-    public function addTablePrefix($values, bool $tableFieldMix = true)
21
-    {
22
-        if (is_null($this->getTablePrefix())) {
23
-            return $values;
24
-        }
12
+	/**
13
+	 * Add table prefix (if given) on given string.
14
+	 *
15
+	 * @param array<string|int, string|int|float|bool|Raw|Closure>|string|int|float|bool|Raw|Closure     $values
16
+	 * @param bool $tableFieldMix If we have mixes of field and table names with a "."
17
+	 *
18
+	 * @return mixed|mixed[]
19
+	 */
20
+	public function addTablePrefix($values, bool $tableFieldMix = true)
21
+	{
22
+		if (is_null($this->getTablePrefix())) {
23
+			return $values;
24
+		}
25 25
 
26
-        // $value will be an array and we will add prefix to all table names
26
+		// $value will be an array and we will add prefix to all table names
27 27
 
28
-        // If supplied value is not an array then make it one
29
-        $single = false;
30
-        if (!is_array($values)) {
31
-            $values = [$values];
32
-            // We had single value, so should return a single value
33
-            $single = true;
34
-        }
28
+		// If supplied value is not an array then make it one
29
+		$single = false;
30
+		if (!is_array($values)) {
31
+			$values = [$values];
32
+			// We had single value, so should return a single value
33
+			$single = true;
34
+		}
35 35
 
36
-        $return = [];
36
+		$return = [];
37 37
 
38
-        foreach ($values as $key => $value) {
39
-            // It's a raw query, just add it to our return array and continue next
40
-            if ($value instanceof Raw || $value instanceof Closure) {
41
-                $return[$key] = $value;
42
-                continue;
43
-            }
38
+		foreach ($values as $key => $value) {
39
+			// It's a raw query, just add it to our return array and continue next
40
+			if ($value instanceof Raw || $value instanceof Closure) {
41
+				$return[$key] = $value;
42
+				continue;
43
+			}
44 44
 
45
-            // If key is not integer, it is likely a alias mapping,
46
-            // so we need to change prefix target
47
-            $target = &$value;
48
-            if (!is_int($key)) {
49
-                $target = &$key;
50
-            }
45
+			// If key is not integer, it is likely a alias mapping,
46
+			// so we need to change prefix target
47
+			$target = &$value;
48
+			if (!is_int($key)) {
49
+				$target = &$key;
50
+			}
51 51
 
52
-            // Do prefix if the target is an expression or function.
53
-            if (
54
-                !$tableFieldMix
55
-                || (
56
-                    is_string($target) // Must be a string
57
-                    && (bool) preg_match('/^[A-Za-z0-9_.]+$/', $target) // Can only contain letters, numbers, underscore and full stops
58
-                    && 1 === \substr_count($target, '.') // Contains a single full stop ONLY.
59
-                )
60
-            ) {
61
-                $target = $this->getTablePrefix() . $target;
62
-            }
52
+			// Do prefix if the target is an expression or function.
53
+			if (
54
+				!$tableFieldMix
55
+				|| (
56
+					is_string($target) // Must be a string
57
+					&& (bool) preg_match('/^[A-Za-z0-9_.]+$/', $target) // Can only contain letters, numbers, underscore and full stops
58
+					&& 1 === \substr_count($target, '.') // Contains a single full stop ONLY.
59
+				)
60
+			) {
61
+				$target = $this->getTablePrefix() . $target;
62
+			}
63 63
 
64
-            $return[$key] = $value;
65
-        }
64
+			$return[$key] = $value;
65
+		}
66 66
 
67
-        // If we had single value then we should return a single value (end value of the array)
68
-        return true === $single ? end($return) : $return;
69
-    }
67
+		// If we had single value then we should return a single value (end value of the array)
68
+		return true === $single ? end($return) : $return;
69
+	}
70 70
 
71
-    /**
72
-     * Returns the table prefix if defined in connection
73
-     *
74
-     * @return string|null
75
-     */
76
-    protected function getTablePrefix(): ?string
77
-    {
78
-        $adapterConfig = $this->getConnection()->getAdapterConfig();
79
-        return isset($adapterConfig[Connection::PREFIX])
80
-            ? $adapterConfig[Connection::PREFIX]
81
-            : null;
82
-    }
71
+	/**
72
+	 * Returns the table prefix if defined in connection
73
+	 *
74
+	 * @return string|null
75
+	 */
76
+	protected function getTablePrefix(): ?string
77
+	{
78
+		$adapterConfig = $this->getConnection()->getAdapterConfig();
79
+		return isset($adapterConfig[Connection::PREFIX])
80
+			? $adapterConfig[Connection::PREFIX]
81
+			: null;
82
+	}
83 83
 
84
-    abstract public function getConnection(): Connection;
84
+	abstract public function getConnection(): Connection;
85 85
 }
Please login to merge, or discard this patch.
Spacing   +4 added lines, -4 removed lines patch added patch discarded remove patch
@@ -27,7 +27,7 @@  discard block
 block discarded – undo
27 27
 
28 28
         // If supplied value is not an array then make it one
29 29
         $single = false;
30
-        if (!is_array($values)) {
30
+        if ( ! is_array($values)) {
31 31
             $values = [$values];
32 32
             // We had single value, so should return a single value
33 33
             $single = true;
@@ -45,20 +45,20 @@  discard block
 block discarded – undo
45 45
             // If key is not integer, it is likely a alias mapping,
46 46
             // so we need to change prefix target
47 47
             $target = &$value;
48
-            if (!is_int($key)) {
48
+            if ( ! is_int($key)) {
49 49
                 $target = &$key;
50 50
             }
51 51
 
52 52
             // Do prefix if the target is an expression or function.
53 53
             if (
54
-                !$tableFieldMix
54
+                ! $tableFieldMix
55 55
                 || (
56 56
                     is_string($target) // Must be a string
57 57
                     && (bool) preg_match('/^[A-Za-z0-9_.]+$/', $target) // Can only contain letters, numbers, underscore and full stops
58 58
                     && 1 === \substr_count($target, '.') // Contains a single full stop ONLY.
59 59
                 )
60 60
             ) {
61
-                $target = $this->getTablePrefix() . $target;
61
+                $target = $this->getTablePrefix().$target;
62 62
             }
63 63
 
64 64
             $return[$key] = $value;
Please login to merge, or discard this patch.
src/JSON/JsonSelector.php 1 patch
Indentation   +39 added lines, -39 removed lines patch added patch discarded remove patch
@@ -4,47 +4,47 @@
 block discarded – undo
4 4
 
5 5
 class JsonSelector
6 6
 {
7
-    /**
8
-     * The table column
9
-     *
10
-     * @var string
11
-     */
12
-    protected $column;
7
+	/**
8
+	 * The table column
9
+	 *
10
+	 * @var string
11
+	 */
12
+	protected $column;
13 13
 
14
-    /**
15
-     * JSON Nodes
16
-     *
17
-     * @var string[]
18
-     */
19
-    protected $nodes;
14
+	/**
15
+	 * JSON Nodes
16
+	 *
17
+	 * @var string[]
18
+	 */
19
+	protected $nodes;
20 20
 
21
-    /**
22
-     * @param string $column
23
-     * @param string[] $nodes
24
-     */
25
-    public function __construct(string $column, array $nodes)
26
-    {
27
-        $this->column = $column;
28
-        $this->nodes = $nodes;
29
-    }
21
+	/**
22
+	 * @param string $column
23
+	 * @param string[] $nodes
24
+	 */
25
+	public function __construct(string $column, array $nodes)
26
+	{
27
+		$this->column = $column;
28
+		$this->nodes = $nodes;
29
+	}
30 30
 
31
-    /**
32
-     * Get the table column
33
-     *
34
-     * @return string
35
-     */
36
-    public function getColumn(): string
37
-    {
38
-        return $this->column;
39
-    }
31
+	/**
32
+	 * Get the table column
33
+	 *
34
+	 * @return string
35
+	 */
36
+	public function getColumn(): string
37
+	{
38
+		return $this->column;
39
+	}
40 40
 
41
-    /**
42
-     * Get jSON Nodes
43
-     *
44
-     * @return string[]
45
-     */
46
-    public function getNodes(): array
47
-    {
48
-        return $this->nodes;
49
-    }
41
+	/**
42
+	 * Get jSON Nodes
43
+	 *
44
+	 * @return string[]
45
+	 */
46
+	public function getNodes(): array
47
+	{
48
+		return $this->nodes;
49
+	}
50 50
 }
Please login to merge, or discard this patch.
src/JSON/JsonHandler.php 1 patch
Indentation   +54 added lines, -54 removed lines patch added patch discarded remove patch
@@ -6,65 +6,65 @@
 block discarded – undo
6 6
 
7 7
 class JsonHandler
8 8
 {
9
-    /** @var Connection */
10
-    protected $connection;
9
+	/** @var Connection */
10
+	protected $connection;
11 11
 
12
-    /** @var JsonSelectorHandler */
13
-    protected $jsonSelectorHandler;
12
+	/** @var JsonSelectorHandler */
13
+	protected $jsonSelectorHandler;
14 14
 
15
-    /** @var JsonExpressionFactory */
16
-    protected $jsonExpressionFactory;
15
+	/** @var JsonExpressionFactory */
16
+	protected $jsonExpressionFactory;
17 17
 
18
-    public function __construct(Connection $connection)
19
-    {
20
-        $this->connection = $connection;
21
-        $this->jsonSelectorHandler = new JsonSelectorHandler($connection);
22
-        $this->jsonExpressionFactory = new JsonExpressionFactory($connection);
23
-    }
18
+	public function __construct(Connection $connection)
19
+	{
20
+		$this->connection = $connection;
21
+		$this->jsonSelectorHandler = new JsonSelectorHandler($connection);
22
+		$this->jsonExpressionFactory = new JsonExpressionFactory($connection);
23
+	}
24 24
 
25
-    /**
26
-     * Returns the JSON Selector Handler
27
-     *
28
-     * @return JsonSelectorHandler
29
-     */
30
-    public function jsonSelectorHandler(): JsonSelectorHandler
31
-    {
32
-        return $this->jsonSelectorHandler;
33
-    }
25
+	/**
26
+	 * Returns the JSON Selector Handler
27
+	 *
28
+	 * @return JsonSelectorHandler
29
+	 */
30
+	public function jsonSelectorHandler(): JsonSelectorHandler
31
+	{
32
+		return $this->jsonSelectorHandler;
33
+	}
34 34
 
35
-    /**
36
-     * Returns the JSON Expression library
37
-     *
38
-     * @return JsonExpressionFactory
39
-     */
40
-    public function jsonExpressionFactory(): JsonExpressionFactory
41
-    {
42
-        return $this->jsonExpressionFactory;
43
-    }
35
+	/**
36
+	 * Returns the JSON Expression library
37
+	 *
38
+	 * @return JsonExpressionFactory
39
+	 */
40
+	public function jsonExpressionFactory(): JsonExpressionFactory
41
+	{
42
+		return $this->jsonExpressionFactory;
43
+	}
44 44
 
45
-    /**
46
-     * Parses a JSON selector and returns as an Extract and Unquote expression.
47
-     *
48
-     * @param string $selector
49
-     * @return string
50
-     */
51
-    public function extractAndUnquoteFromJsonSelector(string $selector): string
52
-    {
53
-        $selector = $this->jsonSelectorHandler()->toJsonSelector($selector);
54
-        return $this->jsonExpressionFactory()->extractAndUnquote(
55
-            $selector->getColumn(),
56
-            $selector->getNodes()
57
-        );
58
-    }
45
+	/**
46
+	 * Parses a JSON selector and returns as an Extract and Unquote expression.
47
+	 *
48
+	 * @param string $selector
49
+	 * @return string
50
+	 */
51
+	public function extractAndUnquoteFromJsonSelector(string $selector): string
52
+	{
53
+		$selector = $this->jsonSelectorHandler()->toJsonSelector($selector);
54
+		return $this->jsonExpressionFactory()->extractAndUnquote(
55
+			$selector->getColumn(),
56
+			$selector->getNodes()
57
+		);
58
+	}
59 59
 
60
-    /**
61
-     * Checks if the passed values is a valid JSON Selector
62
-     *
63
-     * @param mixed $expression
64
-     * @return bool
65
-     */
66
-    public function isJsonSelector($expression): bool
67
-    {
68
-        return $this->jsonSelectorHandler()->isJsonSelector($expression);
69
-    }
60
+	/**
61
+	 * Checks if the passed values is a valid JSON Selector
62
+	 *
63
+	 * @param mixed $expression
64
+	 * @return bool
65
+	 */
66
+	public function isJsonSelector($expression): bool
67
+	{
68
+		return $this->jsonSelectorHandler()->isJsonSelector($expression);
69
+	}
70 70
 }
Please login to merge, or discard this patch.
static-loader-creator.php 2 patches
Indentation   +224 added lines, -224 removed lines patch added patch discarded remove patch
@@ -25,161 +25,161 @@  discard block
 block discarded – undo
25 25
 
26 26
 class StaticLoaderCreator
27 27
 {
28
-    /** @var string[] Array of file names */
29
-    protected array $files = [];
30
-
31
-    /** @var array<int, array{class:string|null, ns:string|null, interface:string|null, trait:string|null, file:string}> Classes */
32
-    protected array $classes = [];
33
-
34
-    /** @var string Path to the SRC directory. */
35
-    protected $routePath;
36
-
37
-    public function __construct()
38
-    {
39
-        $this->routePath = __DIR__ . DIRECTORY_SEPARATOR . 'src';
40
-    }
41
-
42
-    /**
43
-     * Static initialiser
44
-     *
45
-     * @return void
46
-     */
47
-    public static function run(): void
48
-    {
49
-        $instance = new self();
50
-        $instance->getFiles();
51
-        $instance->getClassNames();
52
-        $instance->writeLoader();
53
-    }
54
-
55
-    /**
56
-     * Get all filenames excluding the loader.
57
-     *
58
-     * @return void
59
-     */
60
-    public function getFiles(): void
61
-    {
62
-        $rii = new RecursiveIteratorIterator(
63
-            new RecursiveDirectoryIterator($this->routePath)
64
-        );
65
-
66
-        foreach ($rii as $file) {
67
-            if ($file->isDir() || $file->getPathname() === $this->routePath . DIRECTORY_SEPARATOR . 'loader.php') {
68
-                continue;
69
-            }
70
-
71
-            $this->files[] = $file->getPathname();
72
-        }
73
-    }
74
-
75
-    /**
76
-     * Compiles the list of classnames with file paths.
77
-     *
78
-     * @return void
79
-     */
80
-    public function getClassNames(): void
81
-    {
82
-        foreach ($this->files as $file) {
83
-            $classData['class'] = $this->getObjectTypeFromFile($file, T_CLASS);
84
-            $classData['trait'] = $this->getObjectTypeFromFile($file, T_TRAIT);
85
-            $classData['interface'] = $this->getObjectTypeFromFile($file, T_INTERFACE);
86
-            $classData['ns'] = $this->getNamespace($file);
87
-            $classData['file'] = str_replace($this->routePath, '', $file);
88
-            $this->classes[] = $classData;
89
-        }
90
-
91
-        // Set all classes to be required last, allow traits to load first.
92
-        uasort($this->classes, function ($file1, $file2) {
93
-            return is_null($file1['class']) ? -1 : 1;
94
-        });
95
-    }
96
-
97
-    /**
98
-     * Gets the namespace from a file.
99
-     *
100
-     * @see https://stackoverflow.com/questions/7153000/get-class-name-from-file/44654073
101
-     * @param string $file
102
-     * @return string|null
103
-     * @throws \Exception If file not found or empty.
104
-     */
105
-    public function getNamespace(string $file): ?string
106
-    {
107
-        $src = file_get_contents($file);
108
-
109
-        if (false === $src) {
110
-            throw new \Exception("Could not read contents of {$file}", 1);
111
-        }
112
-
113
-        $tokens = token_get_all($src);
114
-        $count = count($tokens);
115
-        $i = 0;
116
-        $namespace = '';
117
-        $namespace_ok = false;
118
-        while ($i < $count) {
119
-            $token = $tokens[$i];
120
-            if (is_array($token) && $token[0] === T_NAMESPACE) {
121
-                // Found namespace declaration
122
-                while (++$i < $count) {
123
-                    if ($tokens[$i] === ';') {
124
-                        $namespace_ok = true;
125
-                        $namespace = trim($namespace);
126
-                        break;
127
-                    }
128
-                    $namespace .= is_array($tokens[$i]) ? $tokens[$i][1] : $tokens[$i];
129
-                }
130
-                break;
131
-            }
132
-            $i++;
133
-        }
134
-        if (!$namespace_ok) {
135
-            return null;
136
-        } else {
137
-            return $namespace;
138
-        }
139
-    }
140
-
141
-    /**
142
-     * get the class name form file path using token
143
-     *
144
-     * @see https://stackoverflow.com/questions/7153000/get-class-name-from-file/44654073
145
-     * @param string $file
146
-     * @param int $type
147
-     * @return string|null
148
-     */
149
-    protected function getObjectTypeFromFile(string $file, int $type = T_CLASS): ?string
150
-    {
151
-        $src = file_get_contents($file);
152
-
153
-        if (false === $src) {
154
-            throw new \Exception("Could not read contents of {$file}", 1);
155
-        }
156
-
157
-        $classes = array();
158
-        $tokens = token_get_all($src);
159
-        $count = count($tokens);
160
-        for ($i = 2; $i < $count; $i++) {
161
-            if (
162
-                $tokens[$i - 2][0] == $type
163
-                && $tokens[$i - 1][0] == T_WHITESPACE
164
-                && $tokens[$i][0] == T_STRING
165
-            ) {
166
-                $class_name = $tokens[$i][1];
167
-                $classes[] = $class_name;
168
-            }
169
-        }
170
-
171
-        return array_key_exists(0, $classes) ? $classes[0] : null;
172
-    }
173
-
174
-    /**
175
-     * Writes the loader.php file.
176
-     *
177
-     * @return void
178
-     */
179
-    public function writeLoader(): void
180
-    {
181
-        $newLine = PHP_EOL;
182
-        $header = "<?php{$newLine}{$newLine}{$newLine}
28
+	/** @var string[] Array of file names */
29
+	protected array $files = [];
30
+
31
+	/** @var array<int, array{class:string|null, ns:string|null, interface:string|null, trait:string|null, file:string}> Classes */
32
+	protected array $classes = [];
33
+
34
+	/** @var string Path to the SRC directory. */
35
+	protected $routePath;
36
+
37
+	public function __construct()
38
+	{
39
+		$this->routePath = __DIR__ . DIRECTORY_SEPARATOR . 'src';
40
+	}
41
+
42
+	/**
43
+	 * Static initialiser
44
+	 *
45
+	 * @return void
46
+	 */
47
+	public static function run(): void
48
+	{
49
+		$instance = new self();
50
+		$instance->getFiles();
51
+		$instance->getClassNames();
52
+		$instance->writeLoader();
53
+	}
54
+
55
+	/**
56
+	 * Get all filenames excluding the loader.
57
+	 *
58
+	 * @return void
59
+	 */
60
+	public function getFiles(): void
61
+	{
62
+		$rii = new RecursiveIteratorIterator(
63
+			new RecursiveDirectoryIterator($this->routePath)
64
+		);
65
+
66
+		foreach ($rii as $file) {
67
+			if ($file->isDir() || $file->getPathname() === $this->routePath . DIRECTORY_SEPARATOR . 'loader.php') {
68
+				continue;
69
+			}
70
+
71
+			$this->files[] = $file->getPathname();
72
+		}
73
+	}
74
+
75
+	/**
76
+	 * Compiles the list of classnames with file paths.
77
+	 *
78
+	 * @return void
79
+	 */
80
+	public function getClassNames(): void
81
+	{
82
+		foreach ($this->files as $file) {
83
+			$classData['class'] = $this->getObjectTypeFromFile($file, T_CLASS);
84
+			$classData['trait'] = $this->getObjectTypeFromFile($file, T_TRAIT);
85
+			$classData['interface'] = $this->getObjectTypeFromFile($file, T_INTERFACE);
86
+			$classData['ns'] = $this->getNamespace($file);
87
+			$classData['file'] = str_replace($this->routePath, '', $file);
88
+			$this->classes[] = $classData;
89
+		}
90
+
91
+		// Set all classes to be required last, allow traits to load first.
92
+		uasort($this->classes, function ($file1, $file2) {
93
+			return is_null($file1['class']) ? -1 : 1;
94
+		});
95
+	}
96
+
97
+	/**
98
+	 * Gets the namespace from a file.
99
+	 *
100
+	 * @see https://stackoverflow.com/questions/7153000/get-class-name-from-file/44654073
101
+	 * @param string $file
102
+	 * @return string|null
103
+	 * @throws \Exception If file not found or empty.
104
+	 */
105
+	public function getNamespace(string $file): ?string
106
+	{
107
+		$src = file_get_contents($file);
108
+
109
+		if (false === $src) {
110
+			throw new \Exception("Could not read contents of {$file}", 1);
111
+		}
112
+
113
+		$tokens = token_get_all($src);
114
+		$count = count($tokens);
115
+		$i = 0;
116
+		$namespace = '';
117
+		$namespace_ok = false;
118
+		while ($i < $count) {
119
+			$token = $tokens[$i];
120
+			if (is_array($token) && $token[0] === T_NAMESPACE) {
121
+				// Found namespace declaration
122
+				while (++$i < $count) {
123
+					if ($tokens[$i] === ';') {
124
+						$namespace_ok = true;
125
+						$namespace = trim($namespace);
126
+						break;
127
+					}
128
+					$namespace .= is_array($tokens[$i]) ? $tokens[$i][1] : $tokens[$i];
129
+				}
130
+				break;
131
+			}
132
+			$i++;
133
+		}
134
+		if (!$namespace_ok) {
135
+			return null;
136
+		} else {
137
+			return $namespace;
138
+		}
139
+	}
140
+
141
+	/**
142
+	 * get the class name form file path using token
143
+	 *
144
+	 * @see https://stackoverflow.com/questions/7153000/get-class-name-from-file/44654073
145
+	 * @param string $file
146
+	 * @param int $type
147
+	 * @return string|null
148
+	 */
149
+	protected function getObjectTypeFromFile(string $file, int $type = T_CLASS): ?string
150
+	{
151
+		$src = file_get_contents($file);
152
+
153
+		if (false === $src) {
154
+			throw new \Exception("Could not read contents of {$file}", 1);
155
+		}
156
+
157
+		$classes = array();
158
+		$tokens = token_get_all($src);
159
+		$count = count($tokens);
160
+		for ($i = 2; $i < $count; $i++) {
161
+			if (
162
+				$tokens[$i - 2][0] == $type
163
+				&& $tokens[$i - 1][0] == T_WHITESPACE
164
+				&& $tokens[$i][0] == T_STRING
165
+			) {
166
+				$class_name = $tokens[$i][1];
167
+				$classes[] = $class_name;
168
+			}
169
+		}
170
+
171
+		return array_key_exists(0, $classes) ? $classes[0] : null;
172
+	}
173
+
174
+	/**
175
+	 * Writes the loader.php file.
176
+	 *
177
+	 * @return void
178
+	 */
179
+	public function writeLoader(): void
180
+	{
181
+		$newLine = PHP_EOL;
182
+		$header = "<?php{$newLine}{$newLine}{$newLine}
183 183
 /**
184 184
  * Pixie WPDB Static Loader
185 185
  *
@@ -205,77 +205,77 @@  discard block
 block discarded – undo
205 205
 
206 206
 // Generated code start...";
207 207
 
208
-        $contents = array_map(function ($file, $class) {
209
-             return sprintf(
210
-                 "if (!%s(%s::class)) {
208
+		$contents = array_map(function ($file, $class) {
209
+			 return sprintf(
210
+				 "if (!%s(%s::class)) {
211 211
     require_once __DIR__ . '%s';
212 212
 }",
213
-                 $this->getMethodFromToken($class),
214
-                 $this->getFullTokenName($class),
215
-                 $class['file']
216
-             );
217
-        }, array_keys($this->classes), $this->classes);
218
-
219
-        $footer = sprintf("// CREATED ON %s", date('D jS F Y', time()));
220
-
221
-        $file = __DIR__ . DIRECTORY_SEPARATOR . 'src' . DIRECTORY_SEPARATOR . 'loader.php';
222
-        touch($file);
223
-
224
-        file_put_contents(
225
-            $file,
226
-            join(PHP_EOL, [
227
-                $header,
228
-                join(PHP_EOL, $contents),
229
-                $footer, ''
230
-            ])
231
-        );
232
-    }
233
-
234
-    /**
235
-     * Gets the *_exists() method based on the token type.
236
-     *
237
-     * @param array{class:string|null, ns:string|null, interface:string|null, trait:string|null, file:string} $token
238
-     * @return string
239
-     */
240
-    public function getMethodFromToken(array $token): string
241
-    {
242
-        switch (true) {
243
-            case ! is_null($token['trait']):
244
-                return 'trait_exists';
245
-
246
-            case ! is_null($token['interface']):
247
-                return 'interface_exists';
248
-
249
-            default:
250
-                return 'class_exists';
251
-        }
252
-    }
253
-
254
-    /**
255
-     * Returns the full (namespaced) token name
256
-     *
257
-     * @param array{class:string|null, ns:string|null, interface:string|null, trait:string|null, file:string} $token
258
-     * @return string
259
-     */
260
-    public function getFullTokenName(array $token): string
261
-    {
262
-        switch (true) {
263
-            case ! array_key_exists('ns', $token):
264
-                return '';
265
-
266
-            case ! is_null($token['trait']):
267
-                return $token['ns'] . '\\' . $token['trait'];
268
-
269
-            case ! is_null($token['interface']):
270
-                return $token['ns'] . '\\' . $token['interface'];
271
-
272
-            case ! is_null($token['class']):
273
-                return $token['ns'] . '\\' . $token['class'];
274
-
275
-            default:
276
-                return '';
277
-        }
278
-    }
213
+				 $this->getMethodFromToken($class),
214
+				 $this->getFullTokenName($class),
215
+				 $class['file']
216
+			 );
217
+		}, array_keys($this->classes), $this->classes);
218
+
219
+		$footer = sprintf("// CREATED ON %s", date('D jS F Y', time()));
220
+
221
+		$file = __DIR__ . DIRECTORY_SEPARATOR . 'src' . DIRECTORY_SEPARATOR . 'loader.php';
222
+		touch($file);
223
+
224
+		file_put_contents(
225
+			$file,
226
+			join(PHP_EOL, [
227
+				$header,
228
+				join(PHP_EOL, $contents),
229
+				$footer, ''
230
+			])
231
+		);
232
+	}
233
+
234
+	/**
235
+	 * Gets the *_exists() method based on the token type.
236
+	 *
237
+	 * @param array{class:string|null, ns:string|null, interface:string|null, trait:string|null, file:string} $token
238
+	 * @return string
239
+	 */
240
+	public function getMethodFromToken(array $token): string
241
+	{
242
+		switch (true) {
243
+			case ! is_null($token['trait']):
244
+				return 'trait_exists';
245
+
246
+			case ! is_null($token['interface']):
247
+				return 'interface_exists';
248
+
249
+			default:
250
+				return 'class_exists';
251
+		}
252
+	}
253
+
254
+	/**
255
+	 * Returns the full (namespaced) token name
256
+	 *
257
+	 * @param array{class:string|null, ns:string|null, interface:string|null, trait:string|null, file:string} $token
258
+	 * @return string
259
+	 */
260
+	public function getFullTokenName(array $token): string
261
+	{
262
+		switch (true) {
263
+			case ! array_key_exists('ns', $token):
264
+				return '';
265
+
266
+			case ! is_null($token['trait']):
267
+				return $token['ns'] . '\\' . $token['trait'];
268
+
269
+			case ! is_null($token['interface']):
270
+				return $token['ns'] . '\\' . $token['interface'];
271
+
272
+			case ! is_null($token['class']):
273
+				return $token['ns'] . '\\' . $token['class'];
274
+
275
+			default:
276
+				return '';
277
+		}
278
+	}
279 279
 }
280 280
 
281 281
 StaticLoaderCreator::run();
Please login to merge, or discard this patch.
Spacing   +9 added lines, -9 removed lines patch added patch discarded remove patch
@@ -36,7 +36,7 @@  discard block
 block discarded – undo
36 36
 
37 37
     public function __construct()
38 38
     {
39
-        $this->routePath = __DIR__ . DIRECTORY_SEPARATOR . 'src';
39
+        $this->routePath = __DIR__.DIRECTORY_SEPARATOR.'src';
40 40
     }
41 41
 
42 42
     /**
@@ -64,7 +64,7 @@  discard block
 block discarded – undo
64 64
         );
65 65
 
66 66
         foreach ($rii as $file) {
67
-            if ($file->isDir() || $file->getPathname() === $this->routePath . DIRECTORY_SEPARATOR . 'loader.php') {
67
+            if ($file->isDir() || $file->getPathname() === $this->routePath.DIRECTORY_SEPARATOR.'loader.php') {
68 68
                 continue;
69 69
             }
70 70
 
@@ -89,7 +89,7 @@  discard block
 block discarded – undo
89 89
         }
90 90
 
91 91
         // Set all classes to be required last, allow traits to load first.
92
-        uasort($this->classes, function ($file1, $file2) {
92
+        uasort($this->classes, function($file1, $file2) {
93 93
             return is_null($file1['class']) ? -1 : 1;
94 94
         });
95 95
     }
@@ -131,7 +131,7 @@  discard block
 block discarded – undo
131 131
             }
132 132
             $i++;
133 133
         }
134
-        if (!$namespace_ok) {
134
+        if ( ! $namespace_ok) {
135 135
             return null;
136 136
         } else {
137 137
             return $namespace;
@@ -205,7 +205,7 @@  discard block
 block discarded – undo
205 205
 
206 206
 // Generated code start...";
207 207
 
208
-        $contents = array_map(function ($file, $class) {
208
+        $contents = array_map(function($file, $class) {
209 209
              return sprintf(
210 210
                  "if (!%s(%s::class)) {
211 211
     require_once __DIR__ . '%s';
@@ -218,7 +218,7 @@  discard block
 block discarded – undo
218 218
 
219 219
         $footer = sprintf("// CREATED ON %s", date('D jS F Y', time()));
220 220
 
221
-        $file = __DIR__ . DIRECTORY_SEPARATOR . 'src' . DIRECTORY_SEPARATOR . 'loader.php';
221
+        $file = __DIR__.DIRECTORY_SEPARATOR.'src'.DIRECTORY_SEPARATOR.'loader.php';
222 222
         touch($file);
223 223
 
224 224
         file_put_contents(
@@ -264,13 +264,13 @@  discard block
 block discarded – undo
264 264
                 return '';
265 265
 
266 266
             case ! is_null($token['trait']):
267
-                return $token['ns'] . '\\' . $token['trait'];
267
+                return $token['ns'].'\\'.$token['trait'];
268 268
 
269 269
             case ! is_null($token['interface']):
270
-                return $token['ns'] . '\\' . $token['interface'];
270
+                return $token['ns'].'\\'.$token['interface'];
271 271
 
272 272
             case ! is_null($token['class']):
273
-                return $token['ns'] . '\\' . $token['class'];
273
+                return $token['ns'].'\\'.$token['class'];
274 274
 
275 275
             default:
276 276
                 return '';
Please login to merge, or discard this patch.
src/QueryBuilder/JsonQueryBuilder.php 1 patch
Indentation   +444 added lines, -444 removed lines patch added patch discarded remove patch
@@ -4,448 +4,448 @@
 block discarded – undo
4 4
 
5 5
 class JsonQueryBuilder extends QueryBuilderHandler
6 6
 {
7
-    /**
8
-    * @param string|Raw $column The database column which holds the JSON value
9
-    * @param string|Raw|string[] $nodes The json key/index to search
10
-    * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
11
-    * @param mixed|null $value
12
-    * @return static
13
-    */
14
-    public function whereJson($column, $nodes, $operator = null, $value = null): self
15
-    {
16
-        // If two params are given then assume operator is =
17
-        if (3 === func_num_args()) {
18
-            $value    = $operator;
19
-            $operator = '=';
20
-        }
21
-
22
-        return $this->whereJsonHandler($column, $nodes, $operator, $value, 'AND');
23
-    }
24
-
25
-    /**
26
-     * @param string|Raw $column The database column which holds the JSON value
27
-     * @param string|Raw|string[] $nodes The json key/index to search
28
-     * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
29
-     * @param mixed|null $value
30
-     * @return static
31
-     */
32
-    public function whereNotJson($column, $nodes, $operator = null, $value = null): self
33
-    {
34
-        // If two params are given then assume operator is =
35
-        if (3 === func_num_args()) {
36
-            $value    = $operator;
37
-            $operator = '=';
38
-        }
39
-
40
-        return $this->whereJsonHandler($column, $nodes, $operator, $value, 'AND NOT');
41
-    }
42
-
43
-    /**
44
-    * @param string|Raw $column The database column which holds the JSON value
45
-    * @param string|Raw|string[] $nodes The json key/index to search
46
-    * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
47
-    * @param mixed|null $value
48
-    * @return static
49
-    */
50
-    public function orWhereJson($column, $nodes, $operator = null, $value = null): self
51
-    {
52
-        // If two params are given then assume operator is =
53
-        if (3 === func_num_args()) {
54
-            $value    = $operator;
55
-            $operator = '=';
56
-        }
57
-
58
-        return $this->whereJsonHandler($column, $nodes, $operator, $value, 'OR');
59
-    }
60
-
61
-    /**
62
-    * @param string|Raw $column The database column which holds the JSON value
63
-    * @param string|Raw|string[] $nodes The json key/index to search
64
-    * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
65
-    * @param mixed|null $value
66
-    * @return static
67
-    */
68
-    public function orWhereNotJson($column, $nodes, $operator = null, $value = null): self
69
-    {
70
-        // If two params are given then assume operator is =
71
-        if (3 === func_num_args()) {
72
-            $value    = $operator;
73
-            $operator = '=';
74
-        }
75
-
76
-        return $this->whereJsonHandler($column, $nodes, $operator, $value, 'OR NOT');
77
-    }
78
-
79
-    /**
80
-    * @param string|Raw $column The database column which holds the JSON value
81
-    * @param string|Raw|string[] $nodes The json key/index to search
82
-    * @param mixed[] $values
83
-    * @return static
84
-    */
85
-    public function whereInJson($column, $nodes, $values): self
86
-    {
87
-        return $this->whereJsonHandler($column, $nodes, 'IN', $values, 'AND');
88
-    }
89
-
90
-    /**
91
-    * @param string|Raw $column The database column which holds the JSON value
92
-    * @param string|Raw|string[] $nodes The json key/index to search
93
-    * @param mixed[] $values
94
-    * @return static
95
-    */
96
-    public function whereNotInJson($column, $nodes, $values): self
97
-    {
98
-        return $this->whereJsonHandler($column, $nodes, 'NOT IN', $values, 'AND');
99
-    }
100
-
101
-    /**
102
-    * @param string|Raw $column The database column which holds the JSON value
103
-    * @param string|Raw|string[] $nodes The json key/index to search
104
-    * @param mixed[] $values
105
-    * @return static
106
-    */
107
-    public function orWhereInJson($column, $nodes, $values): self
108
-    {
109
-        return $this->whereJsonHandler($column, $nodes, 'IN', $values, 'OR');
110
-    }
111
-
112
-    /**
113
-    * @param string|Raw $column The database column which holds the JSON value
114
-    * @param string|Raw|string[] $nodes The json key/index to search
115
-    * @param mixed[] $values
116
-    * @return static
117
-    */
118
-    public function orWhereNotInJson($column, $nodes, $values): self
119
-    {
120
-        return $this->whereJsonHandler($column, $nodes, 'NOT IN', $values, 'OR');
121
-    }
122
-
123
-    /**
124
-     * @param string|Raw $column
125
-    * @param string|Raw|string[] $nodes The json key/index to search
126
-     * @param mixed $valueFrom
127
-     * @param mixed $valueTo
128
-     *
129
-     * @return static
130
-     */
131
-    public function whereBetweenJson($column, $nodes, $valueFrom, $valueTo): self
132
-    {
133
-        return $this->whereJsonHandler($column, $nodes, 'BETWEEN', [$valueFrom, $valueTo], 'AND');
134
-    }
135
-
136
-    /**
137
-     * @param string|Raw $column
138
-    * @param string|Raw|string[] $nodes The json key/index to search
139
-     * @param mixed $valueFrom
140
-     * @param mixed $valueTo
141
-     *
142
-     * @return static
143
-     */
144
-    public function orWhereBetweenJson($column, $nodes, $valueFrom, $valueTo): self
145
-    {
146
-        return $this->whereJsonHandler($column, $nodes, 'BETWEEN', [$valueFrom, $valueTo], 'OR');
147
-    }
148
-
149
-    /**
150
-    * @param string|Raw $column The database column which holds the JSON value
151
-    * @param string|Raw|string[] $nodes The json key/index to search
152
-    * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
153
-    * @param mixed|null $value
154
-    * @return static
155
-    */
156
-    public function whereDayJson($column, $nodes, $operator = null, $value = null): self
157
-    {
158
-        // If two params are given then assume operator is =
159
-        if (3 === func_num_args()) {
160
-            $value    = $operator;
161
-            $operator = '=';
162
-        }
163
-        return $this->whereFunctionCallJsonHandler($column, $nodes, 'DAY', $operator, $value);
164
-    }
165
-
166
-    /**
167
-    * @param string|Raw $column The database column which holds the JSON value
168
-    * @param string|Raw|string[] $nodes The json key/index to search
169
-    * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
170
-    * @param mixed|null $value
171
-    * @return static
172
-    */
173
-    public function whereMonthJson($column, $nodes, $operator = null, $value = null): self
174
-    {
175
-        // If two params are given then assume operator is =
176
-        if (3 === func_num_args()) {
177
-            $value    = $operator;
178
-            $operator = '=';
179
-        }
180
-        return $this->whereFunctionCallJsonHandler($column, $nodes, 'MONTH', $operator, $value);
181
-    }
182
-
183
-    /**
184
-    * @param string|Raw $column The database column which holds the JSON value
185
-    * @param string|Raw|string[] $nodes The json key/index to search
186
-    * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
187
-    * @param mixed|null $value
188
-    * @return static
189
-    */
190
-    public function whereYearJson($column, $nodes, $operator = null, $value = null): self
191
-    {
192
-        // If two params are given then assume operator is =
193
-        if (3 === func_num_args()) {
194
-            $value    = $operator;
195
-            $operator = '=';
196
-        }
197
-        return $this->whereFunctionCallJsonHandler($column, $nodes, 'YEAR', $operator, $value);
198
-    }
199
-
200
-    /**
201
-    * @param string|Raw $column The database column which holds the JSON value
202
-    * @param string|Raw|string[] $nodes The json key/index to search
203
-    * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
204
-    * @param mixed|null $value
205
-    * @return static
206
-    */
207
-    public function whereDateJson($column, $nodes, $operator = null, $value = null): self
208
-    {
209
-        // If two params are given then assume operator is =
210
-        if (3 === func_num_args()) {
211
-            $value    = $operator;
212
-            $operator = '=';
213
-        }
214
-        return $this->whereFunctionCallJsonHandler($column, $nodes, 'DATE', $operator, $value);
215
-    }
216
-
217
-    /**
218
-     * Maps a function call for a JSON where condition
219
-     *
220
-     * @param string|Raw $column
221
-     * @param string|Raw|string[] $nodes
222
-     * @param string $function
223
-     * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
224
-     * @param mixed|null $value
225
-     * @return static
226
-     */
227
-    protected function whereFunctionCallJsonHandler($column, $nodes, $function, $operator, $value): self
228
-    {
229
-        // Handle potential raw values.
230
-        if ($column instanceof Raw) {
231
-            $column = $this->adapterInstance->parseRaw($column);
232
-        }
233
-        if ($nodes instanceof Raw) {
234
-            $nodes = $this->adapterInstance->parseRaw($nodes);
235
-        }
236
-
237
-        return $this->whereFunctionCallHandler(
238
-            $this->jsonHandler->jsonExpressionFactory()->extractAndUnquote($column, $nodes),
239
-            $function,
240
-            $operator,
241
-            $value
242
-        );
243
-    }
244
-
245
-    /**
246
-    * @param string|Raw $column The database column which holds the JSON value
247
-    * @param string|Raw|string[] $nodes The json key/index to search
248
-    * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
249
-    * @param mixed|null $value
250
-    * @param string $joiner
251
-    * @return static
252
-    */
253
-    protected function whereJsonHandler($column, $nodes, $operator = null, $value = null, string $joiner = 'AND'): self
254
-    {
255
-        // Handle potential raw values.
256
-        if ($column instanceof Raw) {
257
-            $column = $this->adapterInstance->parseRaw($column);
258
-        }
259
-        if ($nodes instanceof Raw) {
260
-            $nodes = $this->adapterInstance->parseRaw($nodes);
261
-        }
262
-
263
-        return $this->whereHandler(
264
-            $this->jsonHandler->jsonExpressionFactory()->extractAndUnquote($column, $nodes),
265
-            $operator,
266
-            $value,
267
-            $joiner
268
-        );
269
-    }
270
-
271
-    /**
272
-     * @param string|Raw $table
273
-     * @param string|Raw $leftColumn
274
-     * @param string|Raw|string[]|null $leftNodes The json key/index to search
275
-     * @param string $operator
276
-     * @param string|Raw $rightColumn
277
-     * @param string|Raw|string[]|null $rightNodes
278
-     * @param string $type
279
-     *
280
-     * @return static
281
-     */
282
-    public function joinJson(
283
-        $table,
284
-        $leftColumn,
285
-        $leftNodes,
286
-        string $operator,
287
-        $rightColumn,
288
-        $rightNodes,
289
-        $type = 'inner'
290
-    ): self {
291
-        // Convert key if json
292
-        if (null !== $rightNodes) {
293
-            $rightColumn = $this->jsonHandler->jsonExpressionFactory()->extractAndUnquote($rightColumn, $rightNodes);
294
-        }
295
-
296
-        // Convert key if json
297
-        if (null !== $leftNodes) {
298
-            $leftColumn = $this->jsonHandler->jsonExpressionFactory()->extractAndUnquote($leftColumn, $leftNodes);
299
-        }
300
-
301
-        return $this->join($table, $leftColumn, $operator, $rightColumn, $type);
302
-    }
303
-
304
-    /**
305
-     * @param string|Raw $table
306
-     * @param string|Raw $leftColumn
307
-     * @param string|Raw|string[]|null $leftNodes The json key/index to search
308
-     * @param string $operator
309
-     * @param string|Raw $rightColumn
310
-     * @param string|Raw|string[]|null $rightNodes
311
-     *
312
-     * @return static
313
-     */
314
-    public function leftJoinJson(
315
-        $table,
316
-        $leftColumn,
317
-        $leftNodes,
318
-        string $operator,
319
-        $rightColumn,
320
-        $rightNodes
321
-    ): self {
322
-        return $this->joinJson(
323
-            $table,
324
-            $leftColumn,
325
-            $leftNodes,
326
-            $operator,
327
-            $rightColumn,
328
-            $rightNodes,
329
-            'left'
330
-        );
331
-    }
332
-
333
-    /**
334
-     * @param string|Raw $table
335
-     * @param string|Raw $leftColumn
336
-     * @param string|Raw|string[]|null $leftNodes The json key/index to search
337
-     * @param string $operator
338
-     * @param string|Raw $rightColumn
339
-     * @param string|Raw|string[]|null $rightNodes
340
-     *
341
-     * @return static
342
-     */
343
-    public function rightJoinJson(
344
-        $table,
345
-        $leftColumn,
346
-        $leftNodes,
347
-        string $operator,
348
-        $rightColumn,
349
-        $rightNodes
350
-    ): self {
351
-        return $this->joinJson(
352
-            $table,
353
-            $leftColumn,
354
-            $leftNodes,
355
-            $operator,
356
-            $rightColumn,
357
-            $rightNodes,
358
-            'right'
359
-        );
360
-    }
361
-
362
-    /**
363
-     * @param string|Raw $table
364
-     * @param string|Raw $leftColumn
365
-     * @param string|Raw|string[]|null $leftNodes The json key/index to search
366
-     * @param string $operator
367
-     * @param string|Raw $rightColumn
368
-     * @param string|Raw|string[]|null $rightNodes
369
-     *
370
-     * @return static
371
-     */
372
-    public function outerJoinJson(
373
-        $table,
374
-        $leftColumn,
375
-        $leftNodes,
376
-        string $operator,
377
-        $rightColumn,
378
-        $rightNodes
379
-    ): self {
380
-        return $this->joinJson(
381
-            $table,
382
-            $leftColumn,
383
-            $leftNodes,
384
-            $operator,
385
-            $rightColumn,
386
-            $rightNodes,
387
-            'FULL OUTER'
388
-        );
389
-    }
390
-
391
-    /**
392
-     * @param string|Raw $table
393
-     * @param string|Raw $leftColumn
394
-     * @param string|Raw|string[]|null $leftNodes The json key/index to search
395
-     * @param string $operator
396
-     * @param string|Raw $rightColumn
397
-     * @param string|Raw|string[]|null $rightNodes
398
-     *
399
-     * @return static
400
-     */
401
-    public function crossJoinJson(
402
-        $table,
403
-        $leftColumn,
404
-        $leftNodes,
405
-        string $operator,
406
-        $rightColumn,
407
-        $rightNodes
408
-    ): self {
409
-        return $this->joinJson(
410
-            $table,
411
-            $leftColumn,
412
-            $leftNodes,
413
-            $operator,
414
-            $rightColumn,
415
-            $rightNodes,
416
-            'cross'
417
-        );
418
-    }
419
-
420
-
421
-
422
-    // JSON
423
-
424
-    /**
425
-     * @param string|Raw $column The database column which holds the JSON value
426
-     * @param string|Raw|string[] $nodes The json key/index to search
427
-     * @param string|null $alias The alias used to define the value in results, if not defined will use json_{$nodes}
428
-     * @return static
429
-     */
430
-    public function selectJson($column, $nodes, ?string $alias = null): self
431
-    {
432
-        // Handle potential raw values.
433
-        if ($column instanceof Raw) {
434
-            $column = $this->adapterInstance->parseRaw($column);
435
-        }
436
-        if ($nodes instanceof Raw) {
437
-            $nodes = $this->adapterInstance->parseRaw($nodes);
438
-        }
439
-
440
-        // If deeply nested jsonKey.
441
-        if (is_array($nodes)) {
442
-            $nodes = \implode('.', $nodes);
443
-        }
444
-
445
-        // Add any possible prefixes to the key
446
-        $column = $this->addTablePrefix($column, true);
447
-
448
-        $alias = null === $alias ? "json_{$nodes}" : $alias;
449
-        return  $this->select(new Raw("JSON_UNQUOTE(JSON_EXTRACT({$column}, \"$.{$nodes}\")) as {$alias}"));
450
-    }
7
+	/**
8
+	 * @param string|Raw $column The database column which holds the JSON value
9
+	 * @param string|Raw|string[] $nodes The json key/index to search
10
+	 * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
11
+	 * @param mixed|null $value
12
+	 * @return static
13
+	 */
14
+	public function whereJson($column, $nodes, $operator = null, $value = null): self
15
+	{
16
+		// If two params are given then assume operator is =
17
+		if (3 === func_num_args()) {
18
+			$value    = $operator;
19
+			$operator = '=';
20
+		}
21
+
22
+		return $this->whereJsonHandler($column, $nodes, $operator, $value, 'AND');
23
+	}
24
+
25
+	/**
26
+	 * @param string|Raw $column The database column which holds the JSON value
27
+	 * @param string|Raw|string[] $nodes The json key/index to search
28
+	 * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
29
+	 * @param mixed|null $value
30
+	 * @return static
31
+	 */
32
+	public function whereNotJson($column, $nodes, $operator = null, $value = null): self
33
+	{
34
+		// If two params are given then assume operator is =
35
+		if (3 === func_num_args()) {
36
+			$value    = $operator;
37
+			$operator = '=';
38
+		}
39
+
40
+		return $this->whereJsonHandler($column, $nodes, $operator, $value, 'AND NOT');
41
+	}
42
+
43
+	/**
44
+	 * @param string|Raw $column The database column which holds the JSON value
45
+	 * @param string|Raw|string[] $nodes The json key/index to search
46
+	 * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
47
+	 * @param mixed|null $value
48
+	 * @return static
49
+	 */
50
+	public function orWhereJson($column, $nodes, $operator = null, $value = null): self
51
+	{
52
+		// If two params are given then assume operator is =
53
+		if (3 === func_num_args()) {
54
+			$value    = $operator;
55
+			$operator = '=';
56
+		}
57
+
58
+		return $this->whereJsonHandler($column, $nodes, $operator, $value, 'OR');
59
+	}
60
+
61
+	/**
62
+	 * @param string|Raw $column The database column which holds the JSON value
63
+	 * @param string|Raw|string[] $nodes The json key/index to search
64
+	 * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
65
+	 * @param mixed|null $value
66
+	 * @return static
67
+	 */
68
+	public function orWhereNotJson($column, $nodes, $operator = null, $value = null): self
69
+	{
70
+		// If two params are given then assume operator is =
71
+		if (3 === func_num_args()) {
72
+			$value    = $operator;
73
+			$operator = '=';
74
+		}
75
+
76
+		return $this->whereJsonHandler($column, $nodes, $operator, $value, 'OR NOT');
77
+	}
78
+
79
+	/**
80
+	 * @param string|Raw $column The database column which holds the JSON value
81
+	 * @param string|Raw|string[] $nodes The json key/index to search
82
+	 * @param mixed[] $values
83
+	 * @return static
84
+	 */
85
+	public function whereInJson($column, $nodes, $values): self
86
+	{
87
+		return $this->whereJsonHandler($column, $nodes, 'IN', $values, 'AND');
88
+	}
89
+
90
+	/**
91
+	 * @param string|Raw $column The database column which holds the JSON value
92
+	 * @param string|Raw|string[] $nodes The json key/index to search
93
+	 * @param mixed[] $values
94
+	 * @return static
95
+	 */
96
+	public function whereNotInJson($column, $nodes, $values): self
97
+	{
98
+		return $this->whereJsonHandler($column, $nodes, 'NOT IN', $values, 'AND');
99
+	}
100
+
101
+	/**
102
+	 * @param string|Raw $column The database column which holds the JSON value
103
+	 * @param string|Raw|string[] $nodes The json key/index to search
104
+	 * @param mixed[] $values
105
+	 * @return static
106
+	 */
107
+	public function orWhereInJson($column, $nodes, $values): self
108
+	{
109
+		return $this->whereJsonHandler($column, $nodes, 'IN', $values, 'OR');
110
+	}
111
+
112
+	/**
113
+	 * @param string|Raw $column The database column which holds the JSON value
114
+	 * @param string|Raw|string[] $nodes The json key/index to search
115
+	 * @param mixed[] $values
116
+	 * @return static
117
+	 */
118
+	public function orWhereNotInJson($column, $nodes, $values): self
119
+	{
120
+		return $this->whereJsonHandler($column, $nodes, 'NOT IN', $values, 'OR');
121
+	}
122
+
123
+	/**
124
+	 * @param string|Raw $column
125
+	 * @param string|Raw|string[] $nodes The json key/index to search
126
+	 * @param mixed $valueFrom
127
+	 * @param mixed $valueTo
128
+	 *
129
+	 * @return static
130
+	 */
131
+	public function whereBetweenJson($column, $nodes, $valueFrom, $valueTo): self
132
+	{
133
+		return $this->whereJsonHandler($column, $nodes, 'BETWEEN', [$valueFrom, $valueTo], 'AND');
134
+	}
135
+
136
+	/**
137
+	 * @param string|Raw $column
138
+	 * @param string|Raw|string[] $nodes The json key/index to search
139
+	 * @param mixed $valueFrom
140
+	 * @param mixed $valueTo
141
+	 *
142
+	 * @return static
143
+	 */
144
+	public function orWhereBetweenJson($column, $nodes, $valueFrom, $valueTo): self
145
+	{
146
+		return $this->whereJsonHandler($column, $nodes, 'BETWEEN', [$valueFrom, $valueTo], 'OR');
147
+	}
148
+
149
+	/**
150
+	 * @param string|Raw $column The database column which holds the JSON value
151
+	 * @param string|Raw|string[] $nodes The json key/index to search
152
+	 * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
153
+	 * @param mixed|null $value
154
+	 * @return static
155
+	 */
156
+	public function whereDayJson($column, $nodes, $operator = null, $value = null): self
157
+	{
158
+		// If two params are given then assume operator is =
159
+		if (3 === func_num_args()) {
160
+			$value    = $operator;
161
+			$operator = '=';
162
+		}
163
+		return $this->whereFunctionCallJsonHandler($column, $nodes, 'DAY', $operator, $value);
164
+	}
165
+
166
+	/**
167
+	 * @param string|Raw $column The database column which holds the JSON value
168
+	 * @param string|Raw|string[] $nodes The json key/index to search
169
+	 * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
170
+	 * @param mixed|null $value
171
+	 * @return static
172
+	 */
173
+	public function whereMonthJson($column, $nodes, $operator = null, $value = null): self
174
+	{
175
+		// If two params are given then assume operator is =
176
+		if (3 === func_num_args()) {
177
+			$value    = $operator;
178
+			$operator = '=';
179
+		}
180
+		return $this->whereFunctionCallJsonHandler($column, $nodes, 'MONTH', $operator, $value);
181
+	}
182
+
183
+	/**
184
+	 * @param string|Raw $column The database column which holds the JSON value
185
+	 * @param string|Raw|string[] $nodes The json key/index to search
186
+	 * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
187
+	 * @param mixed|null $value
188
+	 * @return static
189
+	 */
190
+	public function whereYearJson($column, $nodes, $operator = null, $value = null): self
191
+	{
192
+		// If two params are given then assume operator is =
193
+		if (3 === func_num_args()) {
194
+			$value    = $operator;
195
+			$operator = '=';
196
+		}
197
+		return $this->whereFunctionCallJsonHandler($column, $nodes, 'YEAR', $operator, $value);
198
+	}
199
+
200
+	/**
201
+	 * @param string|Raw $column The database column which holds the JSON value
202
+	 * @param string|Raw|string[] $nodes The json key/index to search
203
+	 * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
204
+	 * @param mixed|null $value
205
+	 * @return static
206
+	 */
207
+	public function whereDateJson($column, $nodes, $operator = null, $value = null): self
208
+	{
209
+		// If two params are given then assume operator is =
210
+		if (3 === func_num_args()) {
211
+			$value    = $operator;
212
+			$operator = '=';
213
+		}
214
+		return $this->whereFunctionCallJsonHandler($column, $nodes, 'DATE', $operator, $value);
215
+	}
216
+
217
+	/**
218
+	 * Maps a function call for a JSON where condition
219
+	 *
220
+	 * @param string|Raw $column
221
+	 * @param string|Raw|string[] $nodes
222
+	 * @param string $function
223
+	 * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
224
+	 * @param mixed|null $value
225
+	 * @return static
226
+	 */
227
+	protected function whereFunctionCallJsonHandler($column, $nodes, $function, $operator, $value): self
228
+	{
229
+		// Handle potential raw values.
230
+		if ($column instanceof Raw) {
231
+			$column = $this->adapterInstance->parseRaw($column);
232
+		}
233
+		if ($nodes instanceof Raw) {
234
+			$nodes = $this->adapterInstance->parseRaw($nodes);
235
+		}
236
+
237
+		return $this->whereFunctionCallHandler(
238
+			$this->jsonHandler->jsonExpressionFactory()->extractAndUnquote($column, $nodes),
239
+			$function,
240
+			$operator,
241
+			$value
242
+		);
243
+	}
244
+
245
+	/**
246
+	 * @param string|Raw $column The database column which holds the JSON value
247
+	 * @param string|Raw|string[] $nodes The json key/index to search
248
+	 * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
249
+	 * @param mixed|null $value
250
+	 * @param string $joiner
251
+	 * @return static
252
+	 */
253
+	protected function whereJsonHandler($column, $nodes, $operator = null, $value = null, string $joiner = 'AND'): self
254
+	{
255
+		// Handle potential raw values.
256
+		if ($column instanceof Raw) {
257
+			$column = $this->adapterInstance->parseRaw($column);
258
+		}
259
+		if ($nodes instanceof Raw) {
260
+			$nodes = $this->adapterInstance->parseRaw($nodes);
261
+		}
262
+
263
+		return $this->whereHandler(
264
+			$this->jsonHandler->jsonExpressionFactory()->extractAndUnquote($column, $nodes),
265
+			$operator,
266
+			$value,
267
+			$joiner
268
+		);
269
+	}
270
+
271
+	/**
272
+	 * @param string|Raw $table
273
+	 * @param string|Raw $leftColumn
274
+	 * @param string|Raw|string[]|null $leftNodes The json key/index to search
275
+	 * @param string $operator
276
+	 * @param string|Raw $rightColumn
277
+	 * @param string|Raw|string[]|null $rightNodes
278
+	 * @param string $type
279
+	 *
280
+	 * @return static
281
+	 */
282
+	public function joinJson(
283
+		$table,
284
+		$leftColumn,
285
+		$leftNodes,
286
+		string $operator,
287
+		$rightColumn,
288
+		$rightNodes,
289
+		$type = 'inner'
290
+	): self {
291
+		// Convert key if json
292
+		if (null !== $rightNodes) {
293
+			$rightColumn = $this->jsonHandler->jsonExpressionFactory()->extractAndUnquote($rightColumn, $rightNodes);
294
+		}
295
+
296
+		// Convert key if json
297
+		if (null !== $leftNodes) {
298
+			$leftColumn = $this->jsonHandler->jsonExpressionFactory()->extractAndUnquote($leftColumn, $leftNodes);
299
+		}
300
+
301
+		return $this->join($table, $leftColumn, $operator, $rightColumn, $type);
302
+	}
303
+
304
+	/**
305
+	 * @param string|Raw $table
306
+	 * @param string|Raw $leftColumn
307
+	 * @param string|Raw|string[]|null $leftNodes The json key/index to search
308
+	 * @param string $operator
309
+	 * @param string|Raw $rightColumn
310
+	 * @param string|Raw|string[]|null $rightNodes
311
+	 *
312
+	 * @return static
313
+	 */
314
+	public function leftJoinJson(
315
+		$table,
316
+		$leftColumn,
317
+		$leftNodes,
318
+		string $operator,
319
+		$rightColumn,
320
+		$rightNodes
321
+	): self {
322
+		return $this->joinJson(
323
+			$table,
324
+			$leftColumn,
325
+			$leftNodes,
326
+			$operator,
327
+			$rightColumn,
328
+			$rightNodes,
329
+			'left'
330
+		);
331
+	}
332
+
333
+	/**
334
+	 * @param string|Raw $table
335
+	 * @param string|Raw $leftColumn
336
+	 * @param string|Raw|string[]|null $leftNodes The json key/index to search
337
+	 * @param string $operator
338
+	 * @param string|Raw $rightColumn
339
+	 * @param string|Raw|string[]|null $rightNodes
340
+	 *
341
+	 * @return static
342
+	 */
343
+	public function rightJoinJson(
344
+		$table,
345
+		$leftColumn,
346
+		$leftNodes,
347
+		string $operator,
348
+		$rightColumn,
349
+		$rightNodes
350
+	): self {
351
+		return $this->joinJson(
352
+			$table,
353
+			$leftColumn,
354
+			$leftNodes,
355
+			$operator,
356
+			$rightColumn,
357
+			$rightNodes,
358
+			'right'
359
+		);
360
+	}
361
+
362
+	/**
363
+	 * @param string|Raw $table
364
+	 * @param string|Raw $leftColumn
365
+	 * @param string|Raw|string[]|null $leftNodes The json key/index to search
366
+	 * @param string $operator
367
+	 * @param string|Raw $rightColumn
368
+	 * @param string|Raw|string[]|null $rightNodes
369
+	 *
370
+	 * @return static
371
+	 */
372
+	public function outerJoinJson(
373
+		$table,
374
+		$leftColumn,
375
+		$leftNodes,
376
+		string $operator,
377
+		$rightColumn,
378
+		$rightNodes
379
+	): self {
380
+		return $this->joinJson(
381
+			$table,
382
+			$leftColumn,
383
+			$leftNodes,
384
+			$operator,
385
+			$rightColumn,
386
+			$rightNodes,
387
+			'FULL OUTER'
388
+		);
389
+	}
390
+
391
+	/**
392
+	 * @param string|Raw $table
393
+	 * @param string|Raw $leftColumn
394
+	 * @param string|Raw|string[]|null $leftNodes The json key/index to search
395
+	 * @param string $operator
396
+	 * @param string|Raw $rightColumn
397
+	 * @param string|Raw|string[]|null $rightNodes
398
+	 *
399
+	 * @return static
400
+	 */
401
+	public function crossJoinJson(
402
+		$table,
403
+		$leftColumn,
404
+		$leftNodes,
405
+		string $operator,
406
+		$rightColumn,
407
+		$rightNodes
408
+	): self {
409
+		return $this->joinJson(
410
+			$table,
411
+			$leftColumn,
412
+			$leftNodes,
413
+			$operator,
414
+			$rightColumn,
415
+			$rightNodes,
416
+			'cross'
417
+		);
418
+	}
419
+
420
+
421
+
422
+	// JSON
423
+
424
+	/**
425
+	 * @param string|Raw $column The database column which holds the JSON value
426
+	 * @param string|Raw|string[] $nodes The json key/index to search
427
+	 * @param string|null $alias The alias used to define the value in results, if not defined will use json_{$nodes}
428
+	 * @return static
429
+	 */
430
+	public function selectJson($column, $nodes, ?string $alias = null): self
431
+	{
432
+		// Handle potential raw values.
433
+		if ($column instanceof Raw) {
434
+			$column = $this->adapterInstance->parseRaw($column);
435
+		}
436
+		if ($nodes instanceof Raw) {
437
+			$nodes = $this->adapterInstance->parseRaw($nodes);
438
+		}
439
+
440
+		// If deeply nested jsonKey.
441
+		if (is_array($nodes)) {
442
+			$nodes = \implode('.', $nodes);
443
+		}
444
+
445
+		// Add any possible prefixes to the key
446
+		$column = $this->addTablePrefix($column, true);
447
+
448
+		$alias = null === $alias ? "json_{$nodes}" : $alias;
449
+		return  $this->select(new Raw("JSON_UNQUOTE(JSON_EXTRACT({$column}, \"$.{$nodes}\")) as {$alias}"));
450
+	}
451 451
 }
Please login to merge, or discard this patch.
src/QueryBuilder/QueryBuilderHandler.php 2 patches
Indentation   +1494 added lines, -1494 removed lines patch added patch discarded remove patch
@@ -24,1498 +24,1498 @@
 block discarded – undo
24 24
 
25 25
 class QueryBuilderHandler implements HasConnection
26 26
 {
27
-    /**
28
-     * @method add
29
-     */
30
-    use TablePrefixer;
31
-
32
-    /**
33
-     * @var \Viocon\Container
34
-     */
35
-    protected $container;
36
-
37
-    /**
38
-     * @var Connection
39
-     */
40
-    protected $connection;
41
-
42
-    /**
43
-     * @var array<string, mixed[]|mixed>
44
-     */
45
-    protected $statements = [];
46
-
47
-    /**
48
-     * @var wpdb
49
-     */
50
-    protected $dbInstance;
51
-
52
-    /**
53
-     * @var string|string[]|null
54
-     */
55
-    protected $sqlStatement = null;
56
-
57
-    /**
58
-     * @var string|null
59
-     */
60
-    protected $tablePrefix = null;
61
-
62
-    /**
63
-     * @var WPDBAdapter
64
-     */
65
-    protected $adapterInstance;
66
-
67
-    /**
68
-     * The mode to return results as.
69
-     * Accepts WPDB constants or class names.
70
-     *
71
-     * @var string
72
-     */
73
-    protected $fetchMode;
74
-
75
-    /**
76
-     * Custom args used to construct models for hydrator
77
-     *
78
-     * @var array<int, mixed>|null
79
-     */
80
-    protected $hydratorConstructorArgs;
81
-
82
-    /**
83
-     * Handler for Json Selectors
84
-     *
85
-     * @var JsonHandler
86
-     */
87
-    protected $jsonHandler;
88
-
89
-    /**
90
-     * @param \Pixie\Connection|null $connection
91
-     * @param string $fetchMode
92
-     * @param mixed[] $hydratorConstructorArgs
93
-     *
94
-     * @throws Exception if no connection passed and not previously established
95
-     */
96
-    final public function __construct(
97
-        Connection $connection = null,
98
-        string $fetchMode = \OBJECT,
99
-        ?array $hydratorConstructorArgs = null
100
-    ) {
101
-        if (is_null($connection)) {
102
-            // throws if connection not already established.
103
-            $connection = Connection::getStoredConnection();
104
-        }
105
-
106
-        // Set all dependencies from connection.
107
-        $this->connection = $connection;
108
-        $this->container  = $this->connection->getContainer();
109
-        $this->dbInstance = $this->connection->getDbInstance();
110
-        $this->setAdapterConfig($this->connection->getAdapterConfig());
111
-
112
-        // Set up optional hydration details.
113
-        $this->setFetchMode($fetchMode);
114
-        $this->hydratorConstructorArgs = $hydratorConstructorArgs;
115
-
116
-        // Query builder adapter instance
117
-        $this->adapterInstance = $this->container->build(
118
-            WPDBAdapter::class,
119
-            [$this->connection]
120
-        );
121
-
122
-        // Setup JSON Selector handler.
123
-        $this->jsonHandler = new JsonHandler($connection);
124
-    }
125
-
126
-    /**
127
-     * Sets the config for WPDB
128
-     *
129
-     * @param array<string, mixed> $adapterConfig
130
-     *
131
-     * @return void
132
-     */
133
-    protected function setAdapterConfig(array $adapterConfig): void
134
-    {
135
-        if (isset($adapterConfig[Connection::PREFIX])) {
136
-            $this->tablePrefix = $adapterConfig[Connection::PREFIX];
137
-        }
138
-    }
139
-
140
-    /**
141
-     * Fetch query results as object of specified type
142
-     *
143
-     * @param string $className
144
-     * @param array<int, mixed> $constructorArgs
145
-     * @return static
146
-     */
147
-    public function asObject($className, $constructorArgs = array()): self
148
-    {
149
-        return $this->setFetchMode($className, $constructorArgs);
150
-    }
151
-
152
-    /**
153
-     * Set the fetch mode
154
-     *
155
-     * @param string $mode
156
-     * @param array<int, mixed>|null $constructorArgs
157
-     *
158
-     * @return static
159
-     */
160
-    public function setFetchMode(string $mode, ?array $constructorArgs = null): self
161
-    {
162
-        $this->fetchMode               = $mode;
163
-        $this->hydratorConstructorArgs = $constructorArgs;
164
-
165
-        return $this;
166
-    }
167
-
168
-    /**
169
-     * @param Connection|null $connection
170
-     *
171
-     * @return static
172
-     *
173
-     * @throws Exception
174
-     */
175
-    public function newQuery(Connection $connection = null): self
176
-    {
177
-        if (is_null($connection)) {
178
-            $connection = $this->connection;
179
-        }
180
-
181
-        $newQuery = $this->constructCurrentBuilderClass($connection);
182
-        $newQuery->setFetchMode($this->getFetchMode(), $this->hydratorConstructorArgs);
183
-
184
-        return $newQuery;
185
-    }
186
-
187
-    /**
188
-     * Returns a new instance of the current, with the passed connection.
189
-     *
190
-     * @param \Pixie\Connection $connection
191
-     *
192
-     * @return static
193
-     */
194
-    protected function constructCurrentBuilderClass(Connection $connection): self
195
-    {
196
-        return new static($connection);
197
-    }
198
-
199
-    /**
200
-     * Interpolates a query
201
-     *
202
-     * @param string $query
203
-     * @param array<mixed> $bindings
204
-     * @return string
205
-     */
206
-    public function interpolateQuery(string $query, array $bindings = []): string
207
-    {
208
-        return $this->adapterInstance->interpolateQuery($query, $bindings);
209
-    }
210
-
211
-    /**
212
-     * @param string           $sql
213
-     * @param array<int,mixed> $bindings
214
-     *
215
-     * @return static
216
-     */
217
-    public function query($sql, $bindings = []): self
218
-    {
219
-        list($this->sqlStatement) = $this->statement($sql, $bindings);
220
-
221
-        return $this;
222
-    }
223
-
224
-    /**
225
-     * @param string           $sql
226
-     * @param array<int,mixed> $bindings
227
-     *
228
-     * @return array{0:string, 1:float}
229
-     */
230
-    public function statement(string $sql, $bindings = []): array
231
-    {
232
-        $start        = microtime(true);
233
-        $sqlStatement = empty($bindings) ? $sql : $this->interpolateQuery($sql, $bindings);
234
-
235
-        if (!is_string($sqlStatement)) {
236
-            throw new Exception('Could not interpolate query', 1);
237
-        }
238
-
239
-        return [$sqlStatement, microtime(true) - $start];
240
-    }
241
-
242
-    /**
243
-     * Get all rows
244
-     *
245
-     * @return array<mixed,mixed>|null
246
-     *
247
-     * @throws Exception
248
-     */
249
-    public function get()
250
-    {
251
-        $eventResult = $this->fireEvents('before-select');
252
-        if (!is_null($eventResult)) {
253
-            return $eventResult;
254
-        }
255
-        $executionTime = 0;
256
-        if (is_null($this->sqlStatement)) {
257
-            $queryObject = $this->getQuery('select');
258
-            $statement   = $this->statement(
259
-                $queryObject->getSql(),
260
-                $queryObject->getBindings()
261
-            );
262
-
263
-            $this->sqlStatement = $statement[0];
264
-            $executionTime      = $statement[1];
265
-        }
266
-
267
-        $start  = microtime(true);
268
-        $result = $this->dbInstance()->get_results(
269
-            is_array($this->sqlStatement) ? (end($this->sqlStatement) ?: '') : $this->sqlStatement,
270
-            // If we are using the hydrator, return as OBJECT and let the hydrator map the correct model.
271
-            $this->useHydrator() ? OBJECT : $this->getFetchMode()
272
-        );
273
-        $executionTime += microtime(true) - $start;
274
-        $this->sqlStatement = null;
275
-
276
-        // Ensure we have an array of results.
277
-        if (!is_array($result) && null !== $result) {
278
-            $result = [$result];
279
-        }
280
-
281
-        // Maybe hydrate the results.
282
-        if (null !== $result && $this->useHydrator()) {
283
-            $result = $this->getHydrator()->fromMany($result);
284
-        }
285
-
286
-        $this->fireEvents('after-select', $result, $executionTime);
287
-
288
-        return $result;
289
-    }
290
-
291
-    /**
292
-     * Returns a populated instance of the Hydrator.
293
-     *
294
-     * @return Hydrator
295
-     */
296
-    protected function getHydrator(): Hydrator /* @phpstan-ignore-line */
297
-    {
298
-        $hydrator = new Hydrator($this->getFetchMode(), $this->hydratorConstructorArgs ?? []); /* @phpstan-ignore-line */
299
-
300
-        return $hydrator;
301
-    }
302
-
303
-    /**
304
-     * Checks if the results should be mapped via the hydrator
305
-     *
306
-     * @return bool
307
-     */
308
-    protected function useHydrator(): bool
309
-    {
310
-        return !in_array($this->getFetchMode(), [\ARRAY_A, \ARRAY_N, \OBJECT, \OBJECT_K]);
311
-    }
312
-
313
-    /**
314
-     * Find all matching a simple where condition.
315
-     *
316
-     * Shortcut of ->where('key','=','value')->limit(1)->get();
317
-     *
318
-     * @return \stdClass\array<mixed,mixed>|object|null Can return any object using hydrator
319
-     */
320
-    public function first()
321
-    {
322
-        $this->limit(1);
323
-        $result = $this->get();
324
-
325
-        return empty($result) ? null : $result[0];
326
-    }
327
-
328
-    /**
329
-     * Find all matching a simple where condition.
330
-     *
331
-     * Shortcut of ->where('key','=','value')->get();
332
-     *
333
-     * @param string $fieldName
334
-     * @param mixed $value
335
-     *
336
-     * @return array<mixed,mixed>|null Can return any object using hydrator
337
-     */
338
-    public function findAll($fieldName, $value)
339
-    {
340
-        $this->where($fieldName, '=', $value);
341
-
342
-        return $this->get();
343
-    }
344
-
345
-    /**
346
-     * @param string $fieldName
347
-     * @param mixed $value
348
-     *
349
-     * @return \stdClass\array<mixed,mixed>|object|null Can return any object using hydrator
350
-     */
351
-    public function find($value, $fieldName = 'id')
352
-    {
353
-        $this->where($fieldName, '=', $value);
354
-
355
-        return $this->first();
356
-    }
357
-
358
-    /**
359
-     * @param string $fieldName
360
-     * @param mixed $value
361
-     *
362
-     * @return \stdClass\array<mixed,mixed>|object Can return any object using hydrator
363
-     * @throws Exception If fails to find
364
-     */
365
-    public function findOrFail($value, $fieldName = 'id')
366
-    {
367
-        $result = $this->find($value, $fieldName);
368
-        if (null === $result) {
369
-            throw new Exception("Failed to find {$fieldName}={$value}", 1);
370
-        }
371
-        return $result;
372
-    }
373
-
374
-    /**
375
-     * Used to handle all aggregation method.
376
-     *
377
-     * @see Taken from the pecee-pixie library - https://github.com/skipperbent/pecee-pixie/
378
-     *
379
-     * @param string $type
380
-     * @param string|Raw $field
381
-     *
382
-     * @return float
383
-     */
384
-    protected function aggregate(string $type, $field = '*'): float
385
-    {
386
-        // Parse a raw expression.
387
-        if ($field instanceof Raw) {
388
-            $field = $this->adapterInstance->parseRaw($field);
389
-        }
390
-
391
-        // Potentialy cast field from JSON
392
-        if ($this->jsonHandler->isJsonSelector($field)) {
393
-            $field = $this->jsonHandler->extractAndUnquoteFromJsonSelector($field);
394
-        }
395
-
396
-        // Verify that field exists
397
-        if ('*' !== $field && true === isset($this->statements['selects']) && false === \in_array($field, $this->statements['selects'], true)) {
398
-            throw new \Exception(sprintf('Failed %s query - the column %s hasn\'t been selected in the query.', $type, $field));
399
-        }
400
-
401
-
402
-        if (false === isset($this->statements['tables'])) {
403
-            throw new Exception('No table selected');
404
-        }
405
-
406
-        $count = $this
407
-            ->table($this->subQuery($this, 'count'))
408
-            ->select([$this->raw(sprintf('%s(%s) AS field', strtoupper($type), $field))])
409
-            ->first();
410
-
411
-        return true === isset($count->field) ? (float)$count->field : 0;
412
-    }
413
-
414
-    /**
415
-     * Get count of all the rows for the current query
416
-     *
417
-     * @see Taken from the pecee-pixie library - https://github.com/skipperbent/pecee-pixie/
418
-     *
419
-     * @param string|Raw $field
420
-     *
421
-     * @return int
422
-     *
423
-     * @throws Exception
424
-     */
425
-    public function count($field = '*'): int
426
-    {
427
-        return (int)$this->aggregate('count', $field);
428
-    }
429
-
430
-    /**
431
-     * Get the sum for a field in the current query
432
-     *
433
-     * @see Taken from the pecee-pixie library - https://github.com/skipperbent/pecee-pixie/
434
-     *
435
-     * @param string|Raw $field
436
-     *
437
-     * @return float
438
-     *
439
-     * @throws Exception
440
-     */
441
-    public function sum($field): float
442
-    {
443
-        return $this->aggregate('sum', $field);
444
-    }
445
-
446
-    /**
447
-     * Get the average for a field in the current query
448
-     *
449
-     * @see Taken from the pecee-pixie library - https://github.com/skipperbent/pecee-pixie/
450
-     *
451
-     * @param string|Raw $field
452
-     *
453
-     * @return float
454
-     *
455
-     * @throws Exception
456
-     */
457
-    public function average($field): float
458
-    {
459
-        return $this->aggregate('avg', $field);
460
-    }
461
-
462
-    /**
463
-     * Get the minimum for a field in the current query
464
-     *
465
-     * @see Taken from the pecee-pixie library - https://github.com/skipperbent/pecee-pixie/
466
-     *
467
-     * @param string|Raw $field
468
-     *
469
-     * @return float
470
-     *
471
-     * @throws Exception
472
-     */
473
-    public function min($field): float
474
-    {
475
-        return $this->aggregate('min', $field);
476
-    }
477
-
478
-    /**
479
-     * Get the maximum for a field in the current query
480
-     *
481
-     * @see Taken from the pecee-pixie library - https://github.com/skipperbent/pecee-pixie/
482
-     *
483
-     * @param string|Raw $field
484
-     *
485
-     * @return float
486
-     *
487
-     * @throws Exception
488
-     */
489
-    public function max($field): float
490
-    {
491
-        return $this->aggregate('max', $field);
492
-    }
493
-
494
-    /**
495
-     * @param string $type
496
-     * @param bool|array<mixed, mixed> $dataToBePassed
497
-     *
498
-     * @return mixed
499
-     *
500
-     * @throws Exception
501
-     */
502
-    public function getQuery(string $type = 'select', $dataToBePassed = [])
503
-    {
504
-        $allowedTypes = ['select', 'insert', 'insertignore', 'replace', 'delete', 'update', 'criteriaonly'];
505
-        if (!in_array(strtolower($type), $allowedTypes)) {
506
-            throw new Exception($type . ' is not a known type.', 2);
507
-        }
508
-
509
-        $queryArr = $this->adapterInstance->$type($this->statements, $dataToBePassed);
510
-
511
-        return $this->container->build(
512
-            QueryObject::class,
513
-            [$queryArr['sql'], $queryArr['bindings'], $this->dbInstance]
514
-        );
515
-    }
516
-
517
-    /**
518
-     * @param QueryBuilderHandler $queryBuilder
519
-     * @param string|null $alias
520
-     *
521
-     * @return Raw
522
-     */
523
-    public function subQuery(QueryBuilderHandler $queryBuilder, ?string $alias = null)
524
-    {
525
-        $sql = '(' . $queryBuilder->getQuery()->getRawSql() . ')';
526
-        if (is_string($alias) && 0 !== mb_strlen($alias)) {
527
-            $sql = $sql . ' as ' . $alias;
528
-        }
529
-
530
-        return $queryBuilder->raw($sql);
531
-    }
532
-
533
-    /**
534
-     * Handles the various insert operations based on the type.
535
-     *
536
-     * @param array<int|string, mixed|mixed[]> $data
537
-     * @param string $type
538
-     *
539
-     * @return int|int[]|mixed|null can return a single row id, array of row ids, null (for failed) or any other value short circuited from event
540
-     */
541
-    private function doInsert(array $data, string $type)
542
-    {
543
-        $eventResult = $this->fireEvents('before-insert');
544
-        if (!is_null($eventResult)) {
545
-            return $eventResult;
546
-        }
547
-
548
-        // If first value is not an array () not a batch insert)
549
-        if (!is_array(current($data))) {
550
-            $queryObject = $this->getQuery($type, $data);
551
-
552
-            list($preparedQuery, $executionTime) = $this->statement($queryObject->getSql(), $queryObject->getBindings());
553
-            $this->dbInstance->get_results($preparedQuery);
554
-
555
-            // Check we have a result.
556
-            $return = 1 === $this->dbInstance->rows_affected ? $this->dbInstance->insert_id : null;
557
-        } else {
558
-            // Its a batch insert
559
-            $return        = [];
560
-            $executionTime = 0;
561
-            foreach ($data as $subData) {
562
-                $queryObject = $this->getQuery($type, $subData);
563
-
564
-                list($preparedQuery, $time) = $this->statement($queryObject->getSql(), $queryObject->getBindings());
565
-                $this->dbInstance->get_results($preparedQuery);
566
-                $executionTime += $time;
567
-
568
-                if (1 === $this->dbInstance->rows_affected) {
569
-                    $return[] = $this->dbInstance->insert_id;
570
-                }
571
-            }
572
-        }
573
-
574
-        $this->fireEvents('after-insert', $return, $executionTime);
575
-
576
-        return $return;
577
-    }
578
-
579
-    /**
580
-     * @param array<int|string, mixed|mixed[]> $data either key=>value array for single or array of arrays for bulk
581
-     *
582
-     * @return int|int[]|mixed|null can return a single row id, array of row ids, null (for failed) or any other value short circuited from event
583
-     */
584
-    public function insert($data)
585
-    {
586
-        return $this->doInsert($data, 'insert');
587
-    }
588
-
589
-    /**
590
-     *
591
-     * @param array<int|string, mixed|mixed[]> $data either key=>value array for single or array of arrays for bulk
592
-     *
593
-     * @return int|int[]|mixed|null can return a single row id, array of row ids, null (for failed) or any other value short circuited from event
594
-     */
595
-    public function insertIgnore($data)
596
-    {
597
-        return $this->doInsert($data, 'insertignore');
598
-    }
599
-
600
-    /**
601
-     *
602
-     * @param array<int|string, mixed|mixed[]> $data either key=>value array for single or array of arrays for bulk
603
-     *
604
-     * @return int|int[]|mixed|null can return a single row id, array of row ids, null (for failed) or any other value short circuited from event
605
-     */
606
-    public function replace($data)
607
-    {
608
-        return $this->doInsert($data, 'replace');
609
-    }
610
-
611
-    /**
612
-     * @param array<string, mixed> $data
613
-     *
614
-     * @return int|null
615
-     */
616
-    public function update($data)
617
-    {
618
-        $eventResult = $this->fireEvents('before-update');
619
-        if (!is_null($eventResult)) {
620
-            return $eventResult;
621
-        }
622
-        $queryObject                         = $this->getQuery('update', $data);
623
-        $r = $this->statement($queryObject->getSql(), $queryObject->getBindings());
624
-        list($preparedQuery, $executionTime) = $r;
625
-        $this->dbInstance()->get_results($preparedQuery);
626
-        $this->fireEvents('after-update', $queryObject, $executionTime);
627
-
628
-        return 0 !== $this->dbInstance()->rows_affected
629
-            ? $this->dbInstance()->rows_affected
630
-            : null;
631
-    }
632
-
633
-    /**
634
-     * @param array<string, mixed> $data
635
-     *
636
-     * @return int|null will return row id for insert and bool for success/fail on update
637
-     */
638
-    public function updateOrInsert($data)
639
-    {
640
-        if ($this->first()) {
641
-            return $this->update($data);
642
-        }
643
-
644
-        return $this->insert($data);
645
-    }
646
-
647
-    /**
648
-     * @param array<string, mixed> $data
649
-     *
650
-     * @return static
651
-     */
652
-    public function onDuplicateKeyUpdate($data)
653
-    {
654
-        $this->addStatement('onduplicate', $data);
655
-
656
-        return $this;
657
-    }
658
-
659
-    /**
660
-     * @return mixed number of rows effected or shortcircuited response
661
-     */
662
-    public function delete()
663
-    {
664
-        $eventResult = $this->fireEvents('before-delete');
665
-        if (!is_null($eventResult)) {
666
-            return $eventResult;
667
-        }
668
-
669
-        $queryObject = $this->getQuery('delete');
670
-
671
-        list($preparedQuery, $executionTime) = $this->statement($queryObject->getSql(), $queryObject->getBindings());
672
-        $this->dbInstance()->get_results($preparedQuery);
673
-        $this->fireEvents('after-delete', $queryObject, $executionTime);
674
-
675
-        return $this->dbInstance()->rows_affected;
676
-    }
677
-
678
-    /**
679
-     * @param string|Raw ...$tables Single table or array of tables
680
-     *
681
-     * @return static
682
-     *
683
-     * @throws Exception
684
-     */
685
-    public function table(...$tables)
686
-    {
687
-        $instance =  $this->constructCurrentBuilderClass($this->connection);
688
-        $this->setFetchMode($this->getFetchMode(), $this->hydratorConstructorArgs);
689
-        $tables = $this->addTablePrefix($tables, false);
690
-        $instance->addStatement('tables', $tables);
691
-
692
-        return $instance;
693
-    }
694
-
695
-    /**
696
-     * @param string|Raw ...$tables Single table or array of tables
697
-     *
698
-     * @return static
699
-     */
700
-    public function from(...$tables): self
701
-    {
702
-        $tables = $this->addTablePrefix($tables, false);
703
-        $this->addStatement('tables', $tables);
704
-
705
-        return $this;
706
-    }
707
-
708
-    /**
709
-     * @param string|string[]|Raw[]|array<string, string> $fields
710
-     *
711
-     * @return static
712
-     */
713
-    public function select($fields): self
714
-    {
715
-        if (!is_array($fields)) {
716
-            $fields = func_get_args();
717
-        }
718
-
719
-        foreach ($fields as $field => $alias) {
720
-            // If we have a JSON expression
721
-            if ($this->jsonHandler->isJsonSelector($field)) {
722
-                $field = $this->jsonHandler->extractAndUnquoteFromJsonSelector($field);
723
-            }
724
-
725
-            // If no alias passed, but field is for JSON. thrown an exception.
726
-            if (is_numeric($field) && is_string($alias) && $this->jsonHandler->isJsonSelector($alias)) {
727
-                throw new Exception("An alias must be used if you wish to select from JSON Object", 1);
728
-            }
729
-
730
-            // Treat each array as a single table, to retain order added
731
-            $field = is_numeric($field)
732
-                ? $field = $alias // If single colum
733
-                : $field = [$field => $alias]; // Has alias
734
-
735
-            $field = $this->addTablePrefix($field);
736
-            $this->addStatement('selects', $field);
737
-        }
738
-
739
-        return $this;
740
-    }
741
-
742
-    /**
743
-     * @param string|string[]|Raw[]|array<string, string> $fields
744
-     *
745
-     * @return static
746
-     */
747
-    public function selectDistinct($fields)
748
-    {
749
-        $this->select($fields);
750
-        $this->addStatement('distinct', true);
751
-
752
-        return $this;
753
-    }
754
-
755
-    /**
756
-     * @param string|string[] $field either the single field or an array of fields
757
-     *
758
-     * @return static
759
-     */
760
-    public function groupBy($field): self
761
-    {
762
-        $field = $this->addTablePrefix($field);
763
-        $this->addStatement('groupBys', $field);
764
-
765
-        return $this;
766
-    }
767
-
768
-    /**
769
-     * @param string|array<string|int, mixed> $fields
770
-     * @param string          $defaultDirection
771
-     *
772
-     * @return static
773
-     */
774
-    public function orderBy($fields, string $defaultDirection = 'ASC'): self
775
-    {
776
-        if (!is_array($fields)) {
777
-            $fields = [$fields];
778
-        }
779
-
780
-        foreach ($fields as $key => $value) {
781
-            $field = $key;
782
-            $type  = $value;
783
-            if (is_int($key)) {
784
-                $field = $value;
785
-                $type  = $defaultDirection;
786
-            }
787
-
788
-            if ($this->jsonHandler->isJsonSelector($field)) {
789
-                $field = $this->jsonHandler->extractAndUnquoteFromJsonSelector($field);
790
-            }
791
-
792
-            if (!$field instanceof Raw) {
793
-                $field = $this->addTablePrefix($field);
794
-            }
795
-            $this->statements['orderBys'][] = compact('field', 'type');
796
-        }
797
-
798
-        return $this;
799
-    }
800
-
801
-    /**
802
-     * @param string|Raw $key The database column which holds the JSON value
803
-     * @param string|Raw|string[] $jsonKey The json key/index to search
804
-     * @param string $defaultDirection
805
-     * @return static
806
-     */
807
-    public function orderByJson($key, $jsonKey, string $defaultDirection = 'ASC'): self
808
-    {
809
-        $key = $this->jsonHandler->jsonExpressionFactory()->extractAndUnquote($key, $jsonKey);
810
-        return $this->orderBy($key, $defaultDirection);
811
-    }
812
-
813
-    /**
814
-     * @param int $limit
815
-     *
816
-     * @return static
817
-     */
818
-    public function limit(int $limit): self
819
-    {
820
-        $this->statements['limit'] = $limit;
821
-
822
-        return $this;
823
-    }
824
-
825
-    /**
826
-     * @param int $offset
827
-     *
828
-     * @return static
829
-     */
830
-    public function offset(int $offset): self
831
-    {
832
-        $this->statements['offset'] = $offset;
833
-
834
-        return $this;
835
-    }
836
-
837
-    /**
838
-     * @param string|string[]|Raw|Raw[]       $key
839
-     * @param string $operator
840
-     * @param mixed $value
841
-     * @param string $joiner
842
-     *
843
-     * @return static
844
-     */
845
-    public function having($key, string $operator, $value, string $joiner = 'AND')
846
-    {
847
-        $key                           = $this->addTablePrefix($key);
848
-        $this->statements['havings'][] = compact('key', 'operator', 'value', 'joiner');
849
-
850
-        return $this;
851
-    }
852
-
853
-    /**
854
-     * @param string|string[]|Raw|Raw[]       $key
855
-     * @param string $operator
856
-     * @param mixed $value
857
-     *
858
-     * @return static
859
-     */
860
-    public function orHaving($key, $operator, $value)
861
-    {
862
-        return $this->having($key, $operator, $value, 'OR');
863
-    }
864
-
865
-    /**
866
-     * @param string|Raw $key
867
-     * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
868
-     * @param mixed|null $value
869
-     *
870
-     * @return static
871
-     */
872
-    public function where($key, $operator = null, $value = null): self
873
-    {
874
-        // If two params are given then assume operator is =
875
-        if (2 === func_num_args()) {
876
-            $value    = $operator;
877
-            $operator = '=';
878
-        }
879
-
880
-        return $this->whereHandler($key, $operator, $value);
881
-    }
882
-
883
-    /**
884
-     * @param string|Raw|\Closure(QueryBuilderHandler):void $key
885
-     * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
886
-     * @param mixed|null $value
887
-     *
888
-     * @return static
889
-     */
890
-    public function orWhere($key, $operator = null, $value = null): self
891
-    {
892
-        // If two params are given then assume operator is =
893
-        if (2 === func_num_args()) {
894
-            $value    = $operator;
895
-            $operator = '=';
896
-        }
897
-
898
-        return $this->whereHandler($key, $operator, $value, 'OR');
899
-    }
900
-
901
-    /**
902
-     * @param string|Raw $key
903
-     * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
904
-     * @param mixed|null $value
905
-     *
906
-     * @return static
907
-     */
908
-    public function whereNot($key, $operator = null, $value = null): self
909
-    {
910
-        // If two params are given then assume operator is =
911
-        if (2 === func_num_args()) {
912
-            $value    = $operator;
913
-            $operator = '=';
914
-        }
915
-
916
-        return $this->whereHandler($key, $operator, $value, 'AND NOT');
917
-    }
918
-
919
-    /**
920
-     * @param string|Raw $key
921
-     * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
922
-     * @param mixed|null $value
923
-     *
924
-     * @return static
925
-     */
926
-    public function orWhereNot($key, $operator = null, $value = null)
927
-    {
928
-        // If two params are given then assume operator is =
929
-        if (2 === func_num_args()) {
930
-            $value    = $operator;
931
-            $operator = '=';
932
-        }
933
-
934
-        return $this->whereHandler($key, $operator, $value, 'OR NOT');
935
-    }
936
-
937
-    /**
938
-     * @param string|Raw $key
939
-     * @param mixed[]|string|Raw $values
940
-     *
941
-     * @return static
942
-     */
943
-    public function whereIn($key, $values): self
944
-    {
945
-        return $this->whereHandler($key, 'IN', $values, 'AND');
946
-    }
947
-
948
-    /**
949
-     * @param string|Raw $key
950
-     * @param mixed[]|string|Raw $values
951
-     *
952
-     * @return static
953
-     */
954
-    public function whereNotIn($key, $values): self
955
-    {
956
-        return $this->whereHandler($key, 'NOT IN', $values, 'AND');
957
-    }
958
-
959
-    /**
960
-     * @param string|Raw $key
961
-     * @param mixed[]|string|Raw $values
962
-     *
963
-     * @return static
964
-     */
965
-    public function orWhereIn($key, $values): self
966
-    {
967
-        return $this->whereHandler($key, 'IN', $values, 'OR');
968
-    }
969
-
970
-    /**
971
-     * @param string|Raw $key
972
-     * @param mixed[]|string|Raw $values
973
-     *
974
-     * @return static
975
-     */
976
-    public function orWhereNotIn($key, $values): self
977
-    {
978
-        return $this->whereHandler($key, 'NOT IN', $values, 'OR');
979
-    }
980
-
981
-    /**
982
-     * @param string|Raw $key
983
-     * @param mixed $valueFrom
984
-     * @param mixed $valueTo
985
-     *
986
-     * @return static
987
-     */
988
-    public function whereBetween($key, $valueFrom, $valueTo): self
989
-    {
990
-        return $this->whereHandler($key, 'BETWEEN', [$valueFrom, $valueTo], 'AND');
991
-    }
992
-
993
-    /**
994
-     * @param string|Raw $key
995
-     * @param mixed $valueFrom
996
-     * @param mixed $valueTo
997
-     *
998
-     * @return static
999
-     */
1000
-    public function orWhereBetween($key, $valueFrom, $valueTo): self
1001
-    {
1002
-        return $this->whereHandler($key, 'BETWEEN', [$valueFrom, $valueTo], 'OR');
1003
-    }
1004
-
1005
-    /**
1006
-     * Handles all function call based where conditions
1007
-     *
1008
-     * @param string|Raw $key
1009
-     * @param string $function
1010
-     * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
1011
-     * @param mixed|null $value
1012
-     * @return static
1013
-     */
1014
-    protected function whereFunctionCallHandler($key, $function, $operator, $value): self
1015
-    {
1016
-        $key = \sprintf('%s(%s)', $function, $this->addTablePrefix($key));
1017
-        return $this->where($key, $operator, $value);
1018
-    }
1019
-
1020
-    /**
1021
-     * @param string|Raw $key
1022
-     * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
1023
-     * @param mixed|null $value
1024
-     * @return self
1025
-     */
1026
-    public function whereMonth($key, $operator = null, $value = null): self
1027
-    {
1028
-        // If two params are given then assume operator is =
1029
-        if (2 === func_num_args()) {
1030
-            $value    = $operator;
1031
-            $operator = '=';
1032
-        }
1033
-        return $this->whereFunctionCallHandler($key, 'MONTH', $operator, $value);
1034
-    }
1035
-
1036
-    /**
1037
-     * @param string|Raw $key
1038
-     * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
1039
-     * @param mixed|null $value
1040
-     * @return self
1041
-     */
1042
-    public function whereDay($key, $operator = null, $value = null): self
1043
-    {
1044
-        // If two params are given then assume operator is =
1045
-        if (2 === func_num_args()) {
1046
-            $value    = $operator;
1047
-            $operator = '=';
1048
-        }
1049
-        return $this->whereFunctionCallHandler($key, 'DAY', $operator, $value);
1050
-    }
1051
-
1052
-    /**
1053
-     * @param string|Raw $key
1054
-     * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
1055
-     * @param mixed|null $value
1056
-     * @return self
1057
-     */
1058
-    public function whereYear($key, $operator = null, $value = null): self
1059
-    {
1060
-        // If two params are given then assume operator is =
1061
-        if (2 === func_num_args()) {
1062
-            $value    = $operator;
1063
-            $operator = '=';
1064
-        }
1065
-        return $this->whereFunctionCallHandler($key, 'YEAR', $operator, $value);
1066
-    }
1067
-
1068
-    /**
1069
-     * @param string|Raw $key
1070
-     * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
1071
-     * @param mixed|null $value
1072
-     * @return self
1073
-     */
1074
-    public function whereDate($key, $operator = null, $value = null): self
1075
-    {
1076
-        // If two params are given then assume operator is =
1077
-        if (2 === func_num_args()) {
1078
-            $value    = $operator;
1079
-            $operator = '=';
1080
-        }
1081
-        return $this->whereFunctionCallHandler($key, 'DATE', $operator, $value);
1082
-    }
1083
-
1084
-    /**
1085
-     * @param string|Raw $key
1086
-     *
1087
-     * @return static
1088
-     */
1089
-    public function whereNull($key): self
1090
-    {
1091
-        return $this->whereNullHandler($key);
1092
-    }
1093
-
1094
-    /**
1095
-     * @param string|Raw $key
1096
-     *
1097
-     * @return static
1098
-     */
1099
-    public function whereNotNull($key): self
1100
-    {
1101
-        return $this->whereNullHandler($key, 'NOT');
1102
-    }
1103
-
1104
-    /**
1105
-     * @param string|Raw $key
1106
-     *
1107
-     * @return static
1108
-     */
1109
-    public function orWhereNull($key): self
1110
-    {
1111
-        return $this->whereNullHandler($key, '', 'or');
1112
-    }
1113
-
1114
-    /**
1115
-     * @param string|Raw $key
1116
-     *
1117
-     * @return static
1118
-     */
1119
-    public function orWhereNotNull($key): self
1120
-    {
1121
-        return $this->whereNullHandler($key, 'NOT', 'or');
1122
-    }
1123
-
1124
-    /**
1125
-     * @param string|Raw $key
1126
-     * @param string $prefix
1127
-     * @param string $operator
1128
-     *
1129
-     * @return static
1130
-     */
1131
-    protected function whereNullHandler($key, string $prefix = '', $operator = ''): self
1132
-    {
1133
-        $prefix = 0 === mb_strlen($prefix) ? '' : " {$prefix}";
1134
-
1135
-        if ($key instanceof Raw) {
1136
-            $key = $this->adapterInstance->parseRaw($key);
1137
-        }
1138
-
1139
-        $key = $this->addTablePrefix($key);
1140
-        if ($key instanceof Closure) {
1141
-            throw new Exception('Key used for whereNull condition must be a string or raw exrpession.', 1);
1142
-        }
1143
-
1144
-        return $this->{$operator . 'Where'}($this->raw("{$key} IS{$prefix} NULL"));
1145
-    }
1146
-
1147
-
1148
-    /**
1149
-     * Runs a transaction
1150
-     *
1151
-     * @param \Closure(Transaction):void $callback
1152
-     *
1153
-     * @return static
1154
-     */
1155
-    public function transaction(Closure $callback): self
1156
-    {
1157
-        try {
1158
-            // Begin the transaction
1159
-            $this->dbInstance->query('START TRANSACTION');
1160
-
1161
-            // Get the Transaction class
1162
-            $transaction = $this->container->build(Transaction::class, [$this->connection]);
1163
-
1164
-            $this->handleTransactionCall($callback, $transaction);
1165
-
1166
-            // If no errors have been thrown or the transaction wasn't completed within
1167
-            $this->dbInstance->query('COMMIT');
1168
-
1169
-            return $this;
1170
-        } catch (TransactionHaltException $e) {
1171
-            // Commit or rollback behavior has been handled in the closure, so exit
1172
-            return $this;
1173
-        } catch (\Exception $e) {
1174
-            // something happened, rollback changes
1175
-            $this->dbInstance->query('ROLLBACK');
1176
-
1177
-            return $this;
1178
-        }
1179
-    }
1180
-
1181
-    /**
1182
-     * Handles the transaction call.
1183
-     * Catches any WPDB Errors (printed)
1184
-     *
1185
-     * @param Closure    $callback
1186
-     * @param Transaction $transaction
1187
-     *
1188
-     * @return void
1189
-     * @throws Exception
1190
-     */
1191
-    protected function handleTransactionCall(Closure $callback, Transaction $transaction): void
1192
-    {
1193
-        try {
1194
-            ob_start();
1195
-            $callback($transaction);
1196
-            $output = ob_get_clean() ?: '';
1197
-        } catch (Throwable $th) {
1198
-            ob_end_clean();
1199
-            throw $th;
1200
-        }
1201
-
1202
-        // If we caught an error, throw an exception.
1203
-        if (0 !== mb_strlen($output)) {
1204
-            throw new Exception($output);
1205
-        }
1206
-    }
1207
-
1208
-    /*************************************************************************/
1209
-    /*************************************************************************/
1210
-    /*************************************************************************/
1211
-    /**                              JOIN JOIN                              **/
1212
-    /**                                 JOIN                                **/
1213
-    /**                              JOIN JOIN                              **/
1214
-    /*************************************************************************/
1215
-    /*************************************************************************/
1216
-    /*************************************************************************/
1217
-
1218
-    /**
1219
-     * @param string|Raw $table
1220
-     * @param string|Raw|Closure $key
1221
-     * @param string|null $operator
1222
-     * @param mixed $value
1223
-     * @param string $type
1224
-     *
1225
-     * @return static
1226
-     */
1227
-    public function join($table, $key, ?string $operator = null, $value = null, $type = 'inner')
1228
-    {
1229
-        // Potentially cast key from JSON
1230
-        if ($this->jsonHandler->isJsonSelector($key)) {
1231
-            /** @var string $key */
1232
-            $key = $this->jsonHandler->extractAndUnquoteFromJsonSelector($key); /** @phpstan-ignore-line */
1233
-        }
1234
-
1235
-        // Potentially cast value from json
1236
-        if ($this->jsonHandler->isJsonSelector($value)) {
1237
-            /** @var string $value */
1238
-            $value = $this->jsonHandler->extractAndUnquoteFromJsonSelector($value);
1239
-        }
1240
-
1241
-        if (!$key instanceof Closure) {
1242
-            $key = function ($joinBuilder) use ($key, $operator, $value) {
1243
-                $joinBuilder->on($key, $operator, $value);
1244
-            };
1245
-        }
1246
-
1247
-        // Build a new JoinBuilder class, keep it by reference so any changes made
1248
-        // in the closure should reflect here
1249
-        $joinBuilder = $this->container->build(JoinBuilder::class, [$this->connection]);
1250
-        $joinBuilder = &$joinBuilder;
1251
-        // Call the closure with our new joinBuilder object
1252
-        $key($joinBuilder);
1253
-        $table = $this->addTablePrefix($table, false);
1254
-        // Get the criteria only query from the joinBuilder object
1255
-        $this->statements['joins'][] = compact('type', 'table', 'joinBuilder');
1256
-        return $this;
1257
-    }
1258
-
1259
-    /**
1260
-     * @param string|Raw $table
1261
-     * @param string|Raw|Closure $key
1262
-     * @param string|null $operator
1263
-     * @param mixed $value
1264
-     *
1265
-     * @return static
1266
-     */
1267
-    public function leftJoin($table, $key, $operator = null, $value = null)
1268
-    {
1269
-        return $this->join($table, $key, $operator, $value, 'left');
1270
-    }
1271
-
1272
-    /**
1273
-     * @param string|Raw $table
1274
-     * @param string|Raw|Closure $key
1275
-     * @param string|null $operator
1276
-     * @param mixed $value
1277
-     *
1278
-     * @return static
1279
-     */
1280
-    public function rightJoin($table, $key, $operator = null, $value = null)
1281
-    {
1282
-        return $this->join($table, $key, $operator, $value, 'right');
1283
-    }
1284
-
1285
-    /**
1286
-     * @param string|Raw $table
1287
-     * @param string|Raw|Closure $key
1288
-     * @param string|null $operator
1289
-     * @param mixed $value
1290
-     *
1291
-     * @return static
1292
-     */
1293
-    public function innerJoin($table, $key, $operator = null, $value = null)
1294
-    {
1295
-        return $this->join($table, $key, $operator, $value, 'inner');
1296
-    }
1297
-
1298
-    /**
1299
-     * @param string|Raw $table
1300
-     * @param string|Raw|Closure $key
1301
-     * @param string|null $operator
1302
-     * @param mixed $value
1303
-     *
1304
-     * @return static
1305
-     */
1306
-    public function crossJoin($table, $key, $operator = null, $value = null)
1307
-    {
1308
-        return $this->join($table, $key, $operator, $value, 'cross');
1309
-    }
1310
-
1311
-    /**
1312
-     * @param string|Raw $table
1313
-     * @param string|Raw|Closure $key
1314
-     * @param string|null $operator
1315
-     * @param mixed $value
1316
-     *
1317
-     * @return static
1318
-     */
1319
-    public function outerJoin($table, $key, $operator = null, $value = null)
1320
-    {
1321
-        return $this->join($table, $key, $operator, $value, 'full outer');
1322
-    }
1323
-
1324
-    /**
1325
-     * Shortcut to join 2 tables on the same key name with equals
1326
-     *
1327
-     * @param string $table
1328
-     * @param string $key
1329
-     * @param string $type
1330
-     * @return self
1331
-     * @throws Exception If base table is set as more than 1 or 0
1332
-     */
1333
-    public function joinUsing(string $table, string $key, string $type = 'INNER'): self
1334
-    {
1335
-        if (!array_key_exists('tables', $this->statements) || count($this->statements['tables']) !== 1) {
1336
-            throw new Exception("JoinUsing can only be used with a single table set as the base of the query", 1);
1337
-        }
1338
-        $baseTable = end($this->statements['tables']);
1339
-
1340
-        // Potentialy cast key from JSON
1341
-        if ($this->jsonHandler->isJsonSelector($key)) {
1342
-            $key = $this->jsonHandler->extractAndUnquoteFromJsonSelector($key);
1343
-        }
1344
-
1345
-        $remoteKey = $table = $this->addTablePrefix("{$table}.{$key}", true);
1346
-        $localKey = $table = $this->addTablePrefix("{$baseTable}.{$key}", true);
1347
-        return $this->join($table, $remoteKey, '=', $localKey, $type);
1348
-    }
1349
-
1350
-    /**
1351
-     * Add a raw query
1352
-     *
1353
-     * @param string|Raw $value
1354
-     * @param mixed|mixed[] $bindings
1355
-     *
1356
-     * @return Raw
1357
-     */
1358
-    public function raw($value, $bindings = []): Raw
1359
-    {
1360
-        return new Raw($value, $bindings);
1361
-    }
1362
-
1363
-    /**
1364
-     * Return wpdb instance
1365
-     *
1366
-     * @return wpdb
1367
-     */
1368
-    public function dbInstance(): wpdb
1369
-    {
1370
-        return $this->dbInstance;
1371
-    }
1372
-
1373
-    /**
1374
-     * @param Connection $connection
1375
-     *
1376
-     * @return static
1377
-     */
1378
-    public function setConnection(Connection $connection): self
1379
-    {
1380
-        $this->connection = $connection;
1381
-
1382
-        return $this;
1383
-    }
1384
-
1385
-    /**
1386
-     * @return Connection
1387
-     */
1388
-    public function getConnection(): Connection
1389
-    {
1390
-        return $this->connection;
1391
-    }
1392
-
1393
-    /**
1394
-     * @param string|Raw|Closure $key
1395
-     * @param string|null      $operator
1396
-     * @param mixed|null       $value
1397
-     * @param string $joiner
1398
-     *
1399
-     * @return static
1400
-     */
1401
-    protected function whereHandler($key, $operator = null, $value = null, $joiner = 'AND')
1402
-    {
1403
-        $key = $this->addTablePrefix($key);
1404
-        if ($key instanceof Raw) {
1405
-            $key = $this->adapterInstance->parseRaw($key);
1406
-        }
1407
-
1408
-        if ($this->jsonHandler->isJsonSelector($key)) {
1409
-            $key = $this->jsonHandler->extractAndUnquoteFromJsonSelector($key);
1410
-        }
1411
-
1412
-        $this->statements['wheres'][] = compact('key', 'operator', 'value', 'joiner');
1413
-        return $this;
1414
-    }
1415
-
1416
-
1417
-
1418
-    /**
1419
-     * @param string $key
1420
-     * @param mixed|mixed[]|bool $value
1421
-     *
1422
-     * @return void
1423
-     */
1424
-    protected function addStatement($key, $value)
1425
-    {
1426
-        if (!is_array($value)) {
1427
-            $value = [$value];
1428
-        }
1429
-
1430
-        if (!array_key_exists($key, $this->statements)) {
1431
-            $this->statements[$key] = $value;
1432
-        } else {
1433
-            $this->statements[$key] = array_merge($this->statements[$key], $value);
1434
-        }
1435
-    }
1436
-
1437
-    /**
1438
-     * @param string $event
1439
-     * @param string|Raw $table
1440
-     *
1441
-     * @return callable|null
1442
-     */
1443
-    public function getEvent(string $event, $table = ':any'): ?callable
1444
-    {
1445
-        return $this->connection->getEventHandler()->getEvent($event, $table);
1446
-    }
1447
-
1448
-    /**
1449
-     * @param string $event
1450
-     * @param string|Raw $table
1451
-     * @param Closure $action
1452
-     *
1453
-     * @return void
1454
-     */
1455
-    public function registerEvent($event, $table, Closure $action): void
1456
-    {
1457
-        $table = $table ?: ':any';
1458
-
1459
-        if (':any' != $table) {
1460
-            $table = $this->addTablePrefix($table, false);
1461
-        }
1462
-
1463
-        $this->connection->getEventHandler()->registerEvent($event, $table, $action);
1464
-    }
1465
-
1466
-    /**
1467
-     * @param string $event
1468
-     * @param string|Raw $table
1469
-     *
1470
-     * @return void
1471
-     */
1472
-    public function removeEvent(string $event, $table = ':any')
1473
-    {
1474
-        if (':any' != $table) {
1475
-            $table = $this->addTablePrefix($table, false);
1476
-        }
1477
-
1478
-        $this->connection->getEventHandler()->removeEvent($event, $table);
1479
-    }
1480
-
1481
-    /**
1482
-     * @param string $event
1483
-     *
1484
-     * @return mixed
1485
-     */
1486
-    public function fireEvents(string $event)
1487
-    {
1488
-        $params = func_get_args(); // @todo Replace this with an easier to read alteratnive
1489
-        array_unshift($params, $this);
1490
-
1491
-        return call_user_func_array([$this->connection->getEventHandler(), 'fireEvents'], $params);
1492
-    }
1493
-
1494
-    /**
1495
-     * @return array<string, mixed[]>
1496
-     */
1497
-    public function getStatements()
1498
-    {
1499
-        return $this->statements;
1500
-    }
1501
-
1502
-    /**
1503
-     * @return string will return WPDB Fetch mode
1504
-     */
1505
-    public function getFetchMode()
1506
-    {
1507
-        return null !== $this->fetchMode
1508
-            ? $this->fetchMode
1509
-            : \OBJECT;
1510
-    }
1511
-
1512
-    /**
1513
-     * Returns an NEW instance of the JSON builder populated with the same connection and hydrator details.
1514
-     *
1515
-     * @return JsonQueryBuilder
1516
-     */
1517
-    public function jsonBuilder(): JsonQueryBuilder
1518
-    {
1519
-        return new JsonQueryBuilder($this->getConnection(), $this->getFetchMode(), $this->hydratorConstructorArgs);
1520
-    }
27
+	/**
28
+	 * @method add
29
+	 */
30
+	use TablePrefixer;
31
+
32
+	/**
33
+	 * @var \Viocon\Container
34
+	 */
35
+	protected $container;
36
+
37
+	/**
38
+	 * @var Connection
39
+	 */
40
+	protected $connection;
41
+
42
+	/**
43
+	 * @var array<string, mixed[]|mixed>
44
+	 */
45
+	protected $statements = [];
46
+
47
+	/**
48
+	 * @var wpdb
49
+	 */
50
+	protected $dbInstance;
51
+
52
+	/**
53
+	 * @var string|string[]|null
54
+	 */
55
+	protected $sqlStatement = null;
56
+
57
+	/**
58
+	 * @var string|null
59
+	 */
60
+	protected $tablePrefix = null;
61
+
62
+	/**
63
+	 * @var WPDBAdapter
64
+	 */
65
+	protected $adapterInstance;
66
+
67
+	/**
68
+	 * The mode to return results as.
69
+	 * Accepts WPDB constants or class names.
70
+	 *
71
+	 * @var string
72
+	 */
73
+	protected $fetchMode;
74
+
75
+	/**
76
+	 * Custom args used to construct models for hydrator
77
+	 *
78
+	 * @var array<int, mixed>|null
79
+	 */
80
+	protected $hydratorConstructorArgs;
81
+
82
+	/**
83
+	 * Handler for Json Selectors
84
+	 *
85
+	 * @var JsonHandler
86
+	 */
87
+	protected $jsonHandler;
88
+
89
+	/**
90
+	 * @param \Pixie\Connection|null $connection
91
+	 * @param string $fetchMode
92
+	 * @param mixed[] $hydratorConstructorArgs
93
+	 *
94
+	 * @throws Exception if no connection passed and not previously established
95
+	 */
96
+	final public function __construct(
97
+		Connection $connection = null,
98
+		string $fetchMode = \OBJECT,
99
+		?array $hydratorConstructorArgs = null
100
+	) {
101
+		if (is_null($connection)) {
102
+			// throws if connection not already established.
103
+			$connection = Connection::getStoredConnection();
104
+		}
105
+
106
+		// Set all dependencies from connection.
107
+		$this->connection = $connection;
108
+		$this->container  = $this->connection->getContainer();
109
+		$this->dbInstance = $this->connection->getDbInstance();
110
+		$this->setAdapterConfig($this->connection->getAdapterConfig());
111
+
112
+		// Set up optional hydration details.
113
+		$this->setFetchMode($fetchMode);
114
+		$this->hydratorConstructorArgs = $hydratorConstructorArgs;
115
+
116
+		// Query builder adapter instance
117
+		$this->adapterInstance = $this->container->build(
118
+			WPDBAdapter::class,
119
+			[$this->connection]
120
+		);
121
+
122
+		// Setup JSON Selector handler.
123
+		$this->jsonHandler = new JsonHandler($connection);
124
+	}
125
+
126
+	/**
127
+	 * Sets the config for WPDB
128
+	 *
129
+	 * @param array<string, mixed> $adapterConfig
130
+	 *
131
+	 * @return void
132
+	 */
133
+	protected function setAdapterConfig(array $adapterConfig): void
134
+	{
135
+		if (isset($adapterConfig[Connection::PREFIX])) {
136
+			$this->tablePrefix = $adapterConfig[Connection::PREFIX];
137
+		}
138
+	}
139
+
140
+	/**
141
+	 * Fetch query results as object of specified type
142
+	 *
143
+	 * @param string $className
144
+	 * @param array<int, mixed> $constructorArgs
145
+	 * @return static
146
+	 */
147
+	public function asObject($className, $constructorArgs = array()): self
148
+	{
149
+		return $this->setFetchMode($className, $constructorArgs);
150
+	}
151
+
152
+	/**
153
+	 * Set the fetch mode
154
+	 *
155
+	 * @param string $mode
156
+	 * @param array<int, mixed>|null $constructorArgs
157
+	 *
158
+	 * @return static
159
+	 */
160
+	public function setFetchMode(string $mode, ?array $constructorArgs = null): self
161
+	{
162
+		$this->fetchMode               = $mode;
163
+		$this->hydratorConstructorArgs = $constructorArgs;
164
+
165
+		return $this;
166
+	}
167
+
168
+	/**
169
+	 * @param Connection|null $connection
170
+	 *
171
+	 * @return static
172
+	 *
173
+	 * @throws Exception
174
+	 */
175
+	public function newQuery(Connection $connection = null): self
176
+	{
177
+		if (is_null($connection)) {
178
+			$connection = $this->connection;
179
+		}
180
+
181
+		$newQuery = $this->constructCurrentBuilderClass($connection);
182
+		$newQuery->setFetchMode($this->getFetchMode(), $this->hydratorConstructorArgs);
183
+
184
+		return $newQuery;
185
+	}
186
+
187
+	/**
188
+	 * Returns a new instance of the current, with the passed connection.
189
+	 *
190
+	 * @param \Pixie\Connection $connection
191
+	 *
192
+	 * @return static
193
+	 */
194
+	protected function constructCurrentBuilderClass(Connection $connection): self
195
+	{
196
+		return new static($connection);
197
+	}
198
+
199
+	/**
200
+	 * Interpolates a query
201
+	 *
202
+	 * @param string $query
203
+	 * @param array<mixed> $bindings
204
+	 * @return string
205
+	 */
206
+	public function interpolateQuery(string $query, array $bindings = []): string
207
+	{
208
+		return $this->adapterInstance->interpolateQuery($query, $bindings);
209
+	}
210
+
211
+	/**
212
+	 * @param string           $sql
213
+	 * @param array<int,mixed> $bindings
214
+	 *
215
+	 * @return static
216
+	 */
217
+	public function query($sql, $bindings = []): self
218
+	{
219
+		list($this->sqlStatement) = $this->statement($sql, $bindings);
220
+
221
+		return $this;
222
+	}
223
+
224
+	/**
225
+	 * @param string           $sql
226
+	 * @param array<int,mixed> $bindings
227
+	 *
228
+	 * @return array{0:string, 1:float}
229
+	 */
230
+	public function statement(string $sql, $bindings = []): array
231
+	{
232
+		$start        = microtime(true);
233
+		$sqlStatement = empty($bindings) ? $sql : $this->interpolateQuery($sql, $bindings);
234
+
235
+		if (!is_string($sqlStatement)) {
236
+			throw new Exception('Could not interpolate query', 1);
237
+		}
238
+
239
+		return [$sqlStatement, microtime(true) - $start];
240
+	}
241
+
242
+	/**
243
+	 * Get all rows
244
+	 *
245
+	 * @return array<mixed,mixed>|null
246
+	 *
247
+	 * @throws Exception
248
+	 */
249
+	public function get()
250
+	{
251
+		$eventResult = $this->fireEvents('before-select');
252
+		if (!is_null($eventResult)) {
253
+			return $eventResult;
254
+		}
255
+		$executionTime = 0;
256
+		if (is_null($this->sqlStatement)) {
257
+			$queryObject = $this->getQuery('select');
258
+			$statement   = $this->statement(
259
+				$queryObject->getSql(),
260
+				$queryObject->getBindings()
261
+			);
262
+
263
+			$this->sqlStatement = $statement[0];
264
+			$executionTime      = $statement[1];
265
+		}
266
+
267
+		$start  = microtime(true);
268
+		$result = $this->dbInstance()->get_results(
269
+			is_array($this->sqlStatement) ? (end($this->sqlStatement) ?: '') : $this->sqlStatement,
270
+			// If we are using the hydrator, return as OBJECT and let the hydrator map the correct model.
271
+			$this->useHydrator() ? OBJECT : $this->getFetchMode()
272
+		);
273
+		$executionTime += microtime(true) - $start;
274
+		$this->sqlStatement = null;
275
+
276
+		// Ensure we have an array of results.
277
+		if (!is_array($result) && null !== $result) {
278
+			$result = [$result];
279
+		}
280
+
281
+		// Maybe hydrate the results.
282
+		if (null !== $result && $this->useHydrator()) {
283
+			$result = $this->getHydrator()->fromMany($result);
284
+		}
285
+
286
+		$this->fireEvents('after-select', $result, $executionTime);
287
+
288
+		return $result;
289
+	}
290
+
291
+	/**
292
+	 * Returns a populated instance of the Hydrator.
293
+	 *
294
+	 * @return Hydrator
295
+	 */
296
+	protected function getHydrator(): Hydrator /* @phpstan-ignore-line */
297
+	{
298
+		$hydrator = new Hydrator($this->getFetchMode(), $this->hydratorConstructorArgs ?? []); /* @phpstan-ignore-line */
299
+
300
+		return $hydrator;
301
+	}
302
+
303
+	/**
304
+	 * Checks if the results should be mapped via the hydrator
305
+	 *
306
+	 * @return bool
307
+	 */
308
+	protected function useHydrator(): bool
309
+	{
310
+		return !in_array($this->getFetchMode(), [\ARRAY_A, \ARRAY_N, \OBJECT, \OBJECT_K]);
311
+	}
312
+
313
+	/**
314
+	 * Find all matching a simple where condition.
315
+	 *
316
+	 * Shortcut of ->where('key','=','value')->limit(1)->get();
317
+	 *
318
+	 * @return \stdClass\array<mixed,mixed>|object|null Can return any object using hydrator
319
+	 */
320
+	public function first()
321
+	{
322
+		$this->limit(1);
323
+		$result = $this->get();
324
+
325
+		return empty($result) ? null : $result[0];
326
+	}
327
+
328
+	/**
329
+	 * Find all matching a simple where condition.
330
+	 *
331
+	 * Shortcut of ->where('key','=','value')->get();
332
+	 *
333
+	 * @param string $fieldName
334
+	 * @param mixed $value
335
+	 *
336
+	 * @return array<mixed,mixed>|null Can return any object using hydrator
337
+	 */
338
+	public function findAll($fieldName, $value)
339
+	{
340
+		$this->where($fieldName, '=', $value);
341
+
342
+		return $this->get();
343
+	}
344
+
345
+	/**
346
+	 * @param string $fieldName
347
+	 * @param mixed $value
348
+	 *
349
+	 * @return \stdClass\array<mixed,mixed>|object|null Can return any object using hydrator
350
+	 */
351
+	public function find($value, $fieldName = 'id')
352
+	{
353
+		$this->where($fieldName, '=', $value);
354
+
355
+		return $this->first();
356
+	}
357
+
358
+	/**
359
+	 * @param string $fieldName
360
+	 * @param mixed $value
361
+	 *
362
+	 * @return \stdClass\array<mixed,mixed>|object Can return any object using hydrator
363
+	 * @throws Exception If fails to find
364
+	 */
365
+	public function findOrFail($value, $fieldName = 'id')
366
+	{
367
+		$result = $this->find($value, $fieldName);
368
+		if (null === $result) {
369
+			throw new Exception("Failed to find {$fieldName}={$value}", 1);
370
+		}
371
+		return $result;
372
+	}
373
+
374
+	/**
375
+	 * Used to handle all aggregation method.
376
+	 *
377
+	 * @see Taken from the pecee-pixie library - https://github.com/skipperbent/pecee-pixie/
378
+	 *
379
+	 * @param string $type
380
+	 * @param string|Raw $field
381
+	 *
382
+	 * @return float
383
+	 */
384
+	protected function aggregate(string $type, $field = '*'): float
385
+	{
386
+		// Parse a raw expression.
387
+		if ($field instanceof Raw) {
388
+			$field = $this->adapterInstance->parseRaw($field);
389
+		}
390
+
391
+		// Potentialy cast field from JSON
392
+		if ($this->jsonHandler->isJsonSelector($field)) {
393
+			$field = $this->jsonHandler->extractAndUnquoteFromJsonSelector($field);
394
+		}
395
+
396
+		// Verify that field exists
397
+		if ('*' !== $field && true === isset($this->statements['selects']) && false === \in_array($field, $this->statements['selects'], true)) {
398
+			throw new \Exception(sprintf('Failed %s query - the column %s hasn\'t been selected in the query.', $type, $field));
399
+		}
400
+
401
+
402
+		if (false === isset($this->statements['tables'])) {
403
+			throw new Exception('No table selected');
404
+		}
405
+
406
+		$count = $this
407
+			->table($this->subQuery($this, 'count'))
408
+			->select([$this->raw(sprintf('%s(%s) AS field', strtoupper($type), $field))])
409
+			->first();
410
+
411
+		return true === isset($count->field) ? (float)$count->field : 0;
412
+	}
413
+
414
+	/**
415
+	 * Get count of all the rows for the current query
416
+	 *
417
+	 * @see Taken from the pecee-pixie library - https://github.com/skipperbent/pecee-pixie/
418
+	 *
419
+	 * @param string|Raw $field
420
+	 *
421
+	 * @return int
422
+	 *
423
+	 * @throws Exception
424
+	 */
425
+	public function count($field = '*'): int
426
+	{
427
+		return (int)$this->aggregate('count', $field);
428
+	}
429
+
430
+	/**
431
+	 * Get the sum for a field in the current query
432
+	 *
433
+	 * @see Taken from the pecee-pixie library - https://github.com/skipperbent/pecee-pixie/
434
+	 *
435
+	 * @param string|Raw $field
436
+	 *
437
+	 * @return float
438
+	 *
439
+	 * @throws Exception
440
+	 */
441
+	public function sum($field): float
442
+	{
443
+		return $this->aggregate('sum', $field);
444
+	}
445
+
446
+	/**
447
+	 * Get the average for a field in the current query
448
+	 *
449
+	 * @see Taken from the pecee-pixie library - https://github.com/skipperbent/pecee-pixie/
450
+	 *
451
+	 * @param string|Raw $field
452
+	 *
453
+	 * @return float
454
+	 *
455
+	 * @throws Exception
456
+	 */
457
+	public function average($field): float
458
+	{
459
+		return $this->aggregate('avg', $field);
460
+	}
461
+
462
+	/**
463
+	 * Get the minimum for a field in the current query
464
+	 *
465
+	 * @see Taken from the pecee-pixie library - https://github.com/skipperbent/pecee-pixie/
466
+	 *
467
+	 * @param string|Raw $field
468
+	 *
469
+	 * @return float
470
+	 *
471
+	 * @throws Exception
472
+	 */
473
+	public function min($field): float
474
+	{
475
+		return $this->aggregate('min', $field);
476
+	}
477
+
478
+	/**
479
+	 * Get the maximum for a field in the current query
480
+	 *
481
+	 * @see Taken from the pecee-pixie library - https://github.com/skipperbent/pecee-pixie/
482
+	 *
483
+	 * @param string|Raw $field
484
+	 *
485
+	 * @return float
486
+	 *
487
+	 * @throws Exception
488
+	 */
489
+	public function max($field): float
490
+	{
491
+		return $this->aggregate('max', $field);
492
+	}
493
+
494
+	/**
495
+	 * @param string $type
496
+	 * @param bool|array<mixed, mixed> $dataToBePassed
497
+	 *
498
+	 * @return mixed
499
+	 *
500
+	 * @throws Exception
501
+	 */
502
+	public function getQuery(string $type = 'select', $dataToBePassed = [])
503
+	{
504
+		$allowedTypes = ['select', 'insert', 'insertignore', 'replace', 'delete', 'update', 'criteriaonly'];
505
+		if (!in_array(strtolower($type), $allowedTypes)) {
506
+			throw new Exception($type . ' is not a known type.', 2);
507
+		}
508
+
509
+		$queryArr = $this->adapterInstance->$type($this->statements, $dataToBePassed);
510
+
511
+		return $this->container->build(
512
+			QueryObject::class,
513
+			[$queryArr['sql'], $queryArr['bindings'], $this->dbInstance]
514
+		);
515
+	}
516
+
517
+	/**
518
+	 * @param QueryBuilderHandler $queryBuilder
519
+	 * @param string|null $alias
520
+	 *
521
+	 * @return Raw
522
+	 */
523
+	public function subQuery(QueryBuilderHandler $queryBuilder, ?string $alias = null)
524
+	{
525
+		$sql = '(' . $queryBuilder->getQuery()->getRawSql() . ')';
526
+		if (is_string($alias) && 0 !== mb_strlen($alias)) {
527
+			$sql = $sql . ' as ' . $alias;
528
+		}
529
+
530
+		return $queryBuilder->raw($sql);
531
+	}
532
+
533
+	/**
534
+	 * Handles the various insert operations based on the type.
535
+	 *
536
+	 * @param array<int|string, mixed|mixed[]> $data
537
+	 * @param string $type
538
+	 *
539
+	 * @return int|int[]|mixed|null can return a single row id, array of row ids, null (for failed) or any other value short circuited from event
540
+	 */
541
+	private function doInsert(array $data, string $type)
542
+	{
543
+		$eventResult = $this->fireEvents('before-insert');
544
+		if (!is_null($eventResult)) {
545
+			return $eventResult;
546
+		}
547
+
548
+		// If first value is not an array () not a batch insert)
549
+		if (!is_array(current($data))) {
550
+			$queryObject = $this->getQuery($type, $data);
551
+
552
+			list($preparedQuery, $executionTime) = $this->statement($queryObject->getSql(), $queryObject->getBindings());
553
+			$this->dbInstance->get_results($preparedQuery);
554
+
555
+			// Check we have a result.
556
+			$return = 1 === $this->dbInstance->rows_affected ? $this->dbInstance->insert_id : null;
557
+		} else {
558
+			// Its a batch insert
559
+			$return        = [];
560
+			$executionTime = 0;
561
+			foreach ($data as $subData) {
562
+				$queryObject = $this->getQuery($type, $subData);
563
+
564
+				list($preparedQuery, $time) = $this->statement($queryObject->getSql(), $queryObject->getBindings());
565
+				$this->dbInstance->get_results($preparedQuery);
566
+				$executionTime += $time;
567
+
568
+				if (1 === $this->dbInstance->rows_affected) {
569
+					$return[] = $this->dbInstance->insert_id;
570
+				}
571
+			}
572
+		}
573
+
574
+		$this->fireEvents('after-insert', $return, $executionTime);
575
+
576
+		return $return;
577
+	}
578
+
579
+	/**
580
+	 * @param array<int|string, mixed|mixed[]> $data either key=>value array for single or array of arrays for bulk
581
+	 *
582
+	 * @return int|int[]|mixed|null can return a single row id, array of row ids, null (for failed) or any other value short circuited from event
583
+	 */
584
+	public function insert($data)
585
+	{
586
+		return $this->doInsert($data, 'insert');
587
+	}
588
+
589
+	/**
590
+	 *
591
+	 * @param array<int|string, mixed|mixed[]> $data either key=>value array for single or array of arrays for bulk
592
+	 *
593
+	 * @return int|int[]|mixed|null can return a single row id, array of row ids, null (for failed) or any other value short circuited from event
594
+	 */
595
+	public function insertIgnore($data)
596
+	{
597
+		return $this->doInsert($data, 'insertignore');
598
+	}
599
+
600
+	/**
601
+	 *
602
+	 * @param array<int|string, mixed|mixed[]> $data either key=>value array for single or array of arrays for bulk
603
+	 *
604
+	 * @return int|int[]|mixed|null can return a single row id, array of row ids, null (for failed) or any other value short circuited from event
605
+	 */
606
+	public function replace($data)
607
+	{
608
+		return $this->doInsert($data, 'replace');
609
+	}
610
+
611
+	/**
612
+	 * @param array<string, mixed> $data
613
+	 *
614
+	 * @return int|null
615
+	 */
616
+	public function update($data)
617
+	{
618
+		$eventResult = $this->fireEvents('before-update');
619
+		if (!is_null($eventResult)) {
620
+			return $eventResult;
621
+		}
622
+		$queryObject                         = $this->getQuery('update', $data);
623
+		$r = $this->statement($queryObject->getSql(), $queryObject->getBindings());
624
+		list($preparedQuery, $executionTime) = $r;
625
+		$this->dbInstance()->get_results($preparedQuery);
626
+		$this->fireEvents('after-update', $queryObject, $executionTime);
627
+
628
+		return 0 !== $this->dbInstance()->rows_affected
629
+			? $this->dbInstance()->rows_affected
630
+			: null;
631
+	}
632
+
633
+	/**
634
+	 * @param array<string, mixed> $data
635
+	 *
636
+	 * @return int|null will return row id for insert and bool for success/fail on update
637
+	 */
638
+	public function updateOrInsert($data)
639
+	{
640
+		if ($this->first()) {
641
+			return $this->update($data);
642
+		}
643
+
644
+		return $this->insert($data);
645
+	}
646
+
647
+	/**
648
+	 * @param array<string, mixed> $data
649
+	 *
650
+	 * @return static
651
+	 */
652
+	public function onDuplicateKeyUpdate($data)
653
+	{
654
+		$this->addStatement('onduplicate', $data);
655
+
656
+		return $this;
657
+	}
658
+
659
+	/**
660
+	 * @return mixed number of rows effected or shortcircuited response
661
+	 */
662
+	public function delete()
663
+	{
664
+		$eventResult = $this->fireEvents('before-delete');
665
+		if (!is_null($eventResult)) {
666
+			return $eventResult;
667
+		}
668
+
669
+		$queryObject = $this->getQuery('delete');
670
+
671
+		list($preparedQuery, $executionTime) = $this->statement($queryObject->getSql(), $queryObject->getBindings());
672
+		$this->dbInstance()->get_results($preparedQuery);
673
+		$this->fireEvents('after-delete', $queryObject, $executionTime);
674
+
675
+		return $this->dbInstance()->rows_affected;
676
+	}
677
+
678
+	/**
679
+	 * @param string|Raw ...$tables Single table or array of tables
680
+	 *
681
+	 * @return static
682
+	 *
683
+	 * @throws Exception
684
+	 */
685
+	public function table(...$tables)
686
+	{
687
+		$instance =  $this->constructCurrentBuilderClass($this->connection);
688
+		$this->setFetchMode($this->getFetchMode(), $this->hydratorConstructorArgs);
689
+		$tables = $this->addTablePrefix($tables, false);
690
+		$instance->addStatement('tables', $tables);
691
+
692
+		return $instance;
693
+	}
694
+
695
+	/**
696
+	 * @param string|Raw ...$tables Single table or array of tables
697
+	 *
698
+	 * @return static
699
+	 */
700
+	public function from(...$tables): self
701
+	{
702
+		$tables = $this->addTablePrefix($tables, false);
703
+		$this->addStatement('tables', $tables);
704
+
705
+		return $this;
706
+	}
707
+
708
+	/**
709
+	 * @param string|string[]|Raw[]|array<string, string> $fields
710
+	 *
711
+	 * @return static
712
+	 */
713
+	public function select($fields): self
714
+	{
715
+		if (!is_array($fields)) {
716
+			$fields = func_get_args();
717
+		}
718
+
719
+		foreach ($fields as $field => $alias) {
720
+			// If we have a JSON expression
721
+			if ($this->jsonHandler->isJsonSelector($field)) {
722
+				$field = $this->jsonHandler->extractAndUnquoteFromJsonSelector($field);
723
+			}
724
+
725
+			// If no alias passed, but field is for JSON. thrown an exception.
726
+			if (is_numeric($field) && is_string($alias) && $this->jsonHandler->isJsonSelector($alias)) {
727
+				throw new Exception("An alias must be used if you wish to select from JSON Object", 1);
728
+			}
729
+
730
+			// Treat each array as a single table, to retain order added
731
+			$field = is_numeric($field)
732
+				? $field = $alias // If single colum
733
+				: $field = [$field => $alias]; // Has alias
734
+
735
+			$field = $this->addTablePrefix($field);
736
+			$this->addStatement('selects', $field);
737
+		}
738
+
739
+		return $this;
740
+	}
741
+
742
+	/**
743
+	 * @param string|string[]|Raw[]|array<string, string> $fields
744
+	 *
745
+	 * @return static
746
+	 */
747
+	public function selectDistinct($fields)
748
+	{
749
+		$this->select($fields);
750
+		$this->addStatement('distinct', true);
751
+
752
+		return $this;
753
+	}
754
+
755
+	/**
756
+	 * @param string|string[] $field either the single field or an array of fields
757
+	 *
758
+	 * @return static
759
+	 */
760
+	public function groupBy($field): self
761
+	{
762
+		$field = $this->addTablePrefix($field);
763
+		$this->addStatement('groupBys', $field);
764
+
765
+		return $this;
766
+	}
767
+
768
+	/**
769
+	 * @param string|array<string|int, mixed> $fields
770
+	 * @param string          $defaultDirection
771
+	 *
772
+	 * @return static
773
+	 */
774
+	public function orderBy($fields, string $defaultDirection = 'ASC'): self
775
+	{
776
+		if (!is_array($fields)) {
777
+			$fields = [$fields];
778
+		}
779
+
780
+		foreach ($fields as $key => $value) {
781
+			$field = $key;
782
+			$type  = $value;
783
+			if (is_int($key)) {
784
+				$field = $value;
785
+				$type  = $defaultDirection;
786
+			}
787
+
788
+			if ($this->jsonHandler->isJsonSelector($field)) {
789
+				$field = $this->jsonHandler->extractAndUnquoteFromJsonSelector($field);
790
+			}
791
+
792
+			if (!$field instanceof Raw) {
793
+				$field = $this->addTablePrefix($field);
794
+			}
795
+			$this->statements['orderBys'][] = compact('field', 'type');
796
+		}
797
+
798
+		return $this;
799
+	}
800
+
801
+	/**
802
+	 * @param string|Raw $key The database column which holds the JSON value
803
+	 * @param string|Raw|string[] $jsonKey The json key/index to search
804
+	 * @param string $defaultDirection
805
+	 * @return static
806
+	 */
807
+	public function orderByJson($key, $jsonKey, string $defaultDirection = 'ASC'): self
808
+	{
809
+		$key = $this->jsonHandler->jsonExpressionFactory()->extractAndUnquote($key, $jsonKey);
810
+		return $this->orderBy($key, $defaultDirection);
811
+	}
812
+
813
+	/**
814
+	 * @param int $limit
815
+	 *
816
+	 * @return static
817
+	 */
818
+	public function limit(int $limit): self
819
+	{
820
+		$this->statements['limit'] = $limit;
821
+
822
+		return $this;
823
+	}
824
+
825
+	/**
826
+	 * @param int $offset
827
+	 *
828
+	 * @return static
829
+	 */
830
+	public function offset(int $offset): self
831
+	{
832
+		$this->statements['offset'] = $offset;
833
+
834
+		return $this;
835
+	}
836
+
837
+	/**
838
+	 * @param string|string[]|Raw|Raw[]       $key
839
+	 * @param string $operator
840
+	 * @param mixed $value
841
+	 * @param string $joiner
842
+	 *
843
+	 * @return static
844
+	 */
845
+	public function having($key, string $operator, $value, string $joiner = 'AND')
846
+	{
847
+		$key                           = $this->addTablePrefix($key);
848
+		$this->statements['havings'][] = compact('key', 'operator', 'value', 'joiner');
849
+
850
+		return $this;
851
+	}
852
+
853
+	/**
854
+	 * @param string|string[]|Raw|Raw[]       $key
855
+	 * @param string $operator
856
+	 * @param mixed $value
857
+	 *
858
+	 * @return static
859
+	 */
860
+	public function orHaving($key, $operator, $value)
861
+	{
862
+		return $this->having($key, $operator, $value, 'OR');
863
+	}
864
+
865
+	/**
866
+	 * @param string|Raw $key
867
+	 * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
868
+	 * @param mixed|null $value
869
+	 *
870
+	 * @return static
871
+	 */
872
+	public function where($key, $operator = null, $value = null): self
873
+	{
874
+		// If two params are given then assume operator is =
875
+		if (2 === func_num_args()) {
876
+			$value    = $operator;
877
+			$operator = '=';
878
+		}
879
+
880
+		return $this->whereHandler($key, $operator, $value);
881
+	}
882
+
883
+	/**
884
+	 * @param string|Raw|\Closure(QueryBuilderHandler):void $key
885
+	 * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
886
+	 * @param mixed|null $value
887
+	 *
888
+	 * @return static
889
+	 */
890
+	public function orWhere($key, $operator = null, $value = null): self
891
+	{
892
+		// If two params are given then assume operator is =
893
+		if (2 === func_num_args()) {
894
+			$value    = $operator;
895
+			$operator = '=';
896
+		}
897
+
898
+		return $this->whereHandler($key, $operator, $value, 'OR');
899
+	}
900
+
901
+	/**
902
+	 * @param string|Raw $key
903
+	 * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
904
+	 * @param mixed|null $value
905
+	 *
906
+	 * @return static
907
+	 */
908
+	public function whereNot($key, $operator = null, $value = null): self
909
+	{
910
+		// If two params are given then assume operator is =
911
+		if (2 === func_num_args()) {
912
+			$value    = $operator;
913
+			$operator = '=';
914
+		}
915
+
916
+		return $this->whereHandler($key, $operator, $value, 'AND NOT');
917
+	}
918
+
919
+	/**
920
+	 * @param string|Raw $key
921
+	 * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
922
+	 * @param mixed|null $value
923
+	 *
924
+	 * @return static
925
+	 */
926
+	public function orWhereNot($key, $operator = null, $value = null)
927
+	{
928
+		// If two params are given then assume operator is =
929
+		if (2 === func_num_args()) {
930
+			$value    = $operator;
931
+			$operator = '=';
932
+		}
933
+
934
+		return $this->whereHandler($key, $operator, $value, 'OR NOT');
935
+	}
936
+
937
+	/**
938
+	 * @param string|Raw $key
939
+	 * @param mixed[]|string|Raw $values
940
+	 *
941
+	 * @return static
942
+	 */
943
+	public function whereIn($key, $values): self
944
+	{
945
+		return $this->whereHandler($key, 'IN', $values, 'AND');
946
+	}
947
+
948
+	/**
949
+	 * @param string|Raw $key
950
+	 * @param mixed[]|string|Raw $values
951
+	 *
952
+	 * @return static
953
+	 */
954
+	public function whereNotIn($key, $values): self
955
+	{
956
+		return $this->whereHandler($key, 'NOT IN', $values, 'AND');
957
+	}
958
+
959
+	/**
960
+	 * @param string|Raw $key
961
+	 * @param mixed[]|string|Raw $values
962
+	 *
963
+	 * @return static
964
+	 */
965
+	public function orWhereIn($key, $values): self
966
+	{
967
+		return $this->whereHandler($key, 'IN', $values, 'OR');
968
+	}
969
+
970
+	/**
971
+	 * @param string|Raw $key
972
+	 * @param mixed[]|string|Raw $values
973
+	 *
974
+	 * @return static
975
+	 */
976
+	public function orWhereNotIn($key, $values): self
977
+	{
978
+		return $this->whereHandler($key, 'NOT IN', $values, 'OR');
979
+	}
980
+
981
+	/**
982
+	 * @param string|Raw $key
983
+	 * @param mixed $valueFrom
984
+	 * @param mixed $valueTo
985
+	 *
986
+	 * @return static
987
+	 */
988
+	public function whereBetween($key, $valueFrom, $valueTo): self
989
+	{
990
+		return $this->whereHandler($key, 'BETWEEN', [$valueFrom, $valueTo], 'AND');
991
+	}
992
+
993
+	/**
994
+	 * @param string|Raw $key
995
+	 * @param mixed $valueFrom
996
+	 * @param mixed $valueTo
997
+	 *
998
+	 * @return static
999
+	 */
1000
+	public function orWhereBetween($key, $valueFrom, $valueTo): self
1001
+	{
1002
+		return $this->whereHandler($key, 'BETWEEN', [$valueFrom, $valueTo], 'OR');
1003
+	}
1004
+
1005
+	/**
1006
+	 * Handles all function call based where conditions
1007
+	 *
1008
+	 * @param string|Raw $key
1009
+	 * @param string $function
1010
+	 * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
1011
+	 * @param mixed|null $value
1012
+	 * @return static
1013
+	 */
1014
+	protected function whereFunctionCallHandler($key, $function, $operator, $value): self
1015
+	{
1016
+		$key = \sprintf('%s(%s)', $function, $this->addTablePrefix($key));
1017
+		return $this->where($key, $operator, $value);
1018
+	}
1019
+
1020
+	/**
1021
+	 * @param string|Raw $key
1022
+	 * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
1023
+	 * @param mixed|null $value
1024
+	 * @return self
1025
+	 */
1026
+	public function whereMonth($key, $operator = null, $value = null): self
1027
+	{
1028
+		// If two params are given then assume operator is =
1029
+		if (2 === func_num_args()) {
1030
+			$value    = $operator;
1031
+			$operator = '=';
1032
+		}
1033
+		return $this->whereFunctionCallHandler($key, 'MONTH', $operator, $value);
1034
+	}
1035
+
1036
+	/**
1037
+	 * @param string|Raw $key
1038
+	 * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
1039
+	 * @param mixed|null $value
1040
+	 * @return self
1041
+	 */
1042
+	public function whereDay($key, $operator = null, $value = null): self
1043
+	{
1044
+		// If two params are given then assume operator is =
1045
+		if (2 === func_num_args()) {
1046
+			$value    = $operator;
1047
+			$operator = '=';
1048
+		}
1049
+		return $this->whereFunctionCallHandler($key, 'DAY', $operator, $value);
1050
+	}
1051
+
1052
+	/**
1053
+	 * @param string|Raw $key
1054
+	 * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
1055
+	 * @param mixed|null $value
1056
+	 * @return self
1057
+	 */
1058
+	public function whereYear($key, $operator = null, $value = null): self
1059
+	{
1060
+		// If two params are given then assume operator is =
1061
+		if (2 === func_num_args()) {
1062
+			$value    = $operator;
1063
+			$operator = '=';
1064
+		}
1065
+		return $this->whereFunctionCallHandler($key, 'YEAR', $operator, $value);
1066
+	}
1067
+
1068
+	/**
1069
+	 * @param string|Raw $key
1070
+	 * @param string|mixed|null $operator Can be used as value, if 3rd arg not passed
1071
+	 * @param mixed|null $value
1072
+	 * @return self
1073
+	 */
1074
+	public function whereDate($key, $operator = null, $value = null): self
1075
+	{
1076
+		// If two params are given then assume operator is =
1077
+		if (2 === func_num_args()) {
1078
+			$value    = $operator;
1079
+			$operator = '=';
1080
+		}
1081
+		return $this->whereFunctionCallHandler($key, 'DATE', $operator, $value);
1082
+	}
1083
+
1084
+	/**
1085
+	 * @param string|Raw $key
1086
+	 *
1087
+	 * @return static
1088
+	 */
1089
+	public function whereNull($key): self
1090
+	{
1091
+		return $this->whereNullHandler($key);
1092
+	}
1093
+
1094
+	/**
1095
+	 * @param string|Raw $key
1096
+	 *
1097
+	 * @return static
1098
+	 */
1099
+	public function whereNotNull($key): self
1100
+	{
1101
+		return $this->whereNullHandler($key, 'NOT');
1102
+	}
1103
+
1104
+	/**
1105
+	 * @param string|Raw $key
1106
+	 *
1107
+	 * @return static
1108
+	 */
1109
+	public function orWhereNull($key): self
1110
+	{
1111
+		return $this->whereNullHandler($key, '', 'or');
1112
+	}
1113
+
1114
+	/**
1115
+	 * @param string|Raw $key
1116
+	 *
1117
+	 * @return static
1118
+	 */
1119
+	public function orWhereNotNull($key): self
1120
+	{
1121
+		return $this->whereNullHandler($key, 'NOT', 'or');
1122
+	}
1123
+
1124
+	/**
1125
+	 * @param string|Raw $key
1126
+	 * @param string $prefix
1127
+	 * @param string $operator
1128
+	 *
1129
+	 * @return static
1130
+	 */
1131
+	protected function whereNullHandler($key, string $prefix = '', $operator = ''): self
1132
+	{
1133
+		$prefix = 0 === mb_strlen($prefix) ? '' : " {$prefix}";
1134
+
1135
+		if ($key instanceof Raw) {
1136
+			$key = $this->adapterInstance->parseRaw($key);
1137
+		}
1138
+
1139
+		$key = $this->addTablePrefix($key);
1140
+		if ($key instanceof Closure) {
1141
+			throw new Exception('Key used for whereNull condition must be a string or raw exrpession.', 1);
1142
+		}
1143
+
1144
+		return $this->{$operator . 'Where'}($this->raw("{$key} IS{$prefix} NULL"));
1145
+	}
1146
+
1147
+
1148
+	/**
1149
+	 * Runs a transaction
1150
+	 *
1151
+	 * @param \Closure(Transaction):void $callback
1152
+	 *
1153
+	 * @return static
1154
+	 */
1155
+	public function transaction(Closure $callback): self
1156
+	{
1157
+		try {
1158
+			// Begin the transaction
1159
+			$this->dbInstance->query('START TRANSACTION');
1160
+
1161
+			// Get the Transaction class
1162
+			$transaction = $this->container->build(Transaction::class, [$this->connection]);
1163
+
1164
+			$this->handleTransactionCall($callback, $transaction);
1165
+
1166
+			// If no errors have been thrown or the transaction wasn't completed within
1167
+			$this->dbInstance->query('COMMIT');
1168
+
1169
+			return $this;
1170
+		} catch (TransactionHaltException $e) {
1171
+			// Commit or rollback behavior has been handled in the closure, so exit
1172
+			return $this;
1173
+		} catch (\Exception $e) {
1174
+			// something happened, rollback changes
1175
+			$this->dbInstance->query('ROLLBACK');
1176
+
1177
+			return $this;
1178
+		}
1179
+	}
1180
+
1181
+	/**
1182
+	 * Handles the transaction call.
1183
+	 * Catches any WPDB Errors (printed)
1184
+	 *
1185
+	 * @param Closure    $callback
1186
+	 * @param Transaction $transaction
1187
+	 *
1188
+	 * @return void
1189
+	 * @throws Exception
1190
+	 */
1191
+	protected function handleTransactionCall(Closure $callback, Transaction $transaction): void
1192
+	{
1193
+		try {
1194
+			ob_start();
1195
+			$callback($transaction);
1196
+			$output = ob_get_clean() ?: '';
1197
+		} catch (Throwable $th) {
1198
+			ob_end_clean();
1199
+			throw $th;
1200
+		}
1201
+
1202
+		// If we caught an error, throw an exception.
1203
+		if (0 !== mb_strlen($output)) {
1204
+			throw new Exception($output);
1205
+		}
1206
+	}
1207
+
1208
+	/*************************************************************************/
1209
+	/*************************************************************************/
1210
+	/*************************************************************************/
1211
+	/**                              JOIN JOIN                              **/
1212
+	/**                                 JOIN                                **/
1213
+	/**                              JOIN JOIN                              **/
1214
+	/*************************************************************************/
1215
+	/*************************************************************************/
1216
+	/*************************************************************************/
1217
+
1218
+	/**
1219
+	 * @param string|Raw $table
1220
+	 * @param string|Raw|Closure $key
1221
+	 * @param string|null $operator
1222
+	 * @param mixed $value
1223
+	 * @param string $type
1224
+	 *
1225
+	 * @return static
1226
+	 */
1227
+	public function join($table, $key, ?string $operator = null, $value = null, $type = 'inner')
1228
+	{
1229
+		// Potentially cast key from JSON
1230
+		if ($this->jsonHandler->isJsonSelector($key)) {
1231
+			/** @var string $key */
1232
+			$key = $this->jsonHandler->extractAndUnquoteFromJsonSelector($key); /** @phpstan-ignore-line */
1233
+		}
1234
+
1235
+		// Potentially cast value from json
1236
+		if ($this->jsonHandler->isJsonSelector($value)) {
1237
+			/** @var string $value */
1238
+			$value = $this->jsonHandler->extractAndUnquoteFromJsonSelector($value);
1239
+		}
1240
+
1241
+		if (!$key instanceof Closure) {
1242
+			$key = function ($joinBuilder) use ($key, $operator, $value) {
1243
+				$joinBuilder->on($key, $operator, $value);
1244
+			};
1245
+		}
1246
+
1247
+		// Build a new JoinBuilder class, keep it by reference so any changes made
1248
+		// in the closure should reflect here
1249
+		$joinBuilder = $this->container->build(JoinBuilder::class, [$this->connection]);
1250
+		$joinBuilder = &$joinBuilder;
1251
+		// Call the closure with our new joinBuilder object
1252
+		$key($joinBuilder);
1253
+		$table = $this->addTablePrefix($table, false);
1254
+		// Get the criteria only query from the joinBuilder object
1255
+		$this->statements['joins'][] = compact('type', 'table', 'joinBuilder');
1256
+		return $this;
1257
+	}
1258
+
1259
+	/**
1260
+	 * @param string|Raw $table
1261
+	 * @param string|Raw|Closure $key
1262
+	 * @param string|null $operator
1263
+	 * @param mixed $value
1264
+	 *
1265
+	 * @return static
1266
+	 */
1267
+	public function leftJoin($table, $key, $operator = null, $value = null)
1268
+	{
1269
+		return $this->join($table, $key, $operator, $value, 'left');
1270
+	}
1271
+
1272
+	/**
1273
+	 * @param string|Raw $table
1274
+	 * @param string|Raw|Closure $key
1275
+	 * @param string|null $operator
1276
+	 * @param mixed $value
1277
+	 *
1278
+	 * @return static
1279
+	 */
1280
+	public function rightJoin($table, $key, $operator = null, $value = null)
1281
+	{
1282
+		return $this->join($table, $key, $operator, $value, 'right');
1283
+	}
1284
+
1285
+	/**
1286
+	 * @param string|Raw $table
1287
+	 * @param string|Raw|Closure $key
1288
+	 * @param string|null $operator
1289
+	 * @param mixed $value
1290
+	 *
1291
+	 * @return static
1292
+	 */
1293
+	public function innerJoin($table, $key, $operator = null, $value = null)
1294
+	{
1295
+		return $this->join($table, $key, $operator, $value, 'inner');
1296
+	}
1297
+
1298
+	/**
1299
+	 * @param string|Raw $table
1300
+	 * @param string|Raw|Closure $key
1301
+	 * @param string|null $operator
1302
+	 * @param mixed $value
1303
+	 *
1304
+	 * @return static
1305
+	 */
1306
+	public function crossJoin($table, $key, $operator = null, $value = null)
1307
+	{
1308
+		return $this->join($table, $key, $operator, $value, 'cross');
1309
+	}
1310
+
1311
+	/**
1312
+	 * @param string|Raw $table
1313
+	 * @param string|Raw|Closure $key
1314
+	 * @param string|null $operator
1315
+	 * @param mixed $value
1316
+	 *
1317
+	 * @return static
1318
+	 */
1319
+	public function outerJoin($table, $key, $operator = null, $value = null)
1320
+	{
1321
+		return $this->join($table, $key, $operator, $value, 'full outer');
1322
+	}
1323
+
1324
+	/**
1325
+	 * Shortcut to join 2 tables on the same key name with equals
1326
+	 *
1327
+	 * @param string $table
1328
+	 * @param string $key
1329
+	 * @param string $type
1330
+	 * @return self
1331
+	 * @throws Exception If base table is set as more than 1 or 0
1332
+	 */
1333
+	public function joinUsing(string $table, string $key, string $type = 'INNER'): self
1334
+	{
1335
+		if (!array_key_exists('tables', $this->statements) || count($this->statements['tables']) !== 1) {
1336
+			throw new Exception("JoinUsing can only be used with a single table set as the base of the query", 1);
1337
+		}
1338
+		$baseTable = end($this->statements['tables']);
1339
+
1340
+		// Potentialy cast key from JSON
1341
+		if ($this->jsonHandler->isJsonSelector($key)) {
1342
+			$key = $this->jsonHandler->extractAndUnquoteFromJsonSelector($key);
1343
+		}
1344
+
1345
+		$remoteKey = $table = $this->addTablePrefix("{$table}.{$key}", true);
1346
+		$localKey = $table = $this->addTablePrefix("{$baseTable}.{$key}", true);
1347
+		return $this->join($table, $remoteKey, '=', $localKey, $type);
1348
+	}
1349
+
1350
+	/**
1351
+	 * Add a raw query
1352
+	 *
1353
+	 * @param string|Raw $value
1354
+	 * @param mixed|mixed[] $bindings
1355
+	 *
1356
+	 * @return Raw
1357
+	 */
1358
+	public function raw($value, $bindings = []): Raw
1359
+	{
1360
+		return new Raw($value, $bindings);
1361
+	}
1362
+
1363
+	/**
1364
+	 * Return wpdb instance
1365
+	 *
1366
+	 * @return wpdb
1367
+	 */
1368
+	public function dbInstance(): wpdb
1369
+	{
1370
+		return $this->dbInstance;
1371
+	}
1372
+
1373
+	/**
1374
+	 * @param Connection $connection
1375
+	 *
1376
+	 * @return static
1377
+	 */
1378
+	public function setConnection(Connection $connection): self
1379
+	{
1380
+		$this->connection = $connection;
1381
+
1382
+		return $this;
1383
+	}
1384
+
1385
+	/**
1386
+	 * @return Connection
1387
+	 */
1388
+	public function getConnection(): Connection
1389
+	{
1390
+		return $this->connection;
1391
+	}
1392
+
1393
+	/**
1394
+	 * @param string|Raw|Closure $key
1395
+	 * @param string|null      $operator
1396
+	 * @param mixed|null       $value
1397
+	 * @param string $joiner
1398
+	 *
1399
+	 * @return static
1400
+	 */
1401
+	protected function whereHandler($key, $operator = null, $value = null, $joiner = 'AND')
1402
+	{
1403
+		$key = $this->addTablePrefix($key);
1404
+		if ($key instanceof Raw) {
1405
+			$key = $this->adapterInstance->parseRaw($key);
1406
+		}
1407
+
1408
+		if ($this->jsonHandler->isJsonSelector($key)) {
1409
+			$key = $this->jsonHandler->extractAndUnquoteFromJsonSelector($key);
1410
+		}
1411
+
1412
+		$this->statements['wheres'][] = compact('key', 'operator', 'value', 'joiner');
1413
+		return $this;
1414
+	}
1415
+
1416
+
1417
+
1418
+	/**
1419
+	 * @param string $key
1420
+	 * @param mixed|mixed[]|bool $value
1421
+	 *
1422
+	 * @return void
1423
+	 */
1424
+	protected function addStatement($key, $value)
1425
+	{
1426
+		if (!is_array($value)) {
1427
+			$value = [$value];
1428
+		}
1429
+
1430
+		if (!array_key_exists($key, $this->statements)) {
1431
+			$this->statements[$key] = $value;
1432
+		} else {
1433
+			$this->statements[$key] = array_merge($this->statements[$key], $value);
1434
+		}
1435
+	}
1436
+
1437
+	/**
1438
+	 * @param string $event
1439
+	 * @param string|Raw $table
1440
+	 *
1441
+	 * @return callable|null
1442
+	 */
1443
+	public function getEvent(string $event, $table = ':any'): ?callable
1444
+	{
1445
+		return $this->connection->getEventHandler()->getEvent($event, $table);
1446
+	}
1447
+
1448
+	/**
1449
+	 * @param string $event
1450
+	 * @param string|Raw $table
1451
+	 * @param Closure $action
1452
+	 *
1453
+	 * @return void
1454
+	 */
1455
+	public function registerEvent($event, $table, Closure $action): void
1456
+	{
1457
+		$table = $table ?: ':any';
1458
+
1459
+		if (':any' != $table) {
1460
+			$table = $this->addTablePrefix($table, false);
1461
+		}
1462
+
1463
+		$this->connection->getEventHandler()->registerEvent($event, $table, $action);
1464
+	}
1465
+
1466
+	/**
1467
+	 * @param string $event
1468
+	 * @param string|Raw $table
1469
+	 *
1470
+	 * @return void
1471
+	 */
1472
+	public function removeEvent(string $event, $table = ':any')
1473
+	{
1474
+		if (':any' != $table) {
1475
+			$table = $this->addTablePrefix($table, false);
1476
+		}
1477
+
1478
+		$this->connection->getEventHandler()->removeEvent($event, $table);
1479
+	}
1480
+
1481
+	/**
1482
+	 * @param string $event
1483
+	 *
1484
+	 * @return mixed
1485
+	 */
1486
+	public function fireEvents(string $event)
1487
+	{
1488
+		$params = func_get_args(); // @todo Replace this with an easier to read alteratnive
1489
+		array_unshift($params, $this);
1490
+
1491
+		return call_user_func_array([$this->connection->getEventHandler(), 'fireEvents'], $params);
1492
+	}
1493
+
1494
+	/**
1495
+	 * @return array<string, mixed[]>
1496
+	 */
1497
+	public function getStatements()
1498
+	{
1499
+		return $this->statements;
1500
+	}
1501
+
1502
+	/**
1503
+	 * @return string will return WPDB Fetch mode
1504
+	 */
1505
+	public function getFetchMode()
1506
+	{
1507
+		return null !== $this->fetchMode
1508
+			? $this->fetchMode
1509
+			: \OBJECT;
1510
+	}
1511
+
1512
+	/**
1513
+	 * Returns an NEW instance of the JSON builder populated with the same connection and hydrator details.
1514
+	 *
1515
+	 * @return JsonQueryBuilder
1516
+	 */
1517
+	public function jsonBuilder(): JsonQueryBuilder
1518
+	{
1519
+		return new JsonQueryBuilder($this->getConnection(), $this->getFetchMode(), $this->hydratorConstructorArgs);
1520
+	}
1521 1521
 }
Please login to merge, or discard this patch.
Spacing   +24 added lines, -24 removed lines patch added patch discarded remove patch
@@ -232,7 +232,7 @@  discard block
 block discarded – undo
232 232
         $start        = microtime(true);
233 233
         $sqlStatement = empty($bindings) ? $sql : $this->interpolateQuery($sql, $bindings);
234 234
 
235
-        if (!is_string($sqlStatement)) {
235
+        if ( ! is_string($sqlStatement)) {
236 236
             throw new Exception('Could not interpolate query', 1);
237 237
         }
238 238
 
@@ -249,7 +249,7 @@  discard block
 block discarded – undo
249 249
     public function get()
250 250
     {
251 251
         $eventResult = $this->fireEvents('before-select');
252
-        if (!is_null($eventResult)) {
252
+        if ( ! is_null($eventResult)) {
253 253
             return $eventResult;
254 254
         }
255 255
         $executionTime = 0;
@@ -274,7 +274,7 @@  discard block
 block discarded – undo
274 274
         $this->sqlStatement = null;
275 275
 
276 276
         // Ensure we have an array of results.
277
-        if (!is_array($result) && null !== $result) {
277
+        if ( ! is_array($result) && null !== $result) {
278 278
             $result = [$result];
279 279
         }
280 280
 
@@ -307,7 +307,7 @@  discard block
 block discarded – undo
307 307
      */
308 308
     protected function useHydrator(): bool
309 309
     {
310
-        return !in_array($this->getFetchMode(), [\ARRAY_A, \ARRAY_N, \OBJECT, \OBJECT_K]);
310
+        return ! in_array($this->getFetchMode(), [\ARRAY_A, \ARRAY_N, \OBJECT, \OBJECT_K]);
311 311
     }
312 312
 
313 313
     /**
@@ -408,7 +408,7 @@  discard block
 block discarded – undo
408 408
             ->select([$this->raw(sprintf('%s(%s) AS field', strtoupper($type), $field))])
409 409
             ->first();
410 410
 
411
-        return true === isset($count->field) ? (float)$count->field : 0;
411
+        return true === isset($count->field) ? (float) $count->field : 0;
412 412
     }
413 413
 
414 414
     /**
@@ -424,7 +424,7 @@  discard block
 block discarded – undo
424 424
      */
425 425
     public function count($field = '*'): int
426 426
     {
427
-        return (int)$this->aggregate('count', $field);
427
+        return (int) $this->aggregate('count', $field);
428 428
     }
429 429
 
430 430
     /**
@@ -502,8 +502,8 @@  discard block
 block discarded – undo
502 502
     public function getQuery(string $type = 'select', $dataToBePassed = [])
503 503
     {
504 504
         $allowedTypes = ['select', 'insert', 'insertignore', 'replace', 'delete', 'update', 'criteriaonly'];
505
-        if (!in_array(strtolower($type), $allowedTypes)) {
506
-            throw new Exception($type . ' is not a known type.', 2);
505
+        if ( ! in_array(strtolower($type), $allowedTypes)) {
506
+            throw new Exception($type.' is not a known type.', 2);
507 507
         }
508 508
 
509 509
         $queryArr = $this->adapterInstance->$type($this->statements, $dataToBePassed);
@@ -522,9 +522,9 @@  discard block
 block discarded – undo
522 522
      */
523 523
     public function subQuery(QueryBuilderHandler $queryBuilder, ?string $alias = null)
524 524
     {
525
-        $sql = '(' . $queryBuilder->getQuery()->getRawSql() . ')';
525
+        $sql = '('.$queryBuilder->getQuery()->getRawSql().')';
526 526
         if (is_string($alias) && 0 !== mb_strlen($alias)) {
527
-            $sql = $sql . ' as ' . $alias;
527
+            $sql = $sql.' as '.$alias;
528 528
         }
529 529
 
530 530
         return $queryBuilder->raw($sql);
@@ -541,12 +541,12 @@  discard block
 block discarded – undo
541 541
     private function doInsert(array $data, string $type)
542 542
     {
543 543
         $eventResult = $this->fireEvents('before-insert');
544
-        if (!is_null($eventResult)) {
544
+        if ( ! is_null($eventResult)) {
545 545
             return $eventResult;
546 546
         }
547 547
 
548 548
         // If first value is not an array () not a batch insert)
549
-        if (!is_array(current($data))) {
549
+        if ( ! is_array(current($data))) {
550 550
             $queryObject = $this->getQuery($type, $data);
551 551
 
552 552
             list($preparedQuery, $executionTime) = $this->statement($queryObject->getSql(), $queryObject->getBindings());
@@ -616,7 +616,7 @@  discard block
 block discarded – undo
616 616
     public function update($data)
617 617
     {
618 618
         $eventResult = $this->fireEvents('before-update');
619
-        if (!is_null($eventResult)) {
619
+        if ( ! is_null($eventResult)) {
620 620
             return $eventResult;
621 621
         }
622 622
         $queryObject                         = $this->getQuery('update', $data);
@@ -662,7 +662,7 @@  discard block
 block discarded – undo
662 662
     public function delete()
663 663
     {
664 664
         $eventResult = $this->fireEvents('before-delete');
665
-        if (!is_null($eventResult)) {
665
+        if ( ! is_null($eventResult)) {
666 666
             return $eventResult;
667 667
         }
668 668
 
@@ -684,7 +684,7 @@  discard block
 block discarded – undo
684 684
      */
685 685
     public function table(...$tables)
686 686
     {
687
-        $instance =  $this->constructCurrentBuilderClass($this->connection);
687
+        $instance = $this->constructCurrentBuilderClass($this->connection);
688 688
         $this->setFetchMode($this->getFetchMode(), $this->hydratorConstructorArgs);
689 689
         $tables = $this->addTablePrefix($tables, false);
690 690
         $instance->addStatement('tables', $tables);
@@ -712,7 +712,7 @@  discard block
 block discarded – undo
712 712
      */
713 713
     public function select($fields): self
714 714
     {
715
-        if (!is_array($fields)) {
715
+        if ( ! is_array($fields)) {
716 716
             $fields = func_get_args();
717 717
         }
718 718
 
@@ -773,7 +773,7 @@  discard block
 block discarded – undo
773 773
      */
774 774
     public function orderBy($fields, string $defaultDirection = 'ASC'): self
775 775
     {
776
-        if (!is_array($fields)) {
776
+        if ( ! is_array($fields)) {
777 777
             $fields = [$fields];
778 778
         }
779 779
 
@@ -789,7 +789,7 @@  discard block
 block discarded – undo
789 789
                 $field = $this->jsonHandler->extractAndUnquoteFromJsonSelector($field);
790 790
             }
791 791
 
792
-            if (!$field instanceof Raw) {
792
+            if ( ! $field instanceof Raw) {
793 793
                 $field = $this->addTablePrefix($field);
794 794
             }
795 795
             $this->statements['orderBys'][] = compact('field', 'type');
@@ -1141,7 +1141,7 @@  discard block
 block discarded – undo
1141 1141
             throw new Exception('Key used for whereNull condition must be a string or raw exrpession.', 1);
1142 1142
         }
1143 1143
 
1144
-        return $this->{$operator . 'Where'}($this->raw("{$key} IS{$prefix} NULL"));
1144
+        return $this->{$operator.'Where'}($this->raw("{$key} IS{$prefix} NULL"));
1145 1145
     }
1146 1146
 
1147 1147
 
@@ -1238,8 +1238,8 @@  discard block
 block discarded – undo
1238 1238
             $value = $this->jsonHandler->extractAndUnquoteFromJsonSelector($value);
1239 1239
         }
1240 1240
 
1241
-        if (!$key instanceof Closure) {
1242
-            $key = function ($joinBuilder) use ($key, $operator, $value) {
1241
+        if ( ! $key instanceof Closure) {
1242
+            $key = function($joinBuilder) use ($key, $operator, $value) {
1243 1243
                 $joinBuilder->on($key, $operator, $value);
1244 1244
             };
1245 1245
         }
@@ -1332,7 +1332,7 @@  discard block
 block discarded – undo
1332 1332
      */
1333 1333
     public function joinUsing(string $table, string $key, string $type = 'INNER'): self
1334 1334
     {
1335
-        if (!array_key_exists('tables', $this->statements) || count($this->statements['tables']) !== 1) {
1335
+        if ( ! array_key_exists('tables', $this->statements) || count($this->statements['tables']) !== 1) {
1336 1336
             throw new Exception("JoinUsing can only be used with a single table set as the base of the query", 1);
1337 1337
         }
1338 1338
         $baseTable = end($this->statements['tables']);
@@ -1423,11 +1423,11 @@  discard block
 block discarded – undo
1423 1423
      */
1424 1424
     protected function addStatement($key, $value)
1425 1425
     {
1426
-        if (!is_array($value)) {
1426
+        if ( ! is_array($value)) {
1427 1427
             $value = [$value];
1428 1428
         }
1429 1429
 
1430
-        if (!array_key_exists($key, $this->statements)) {
1430
+        if ( ! array_key_exists($key, $this->statements)) {
1431 1431
             $this->statements[$key] = $value;
1432 1432
         } else {
1433 1433
             $this->statements[$key] = array_merge($this->statements[$key], $value);
Please login to merge, or discard this patch.
src/JSON/JsonSelectorHandler.php 2 patches
Indentation   +70 added lines, -70 removed lines patch added patch discarded remove patch
@@ -9,84 +9,84 @@
 block discarded – undo
9 9
 
10 10
 class JsonSelectorHandler implements HasConnection
11 11
 {
12
-    use TablePrefixer;
12
+	use TablePrefixer;
13 13
 
14
-    /** @var Connection */
15
-    protected $connection;
14
+	/** @var Connection */
15
+	protected $connection;
16 16
 
17
-    public function __construct(Connection $connection)
18
-    {
19
-        $this->connection = $connection;
20
-    }
17
+	public function __construct(Connection $connection)
18
+	{
19
+		$this->connection = $connection;
20
+	}
21 21
 
22
-    /**
23
-     * Returns the current connection instance.
24
-     *
25
-     * @return connection
26
-     */
27
-    public function getConnection(): Connection
28
-    {
29
-        return $this->connection;
30
-    }
22
+	/**
23
+	 * Returns the current connection instance.
24
+	 *
25
+	 * @return connection
26
+	 */
27
+	public function getConnection(): Connection
28
+	{
29
+		return $this->connection;
30
+	}
31 31
 
32
-    /**
33
-     * Checks if the passed expression is for JSON
34
-     * this->denotes->json
35
-     *
36
-     * @param string $expression
37
-     * @return bool
38
-     */
39
-    public function isJsonSelector($expression): bool
40
-    {
41
-        return is_string($expression)
42
-        && 2 <= count(array_diff(explode('->', $expression), array("")));
43
-    }
32
+	/**
33
+	 * Checks if the passed expression is for JSON
34
+	 * this->denotes->json
35
+	 *
36
+	 * @param string $expression
37
+	 * @return bool
38
+	 */
39
+	public function isJsonSelector($expression): bool
40
+	{
41
+		return is_string($expression)
42
+		&& 2 <= count(array_diff(explode('->', $expression), array("")));
43
+	}
44 44
 
45
-    /**
46
-    * Gets the column name form a potential array
47
-    *
48
-    * @param string $expression
49
-    * @return string
50
-    * @throws Exception If invalid JSON Selector string passed.
51
-    */
52
-    public function getColumn(string $expression): string
53
-    {
54
-        return $this->toJsonSelector($expression)->getColumn();
55
-    }
45
+	/**
46
+	 * Gets the column name form a potential array
47
+	 *
48
+	 * @param string $expression
49
+	 * @return string
50
+	 * @throws Exception If invalid JSON Selector string passed.
51
+	 */
52
+	public function getColumn(string $expression): string
53
+	{
54
+		return $this->toJsonSelector($expression)->getColumn();
55
+	}
56 56
 
57
-    /**
58
-     * Gets all JSON object keys while removing the column name.
59
-     *
60
-     * @param string $expression
61
-     * @return string[]
62
-     * @throws Exception If invalid JSON Selector string passed.
63
-     */
64
-    public function getNodes(string $expression): array
65
-    {
66
-        return $this->toJsonSelector($expression)->getNodes();
67
-    }
57
+	/**
58
+	 * Gets all JSON object keys while removing the column name.
59
+	 *
60
+	 * @param string $expression
61
+	 * @return string[]
62
+	 * @throws Exception If invalid JSON Selector string passed.
63
+	 */
64
+	public function getNodes(string $expression): array
65
+	{
66
+		return $this->toJsonSelector($expression)->getNodes();
67
+	}
68 68
 
69
-    /**
70
-     * Casts a valid JSON selector to a JsonSelector object.
71
-     *
72
-     * @param string $expression
73
-     * @return JsonSelector
74
-     * @throws Exception If invalid JSON Selector string passed.
75
-     */
76
-    public function toJsonSelector(string $expression): JsonSelector
77
-    {
78
-        if (! $this->isJsonSelector($expression)) {
79
-            throw new Exception('JSON expression must contain at least 2 values, the table column and at least 1 node.', 1);
80
-        }
69
+	/**
70
+	 * Casts a valid JSON selector to a JsonSelector object.
71
+	 *
72
+	 * @param string $expression
73
+	 * @return JsonSelector
74
+	 * @throws Exception If invalid JSON Selector string passed.
75
+	 */
76
+	public function toJsonSelector(string $expression): JsonSelector
77
+	{
78
+		if (! $this->isJsonSelector($expression)) {
79
+			throw new Exception('JSON expression must contain at least 2 values, the table column and at least 1 node.', 1);
80
+		}
81 81
 
82
-        /** @var string[] Check done above. */
83
-        $parts = array_diff(explode('->', $expression), array(""));
82
+		/** @var string[] Check done above. */
83
+		$parts = array_diff(explode('->', $expression), array(""));
84 84
 
85
-        /** @var string */
86
-        $column = array_shift($parts);
87
-        /** @var string[] */
88
-        $nodes = $parts;
85
+		/** @var string */
86
+		$column = array_shift($parts);
87
+		/** @var string[] */
88
+		$nodes = $parts;
89 89
 
90
-        return new JsonSelector($column, $nodes);
91
-    }
90
+		return new JsonSelector($column, $nodes);
91
+	}
92 92
 }
Please login to merge, or discard this patch.
Spacing   +1 added lines, -1 removed lines patch added patch discarded remove patch
@@ -75,7 +75,7 @@
 block discarded – undo
75 75
      */
76 76
     public function toJsonSelector(string $expression): JsonSelector
77 77
     {
78
-        if (! $this->isJsonSelector($expression)) {
78
+        if ( ! $this->isJsonSelector($expression)) {
79 79
             throw new Exception('JSON expression must contain at least 2 values, the table column and at least 1 node.', 1);
80 80
         }
81 81
 
Please login to merge, or discard this patch.
src/JSON/JsonExpressionFactory.php 2 patches
Indentation   +51 added lines, -51 removed lines patch added patch discarded remove patch
@@ -9,65 +9,65 @@
 block discarded – undo
9 9
 
10 10
 class JsonExpressionFactory
11 11
 {
12
-    use TablePrefixer;
12
+	use TablePrefixer;
13 13
 
14
-    /** @var Connection */
15
-    protected $connection;
14
+	/** @var Connection */
15
+	protected $connection;
16 16
 
17
-    public function __construct(Connection $connection)
18
-    {
19
-        $this->connection = $connection;
20
-    }
17
+	public function __construct(Connection $connection)
18
+	{
19
+		$this->connection = $connection;
20
+	}
21 21
 
22
-    /**
23
-     * Returns the current connection instance.
24
-     *
25
-     * @return connection
26
-     */
27
-    public function getConnection(): Connection
28
-    {
29
-        return $this->connection;
30
-    }
22
+	/**
23
+	 * Returns the current connection instance.
24
+	 *
25
+	 * @return connection
26
+	 */
27
+	public function getConnection(): Connection
28
+	{
29
+		return $this->connection;
30
+	}
31 31
 
32
-    /**
33
-     * Normalises the values passed as nodes
34
-     *
35
-     * @param mixed $nodes
36
-     * @return string
37
-     */
38
-    protected function normaliseNodes($nodes): string
39
-    {
40
-        // If its not an array, cast.
41
-        if (!is_array($nodes)) {
42
-            $nodes = [$nodes];
43
-        }
32
+	/**
33
+	 * Normalises the values passed as nodes
34
+	 *
35
+	 * @param mixed $nodes
36
+	 * @return string
37
+	 */
38
+	protected function normaliseNodes($nodes): string
39
+	{
40
+		// If its not an array, cast.
41
+		if (!is_array($nodes)) {
42
+			$nodes = [$nodes];
43
+		}
44 44
 
45
-        // Remove all none string.
46
-        $nodes = array_filter($nodes, function ($node): bool {
47
-            return is_string($node);
48
-        });
45
+		// Remove all none string.
46
+		$nodes = array_filter($nodes, function ($node): bool {
47
+			return is_string($node);
48
+		});
49 49
 
50
-        // If we have no nodes, throw.
51
-        if (count($nodes) === 0) {
52
-            throw new Exception("Only strings values may be passed as nodes.");
53
-        }
50
+		// If we have no nodes, throw.
51
+		if (count($nodes) === 0) {
52
+			throw new Exception("Only strings values may be passed as nodes.");
53
+		}
54 54
 
55
-        return \implode('.', $nodes);
56
-    }
55
+		return \implode('.', $nodes);
56
+	}
57 57
 
58
-    /**
59
-     * @param string          $column  The database column which holds the JSON value
60
-     * @param string|string[] $nodes   The json key/index to search
61
-     * @return \Pixie\QueryBuilder\Raw
62
-     */
63
-    public function extractAndUnquote(string $column, $nodes): Raw
64
-    {
65
-        // Normalise nodes.
66
-        $nodes = $this->normaliseNodes($nodes);
58
+	/**
59
+	 * @param string          $column  The database column which holds the JSON value
60
+	 * @param string|string[] $nodes   The json key/index to search
61
+	 * @return \Pixie\QueryBuilder\Raw
62
+	 */
63
+	public function extractAndUnquote(string $column, $nodes): Raw
64
+	{
65
+		// Normalise nodes.
66
+		$nodes = $this->normaliseNodes($nodes);
67 67
 
68
-        // Add any possible prefixes to the key
69
-        $column = $this->addTablePrefix($column, true);
68
+		// Add any possible prefixes to the key
69
+		$column = $this->addTablePrefix($column, true);
70 70
 
71
-        return new Raw("JSON_UNQUOTE(JSON_EXTRACT({$column}, \"$.{$nodes}\"))");
72
-    }
71
+		return new Raw("JSON_UNQUOTE(JSON_EXTRACT({$column}, \"$.{$nodes}\"))");
72
+	}
73 73
 }
Please login to merge, or discard this patch.
Spacing   +2 added lines, -2 removed lines patch added patch discarded remove patch
@@ -38,12 +38,12 @@
 block discarded – undo
38 38
     protected function normaliseNodes($nodes): string
39 39
     {
40 40
         // If its not an array, cast.
41
-        if (!is_array($nodes)) {
41
+        if ( ! is_array($nodes)) {
42 42
             $nodes = [$nodes];
43 43
         }
44 44
 
45 45
         // Remove all none string.
46
-        $nodes = array_filter($nodes, function ($node): bool {
46
+        $nodes = array_filter($nodes, function($node): bool {
47 47
             return is_string($node);
48 48
         });
49 49
 
Please login to merge, or discard this patch.