Completed
Push — master ( 18b9a5...070941 )
by Simonas
02:16
created

Manager::getRepository()   B

Complexity

Conditions 5
Paths 7

Size

Total Lines 27
Code Lines 14

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
c 0
b 0
f 0
dl 0
loc 27
rs 8.439
cc 5
eloc 14
nc 7
nop 1
1
<?php
2
3
/*
4
 * This file is part of the ONGR package.
5
 *
6
 * (c) NFQ Technologies UAB <[email protected]>
7
 *
8
 * For the full copyright and license information, please view the LICENSE
9
 * file that was distributed with this source code.
10
 */
11
12
namespace ONGR\ElasticsearchBundle\Service;
13
14
use Elasticsearch\Client;
15
use Elasticsearch\Common\Exceptions\Missing404Exception;
16
use ONGR\ElasticsearchBundle\Event\Events;
17
use ONGR\ElasticsearchBundle\Event\BulkEvent;
18
use ONGR\ElasticsearchBundle\Event\CommitEvent;
19
use ONGR\ElasticsearchBundle\Exception\BulkWithErrorsException;
20
use ONGR\ElasticsearchBundle\Mapping\MetadataCollector;
21
use ONGR\ElasticsearchBundle\Result\Converter;
22
use Symfony\Component\EventDispatcher\EventDispatcherInterface;
23
use Symfony\Component\Stopwatch\Stopwatch;
24
25
/**
26
 * Manager class.
27
 */
