Hyperf使用ElasticSearch記錄

2022-10-20 21:00:24

Hyperf 安裝 Elasticsearch 協程使用者端

hyperf/elasticsearch 主要為 elasticsearch-php 進行了使用者端物件建立的工廠類封裝,elasticsearch-php 預設使用 Guzzle Ring 使用者端,在 hyperf/guzzle 中我們實現了協程版本的 Handler,所以可以直接使用 Hyperf\Elasticsearch\ClientBuilderFactory 建立一個新的 Builder。

  • 安裝
composer require hyperf/elasticsearch
  • 建立使用者端
class ElasticsearchService
{
    protected $container;
    protected Client $es_client;

    public function _initialize(): void
    {
        $this->container = ApplicationContext::getContainer();
        $client_builder = $this->container->get(ClientBuilderFactory::class);
        $builder = $client_builder->create();
        $host = [
            'https://賬號:密碼@地址:9200'
        ];

        $this->es_client = $builder->setHosts($host)->build();
    }

}

這裡的賬號密碼指的是建立 elasticsearch 的時候的賬號密碼。如果是用阿里雲或者騰訊雲服務,建立好了之後一樣會有

這裡只是建立了協程使用者端,裡面的實際方法是要自己重新定義的

開發基本步驟

1 安裝 es 服務,也可以是騰訊雲或者阿里雲,騰訊雲阿里雲也只是提供 es 服務而已,並不是能直接看到資料。資料還是要在 kibana 裡面檢視。

2 建立協程使用者端

3 建立 index。index 相當於 mysql 裡面的庫

4 建立 mapping mapping 可以理解成表。要儲存資料要先定義好表。

5 index 方法推播單條資料。bulk 批次推播資料

6 search 搜尋資料。

備註:

以下全網最全了

https://blog.csdn.net/qq_41911898/article/details/110089644 可以在這裡檢視每個方法的資料格式。

https://blog.csdn.net/qq_18361349/article/details/106369551 參考

完整程式碼

<?php

namespace App\Service\Common;

use App\Service\Service;
use Elasticsearch\Client;
use Hyperf\Elasticsearch\ClientBuilderFactory;
use Hyperf\Utils\ApplicationContext;

/**
 *
 */
class ElasticsearchService extends Service
{

    /**
     * @var
     */
    protected $container;

    /**
     * @var Client
     */
    protected Client $es_client;

    public function _initialize(): void
    {
        $this->container = ApplicationContext::getContainer();
        $client_builder = $this->container->get(ClientBuilderFactory::class);
        $builder = $client_builder->create();
        $host = [
            'https://賬號:密碼@地址:9200'
        ];

        $this->es_client = $builder->setHosts($host)->build();
    }

    /**
     * 建立index - 相當於MySQL的資料庫
     * @param string $index
     * @return array
     */
    public function createIndex(string $index): array
    {
        $params = [
            'index' => $index,
        ];
        return $this->es_client->indices()->create($params);
    }

    /**
     * 設定mapping
     * @param $params
     * @return array
     */
    public function putMapping($params): array
    {
        return $this->es_client->indices()->putMapping($params);
    }

    /**
     * 獲取mapping
     * @param $params
     * @return array
     */
    public function getMapping($params): array
    {
        return $this->es_client->indices()->getMapping($params);
    }

    /**
     * 判斷索引是否存在
     * @param string $index
     * @return bool
     */
    public function indexExistsEs(string $index): bool
    {
        $params = [
            'index' => $index,
        ];
        return $this->es_client->indices()->exists($params);
    }

    /**
     * 刪除索引
     * @param string $index
     * @return array|callable
     */
    public function deleteIndex(string $index): callable|array
    {
        $params = [
            'index' => $index
        ];
        return $this->es_client->indices()->delete($params);
    }

    /**
     * 建立檔案
     * @param array $params
     * @return array|callable
     */
    public function indexEs(array $params): callable|array
    {
        $index_data = [
            'index' => $params['index'],
            'body' => $params['body'],
        ];
        return $this->es_client->index($index_data);
    }

    /**
     * 批次建立檔案
     * @param array $params
     * @return callable|array
     */
    public function bulk(array $params): callable|array
    {
        return $this->es_client->bulk($params);
    }

    /**
     * 更新檔案
     * @param array $params
     * $params = [
     *      'index' => 'chat_data',
     *       'id' => '檔案id',
     *       'doc' => [
     *          '欄位名1' => '要修改的值',
     *          '欄位名2' => '要修改的值',
     *          '欄位名3' => '要修改的值',
     *       ]
     * ]
     * @return array|callable
     */
    public function update(array $params): callable|array
    {
        $params = [
            'index' => $params['index'],
            'id' => $params['id'],
            'body' => [
                'doc' => $params['doc']
            ]
        ];
        return $this->es_client->update($params);
    }

    /**
     * 刪除檔案
     * @param $params
     * @return array|callable
     */
    public function deleteEs($params): callable|array
    {
        extract($params);
        $delete_data = [
            'index' => $index,
            'type' => $type,
            'id' => $id,
        ];
        return $this->es_client->delete($delete_data);
    }

    /**
     * es搜尋資料
     * @param array $params
     * @param int $page
     * @param int $size
     * @return array|callable
     */
    public function search(array $params, int $page = 1, int $size = 15): callable|array
    {
        $search = $params['search'];
        $params = [
            'index' => $params['index'],
            'from' => ($page <= 0) ? 0 : $page - 1,
            'size' => $size
        ];
        // 只有一個搜尋欄位時
        if (count($search) == 1) {
            $query = [
                'match_phrase' => $search
            ];
        } else {
            $must = [];
            foreach ($search as $k => $v) {
                // 一定要把時間篩選弄出來,因為這裡的條件類似where('xxxx','xxxx')
                if(!in_array($k,['start_time','end_time'])) {
                    $must[] = ['match' => [$k => $v]];
                }
            }
            $query['bool']['must'] = $must;
            // 時間搜尋
            if(!empty($search['start_time'])) {
                $filter = [
                    'range' => [
                        'start_time' =>[
                            'gte' => $search['start_time'],
                            'lte' => $search['end_time']
                        ]
                    ]
                ];
                $query['bool']['filter'] = $filter;
            }
        }


        $params['body'] = [
                'query' => $query,
        ];
        return $this->es_client->search($params);
    }

}