28
class Manager
29
{
30
    /**
31
     * @var string Manager name
32
     */
33
    private $name;
34
35
    /**
36
     * @var array Manager configuration
37
     */
38
    private $config = [];
39
40
    /**
41
     * @var Client
42
     */
43
    private $client;
44
45
    /**
46
     * @var Converter
47
     */
48
    private $converter;
49
50
    /**
51
     * @var array Container for bulk queries
52
     */
53
    private $bulkQueries = [];
54
55
    /**
56
     * @var array Holder for consistency, refresh and replication parameters
57
     */
58
    private $bulkParams = [];
59
60
    /**
61
     * @var array
62
     */
63
    private $indexSettings;
64
65
    /**
66
     * @var MetadataCollector
67
     */
68
    private $metadataCollector;
69
70
    /**
71
     * After commit to make data available the refresh or flush operation is needed
72
     * so one of those methods has to be defined, the default is refresh.
73
     *
74
     * @var string
75
     */
76
    private $commitMode = 'refresh';
77
78
    /**
79
     * The size that defines after how much document inserts call commit function.
80
     *
81
     * @var int
82
     */
83
    private $bulkCommitSize = 100;
84
85
    /**
86
     * Container to count how many documents was passed to the bulk query.
87
     *
88
     * @var int
89
     */
90
    private $bulkCount = 0;
91
92
    /**
93
     * @var Repository[] Repository local cache
94
     */
95
    private $repositories;
96
97
    /**
98
     * @var EventDispatcherInterface
99
     */
100
    private $eventDispatcher;
101
102
    /**
103
     * @var Stopwatch
104
     */
105
    private $stopwatch;
106
107
    /**
108
     * @param string            $name              Manager name
109
     * @param array             $config            Manager configuration
110
     * @param Client            $client
111
     * @param array             $indexSettings
112
     * @param MetadataCollector $metadataCollector
113
     * @param Converter         $converter
114
     */
115
    public function __construct(
116
        $name,
117
        array $config,
118
        $client,
119
        array $indexSettings,
120
        $metadataCollector,
121
        $converter
122
    ) {
123
        $this->name = $name;
124
        $this->config = $config;
125
        $this->client = $client;
126
        $this->indexSettings = $indexSettings;
127
        $this->metadataCollector = $metadataCollector;
128
        $this->converter = $converter;
129
    }
130
131
    /**
132
     * Returns Elasticsearch connection.
133
     *
134
     * @return Client
135
     */
136
    public function getClient()
137
    {
138
        return $this->client;
139
    }
140
141
    /**
142
     * @return string
143
     */
144
    public function getName()
145
    {
146
        return $this->name;
147
    }
148
149
    /**
150
     * @return array
151
     */
152
    public function getConfig()
153
    {
154
        return $this->config;
155
    }
156
157
    /**
158
     * @param EventDispatcherInterface $eventDispatcher
159
     */
160
    public function setEventDispatcher(EventDispatcherInterface $eventDispatcher)
161
    {
162
        $this->eventDispatcher = $eventDispatcher;
163
    }
164
165
    /**
166
     * @param Stopwatch $stopwatch
167
     */
168
    public function setStopwatch(Stopwatch $stopwatch)
169
    {
170
        $this->stopwatch = $stopwatch;
171
    }
172
173
    /**
174
     * Returns repository by document class.
175
     *
176
     * @param string $className FQCN or string in Bundle:Document format
177
     *
178
     * @return Repository
179
     */
180
    public function getRepository($className)
181
    {
182
        if (!is_string($className)) {
183
            throw new \InvalidArgumentException('Document class must be a string.');
184
        }
185
186
        $directory = null;
187
188
        if (strpos($className, ':')) {
189
            $bundle = explode(':', $className)[0];
190
191
            if (isset($this->config['mappings'][$bundle]['document_dir'])) {
192
                $directory = $this->config['mappings'][$bundle]['document_dir'];
193
            }
194
        }
195
196
        $namespace = $this->getMetadataCollector()->getClassName($className, $directory);
197
198
        if (isset($this->repositories[$namespace])) {
199
            return $this->repositories[$namespace];
200
        }
201
202
        $repository = $this->createRepository($namespace);
203
        $this->repositories[$namespace] = $repository;
204
205
        return $repository;
206
    }
207
208
    /**
209
     * @return MetadataCollector
210
     */
211
    public function getMetadataCollector()
212
    {
213
        return $this->metadataCollector;
214
    }
215
216
    /**
217
     * @return Converter
218
     */
219
    public function getConverter()
220
    {
221
        return $this->converter;
222
    }
223
224
    /**
225
     * @return string
226
     */
227
    public function getCommitMode()
228
    {
229
        return $this->commitMode;
230
    }
231
232
    /**
233
     * @param string $commitMode
234
     */
235
    public function setCommitMode($commitMode)
236
    {
237
        if ($commitMode === 'refresh' || $commitMode === 'flush' || $commitMode === 'none') {
238
            $this->commitMode = $commitMode;
239
        } else {
240
            throw new \LogicException('The commit method must be either refresh, flush or none.');
241
        }
242
    }
243
244
    /**
245
     * @return int
246
     */
247
    public function getBulkCommitSize()
248
    {
249
        return $this->bulkCommitSize;
250
    }
251
252
    /**
253
     * @param int $bulkCommitSize
254
     */
255
    public function setBulkCommitSize($bulkCommitSize)
256
    {
257
        $this->bulkCommitSize = $bulkCommitSize;
258
    }
259
260
    /**
261
     * Creates a repository.
262
     *
263
     * @param string $className
264
     *
265
     * @return Repository
266
     */
267
    private function createRepository($className)
268
    {
269
        return new Repository($this, $className);
270
    }
271
272
    /**
273
     * Executes search query in the index.
274
     *
275
     * @param array $types             List of types to search in.
276
     * @param array $query             Query to execute.
277
     * @param array $queryStringParams Query parameters.
278
     *
279
     * @return array
280
     */
281
    public function search(array $types, array $query, array $queryStringParams = [])
282
    {
283
        $params = [];
284
        $params['index'] = $this->getIndexName();
285
        
286
        if (!empty($types)) {
287
            $params['type'] = implode(',', $types);
288
        }
289
        
290
        $params['body'] = $query;
291
292
        if (!empty($queryStringParams)) {
293
            $params = array_merge($queryStringParams, $params);
294
        }
295
296
        $this->stopwatch('start', 'search');
297
        $result = $this->client->search($params);
298
        $this->stopwatch('stop', 'search');
299
300
        return $result;
301
    }
302
303
    /**
304
     * Adds document to next flush.
305
     *
306
     * @param object $document
307
     */
308
    public function persist($document)
309
    {
310
        $documentArray = $this->converter->convertToArray($document);
311
        $type = $this->getMetadataCollector()->getDocumentType(get_class($document));
312
313
        $this->bulk('index', $type, $documentArray);
314
    }
315
316
    /**
317
     * Adds document for removal.
318
     *
319
     * @param object $document
320
     */
321
    public function remove($document)
322
    {
323
        $data = $this->converter->convertToArray($document, [], ['_id', '_routing']);
324
325
        if (!isset($data['_id'])) {
326
            throw new \LogicException(
327
                'In order to use remove() method document class must have property with @Id annotation.'
328
            );
329
        }
330
331
        $type = $this->getMetadataCollector()->getDocumentType(get_class($document));
332
333
        $this->bulk('delete', $type, $data);
334
    }
335
336
    /**
337
     * Flushes elasticsearch index.
338
     *
339
     * @param array $params
340
     *
341
     * @return array
342
     */
343
    public function flush(array $params = [])
344
    {
345
        return $this->client->indices()->flush(array_merge(['index' => $this->getIndexName()], $params));
346
    }
347
348
    /**
349
     * Refreshes elasticsearch index.
350
     *
351
     * @param array $params
352
     *
353
     * @return array
354
     */
355
    public function refresh(array $params = [])
356
    {
357
        return $this->client->indices()->refresh(array_merge(['index' => $this->getIndexName()], $params));
358
    }
359
360
    /**
361
     * Inserts the current query container to the index, used for bulk queries execution.
362
     *
363
     * @param array $params Parameters that will be passed to the flush or refresh queries.
364
     *
365
     * @return null|array
366
     *
367
     * @throws BulkWithErrorsException
368
     */
369
    public function commit(array $params = [])
370
    {
371
        if (!empty($this->bulkQueries)) {
372
            $bulkQueries = array_merge($this->bulkQueries, $this->bulkParams);
373
            $bulkQueries['index']['_index'] = $this->getIndexName();
374
            $this->eventDispatcher->dispatch(
375
                Events::PRE_COMMIT,
376
                new CommitEvent($this->getCommitMode(), $bulkQueries)
377
            );
378
379
            $this->stopwatch('start', 'bulk');
380
            $bulkResponse = $this->client->bulk($bulkQueries);
381
            $this->stopwatch('stop', 'bulk');
382
383
            if ($bulkResponse['errors']) {
384
                throw new BulkWithErrorsException(
385
                    json_encode($bulkResponse),
386
                    0,
387
                    null,
388
                    $bulkResponse
0 ignored issues
show
Documentation introduced by
$bulkResponse is of type callable, but the function expects a array.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
389
                );
390
            }
391
392
            $this->bulkQueries = [];
393
            $this->bulkCount = 0;
394
395
            $this->stopwatch('start', 'refresh');
396
397
            switch ($this->getCommitMode()) {
398
                case 'flush':
399
                    $this->flush($params);
400
                    break;
401
                case 'refresh':
402
                    $this->refresh($params);
403
                    break;
404
            }
405
406
            $this->eventDispatcher->dispatch(
407
                Events::POST_COMMIT,
408
                new CommitEvent($this->getCommitMode(), $bulkResponse)
0 ignored issues
show
Documentation introduced by
$bulkResponse is of type callable, but the function expects a array|null.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
409
            );
410
411
            $this->stopwatch('stop', 'refresh');
412
413
            return $bulkResponse;
414
        }
415
416
        return null;
417
    }
418
419
    /**
420
     * Adds query to bulk queries container.
421
     *
422
     * @param string       $operation One of: index, update, delete, create.
423
     * @param string|array $type      Elasticsearch type name.
424
     * @param array        $query     DSL to execute.
425
     *
426
     * @throws \InvalidArgumentException
427
     *
428
     * @return null|array
429
     */
430
    public function bulk($operation, $type, array $query)
431
    {
432
        if (!in_array($operation, ['index', 'create', 'update', 'delete'])) {
433
            throw new \InvalidArgumentException('Wrong bulk operation selected');
434
        }
435
436
        $this->eventDispatcher->dispatch(
437
            Events::BULK,
438
            new BulkEvent($operation, $type, $query)
439
        );
440
441
        $this->bulkQueries['body'][] = [
442
            $operation => array_filter(
443
                [
444
                    '_type' => $type,
445
                    '_id' => isset($query['_id']) ? $query['_id'] : null,
446
                    '_ttl' => isset($query['_ttl']) ? $query['_ttl'] : null,
447
                    '_routing' => isset($query['_routing']) ? $query['_routing'] : null,
448
                    '_parent' => isset($query['_parent']) ? $query['_parent'] : null,
449
                ]
450
            ),
451
        ];
452
        unset($query['_id'], $query['_ttl'], $query['_parent'], $query['_routing']);
453
454
        switch ($operation) {
455
            case 'index':
456
            case 'create':
457
            case 'update':
458
                $this->bulkQueries['body'][] = $query;
459
                break;
460
            case 'delete':
461
                // Body for delete operation is not needed to apply.
462
            default:
463
                // Do nothing.
464
                break;
465
        }
466
467
        // We are using counter because there is to difficult to resolve this from bulkQueries array.
468
        $this->bulkCount++;
469
470
        $response = null;
471
472
        if ($this->bulkCommitSize === $this->bulkCount) {
473
            $response = $this->commit();
474
        }
475
476
        return $response;
477
    }
478
479
    /**
480
     * Optional setter to change bulk query params.
481
     *
482
     * @param array $params Possible keys:
483
     *                      ['consistency'] = (enum) Explicit write consistency setting for the operation.
484
     *                      ['refresh']     = (boolean) Refresh the index after performing the operation.
485
     *                      ['replication'] = (enum) Explicitly set the replication type.
486
     */
487
    public function setBulkParams(array $params)
488
    {
489
        $this->bulkParams = $params;
490
    }
491
492
    /**
493
     * Creates fresh elasticsearch index.
494
     *
495
     * @param bool $noMapping Determines if mapping should be included.
496
     *
497
     * @return array
498
     */
499
    public function createIndex($noMapping = false)
500
    {
501
        if ($noMapping) {
502
            unset($this->indexSettings['body']['mappings']);
503
        }
504
505
        return $this->getClient()->indices()->create($this->indexSettings);
506
    }
507
508
    /**
509
     * Drops elasticsearch index.
510
     */
511
    public function dropIndex()
512
    {
513
        return $this->getClient()->indices()->delete(['index' => $this->getIndexName()]);
514
    }
515
516
    /**
517
     * Tries to drop and create fresh elasticsearch index.
518
     *
519
     * @param bool $noMapping Determines if mapping should be included.
520
     *
521
     * @return array
522
     */
523
    public function dropAndCreateIndex($noMapping = false)
524
    {
525
        try {
526
            $this->dropIndex();
527
        } catch (\Exception $e) {
528
            // Do nothing, our target is to create new index.
529
        }
530
531
        return $this->createIndex($noMapping);
532
    }
533
534
    /**
535
     * Checks if connection index is already created.
536
     *
537
     * @return bool
538
     */
539
    public function indexExists()
540
    {
541
        return $this->getClient()->indices()->exists(['index' => $this->getIndexName()]);
542
    }
543
544
    /**
545
     * Returns index name this connection is attached to.
546
     *
547
     * @return string
548
     */
549
    public function getIndexName()
550
    {
551
        return $this->indexSettings['index'];
552
    }
553
554
    /**
555
     * Sets index name for this connection.
556
     *
557
     * @param string $name
558
     */
559
    public function setIndexName($name)
560
    {
561
        $this->indexSettings['index'] = $name;
562
    }
563
564
    /**
565
     * Returns mappings of the index for this connection.
566
     *
567
     * @return array
568
     */
569
    public function getIndexMappings()
570
    {
571
        return $this->indexSettings['body']['mappings'];
572
    }
573
574
    /**
575
     * Returns Elasticsearch version number.
576
     *
577
     * @return string
578
     */
579
    public function getVersionNumber()
580
    {
581
        return $this->client->info()['version']['number'];
582
    }
583
584
    /**
585
     * Clears elasticsearch client cache.
586
     */
587
    public function clearCache()
588
    {
589
        $this->getClient()->indices()->clearCache(['index' => $this->getIndexName()]);
590
    }
591
592
    /**
593
     * Returns a single document by ID. Returns NULL if document was not found.
594
     *
595
     * @param string $className Document class name or Elasticsearch type name
596
     * @param string $id        Document ID to find
597
     * @param string $routing   Custom routing for the document
598
     *
599
     * @return object
600
     */
601
    public function find($className, $id, $routing = null)
602
    {
603
        $type = $this->resolveTypeName($className);
604
605
        $params = [
606
            'index' => $this->getIndexName(),
607
            'type' => $type,
608
            'id' => $id,
609
        ];
610
611
        if ($routing) {
0 ignored issues
show
Bug Best Practice introduced by
The expression $routing of type string|null is loosely compared to true; this is ambiguous if the string can be empty. You might want to explicitly use !== null instead.

In PHP, under loose comparison (like ==, or !=, or switch conditions), values of different types might be equal.

For string values, the empty string '' is a special case, in particular the following results might be unexpected:

''   == false // true
''   == null  // true
'ab' == false // false
'ab' == null  // false

// It is often better to use strict comparison
'' === false // false
'' === null  // false
Loading history...
612
            $params['routing'] = $routing;
613
        }
614
615
        try {
616
            $result = $this->getClient()->get($params);
617
        } catch (Missing404Exception $e) {
618
            return null;
619
        }
620
621
        return $this->getConverter()->convertToDocument($result, $this);
0 ignored issues
show
Documentation introduced by
$result is of type callable, but the function expects a array.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
622
    }
623
624
    /**
625
     * Fetches next set of results.
626
     *
627
     * @param string $scrollId
628
     * @param string $scrollDuration
629
     *
630
     * @return mixed
631
     *
632
     * @throws \Exception
633
     */
634
    public function scroll(
635
        $scrollId,
636
        $scrollDuration = '5m'
637
    ) {
638
        $results = $this->getClient()->scroll(['scroll_id' => $scrollId, 'scroll' => $scrollDuration]);
639
640
        return $results;
641
    }
642
643
    /**
644
     * Clears scroll.
645
     *
646
     * @param string $scrollId
647
     */
648
    public function clearScroll($scrollId)
649
    {
650
        $this->getClient()->clearScroll(['scroll_id' => $scrollId]);
651
    }
652
653
    /**
654
     * Calls "Get Settings API" in Elasticsearch and will return you the currently configured settings.
655
     *
656
     * return array
657
     */
658
    public function getSettings()
659
    {
660
        return $this->getClient()->indices()->getSettings(['index' => $this->getIndexName()]);
661
    }
662
663
    /**
664
     * Gets Elasticsearch aliases information.
665
     * @param $params
666
     *
667
     * @return array
668
     */
669
    public function getAliases($params = [])
670
    {
671
        return $this->getClient()->indices()->getAliases(array_merge(['index' => $this->getIndexName()], $params));
672
    }
673
674
    /**
675
     * Resolves type name by class name.
676
     *
677
     * @param string $className
678
     *
679
     * @return string
680
     */
681
    private function resolveTypeName($className)
682
    {
683
        if (strpos($className, ':') !== false || strpos($className, '\\') !== false) {
684
            return $this->getMetadataCollector()->getDocumentType($className);
685
        }
686
687
        return $className;
688
    }
689
690
    /**
691
     * Starts and stops an event in the stopwatch
692
     *
693
     * @param string $action   only 'start' and 'stop'
694
     * @param string $name     name of the event
695
     */
696
    private function stopwatch($action, $name)
697
    {
698
        if (isset($this->stopwatch)) {
699
            $this->stopwatch->$action('ongr_es: '.$name, 'ongr_es');
700
        }
701
    }
702
}
703