乐趣区

关于php:Elasticsearch的基础使用

作者：

jiezi

在

前言：

    在开发我的项目中个别都会有搜寻性能。如果是面向C端的搜寻性能，往往都特地考验性能。比方一般的商城零碎中的商品搜寻或者一些资源的站内搜索。

    可能以前的做法就是对商品表做一个按名称或商品形容做含糊查问。更好一点的是对搜寻关键字进行分词，并且专门建一个搜寻词库表。不过后期须要对搜索词进行拆解而后幂集组合并于商品ID关联，搜寻字与词库表的字以齐全匹配的形式查问并找到商品ID。

    尽管建词库表也是不错的解决办法，然而还要拆解存库建索引，绝对比拟麻烦。所以也是在网上查问理解到了elasticsearch，打算当前做站内搜索用ES，上面就简略介绍一下他的根本应用办法。
 

ES介绍：

     ElasticSearch是一个基于Lucene的搜寻服务器。它提供了一个分布式多用户能力的全文搜索引擎，基于RESTful web接口。Elasticsearch是用Java开发的，并作为Apache许可条款下的开放源码公布，是以后风行的企业级搜索引擎。设计用于云计算中，可能达到实时搜寻，稳固，牢靠，疾速，装置使用方便。
 

下载安装：

找到官网，按本人的零碎下载对应版本，目前200多M。
    

解压后关上目录中的bin里的”elasticsearch.bat”就能够启动。

启动工夫绝对慢一点，以下只演示单机单节点应用，分布式能够前期配置。

 

编码应用：

以下是以ThinkPHP6.0.2进行演示应用，所以在ES服务开启后，先关上浏览器拜访127.0.0.1:9200，如果返回上面示意胜利开启。

ThinkPHP6.0中通过composer install elasticsearch/elasticsearch 下载ES依赖包，如果composer慢能够试一下下载办法后再装置。

 

并且每次要本地应用ES时都要先开启elasticsearch.bat文件，不然就会呈现上面的提醒。

 

在应用前须要了解一下ES的几个名词：索引，Type，文档，字段，映射。并且ES以restful格调进行查问，所以能够将后面的名词能够和MySQL的数据库，表，列，SQL关联一下。

比方索引相当于MySQL的数据库，文档相当于表中的一条记录restful形式申请就相似于SQL语句。比方GET 索引名/Type/ID 能够获取文档数据，POST，PUT，DELETE等等创立索引，创立/批改/删除文档等能够查问官网文档，而后应用POSTMAN用不同的申请127.0.0.1:9200。

当初回到ThinkPHP6中，在装置ES依赖后。能够封装一个ES根本办法工具类。

<?php


namespace app\common\helper;

use Elasticsearch\ClientBuilder as ESClientBuilder;
class Elasticsearch
{
    protected $config = [
        "127.0.0.1:9200",
    ];
    protected $es;

    /*
     * @Title:  构造函数
     * @Author: 北桥苏
     * @Times:  2020/5/14 17:35
     * */
    public function __construct()
    {
        $this->es = $this->init();
    }

    /*
     * @Title ElasticSearch服务初始化
     * @Return object ES实例
     * */
    private function init()
    {
        // 从配置文件读取 Elasticsearch 服务器列表
        $builder = ESClientBuilder::create()->setHosts($this->config);

        // 利用调试模式
//        if (env('APP_DEBUG')) {
//            // 配置日志，Elasticsearch 的申请和返回数据将打印到日志文件
//            $builder->setLogger(app('log')->error());
//        }
        return $builder->build();
    }

    /*
     * @Title: 获取ES服务信息
     * @Return: ES服务的根本信息
     * */
    public function info()
    {
        return $this->es->info();
    }

    /*
     * @Titles: 创立索引
     * @Param: string $name 索引名
     * @Param: array $mappings 字段映射
     * @Return: boolean 创立后果
     * */
    public function index($name, $mappings=[])
    {
        $params = [
            'index' => $name,
            'body' => [
                'settings' => [
                    'number_of_shards' => 1,                // 索引分片(一个索引能够分多个分片在不同的节点上)
                    'number_of_replicas' => 0,              // 索引分片正本
                ]
            ]
        ];
        // 创立索引设置字段以及字段类型分词器等
        if($mappings) {
            $params['body']['mappings']['properties'] = $mappings;
        }

        return $this->es->indices()->create($params);
    }

    /*
     * @Title: 获取索引配置,能够获取单个索引，不传参数是节点上的所有索引
     * @Param: array $name 索引名数组
     * @Return:array 索引的名称分片正本数等数据
     * */
    public function getIndexConfig($name=[])
    {
        $params = [];
        if(!empty($name)) {
            $params = [
                "index" => $name
            ];
        }
        return $this->es->indices()->getSettings($params);
    }

    /*
     * @Title: 创立/更改映射(创立索引时也能够指定映射-其实就是存储数据的字段类型)
     * @Param: string $name 索引名
     * @Param: array $data 字段设置
     * @Return boolean 批改后果
     * */
    public function putMapping($name, $data)
    {
        $params = [
            'index' => $name,
            'body' => [
                '_source' => [
                    'enabled' => true
                ],
                'properties' => $data
            ]
        ];

        return $this->es->indices()->putMapping($params);
    }

    /*
     * @Tile: 获取索引设置的字段映射
     * @Param: string $name
     * @Return: array
     * */
    public function getMapping($name)
    {
        $params = ['index' => $name];
        return $this->es->indices()->getMapping($params);
    }

    /**
     * @Notes: 获取索引中的文档
     * @param $name 索引名称
     * @param $id 编号
     * @Return: 文档数据
     */
    public function getIndex($name, $id)
    {
        return $this->es->get(['index' => $name, 'id' => $id]);
    }

    /**
     * @Notes: 删除索引
     * @param $name 索引名称
     * @return array
     */
    public function deleteIndex($name)
    {
        return $this->es->indices()->delete(['index' => $name]);
    }


    /***********************文档局部********************************************************/

    /*
     * @Tiele: 在某索引中创立一个文档(如果索引未设置映射，增加文档会主动创立字段类型等)
     * @Param: string $name 索引名
     * @Param: array $data 文档数据
     * @Return array
     * */
    public function createDoc($name, $data)
    {
        $params = [
            'index' => $name,
            'id'    => $data['id'],
            'body'  => $data
        ];
        $response = $this->es->index($params);
        return $response;
    }

    /**
     * @Notes: 更新文档
     * @param $index 索引
     * @param $id 文档 id
     * @param $data 字段
     * @author: 北桥苏
     * @Time: 2020/4/21 9:51
     */
    public function updateDoc($index, $id, array $data)
    {
        $params = [
            'index' => $index,
            'id' => $id,
            //'type' => '_doc',
            'body' => [
                'doc' => $data
            ]
        ];

        $this->es->update($params);
    }

    // 删除一个文档
    /*
     * @Tile: 删除一个文档
     * @Param: array $param 删除索引名，ID
     * @Return array
     * */
    public function delDoc($param)
    {
        $this->es->delete($param);
    }

    // 批量创立文档
    public function bulk($params)
    {
        return $this->es->bulk($params);
    }

    // 搜寻
    public function queryData($index,$kye, $from = 0, $size = 10)
    {
        $params = [
            'index' => $index,
            'body'  => [
                'from'  => $from,
                'size'  => $size,
                'query' => [
                    'match' => [
                        'class_name'  => '版',
                    ],
                ]
            ],
        ];

        return $this->es->search($params);
    }

    /*
     * @Tile: 多功能搜寻
     * @Param string $index 索引名称
     * @Param array $where 条件数组
     * @Param array $sort 排序数组
     * @Param int $from 开始查问的地位
     * @Param int $size 一共查问的条数
     * @Return array 查问后果
     * */
    public function query($index,$where,$sort='',$from=0,$size=1500)
    {
        $params = [
            "index" => $index,
            "body" => [
                "from" => $from,
                "size" => $size,
                "query" => $where
            ]
        ];

        if($sort) {
            $params['body']['sort'] = $sort;
        }

        return $this->es->search($params);
    }



}

4.业务应用代码块。

以下app(‘es’)在provider.php注册到容器中

<?php
namespace app\admin\controller;

use app\BaseController;

class Test extends BaseController
{
    
    public function index()
    {
        var_dump(2323);die;
    }

    // 测试ElasticSearch
    public function esTest()
    {
        $res = app('es')->info();
        dump($res);die;
    }

    // 创立一个索引
    public function createIndex()
    {
        $res = app('es')->index("goods");
        var_dump($res);die;
    }

    // 创立文档
    public function createDoc()
    {

        $goodsList = \app\common\model\Goods::page(0,1500)->select()->toArray();

        foreach ($goodsList as $val) {
            $res = app('es')->createDoc('goods',$val);
        }

        dump($res);die;

        $goods = \app\common\model\Goods::find(1);
        var_dump($goods);die;
    }

    // 搜寻
    public function queryDoc()
    {
        // 获取所有
        $where = [
            'match_all' => new \stdClass(),                 // 空对象，PHP5.3  或者     (object)[]    //也是给出空数组的形式
        ];

        // 单字段齐全匹配
//        $where = [
//            'match_phrase' => [
//                'class_name' => '班',
//            ]
//        ];

        // 单字段含糊匹配
//        $where = [
//            'match' => [
//                'goods_name' => '苹果'
//            ]
//        ];

        // 多字段匹配
//        $where = [
//            'multi_match' => [
//                'query' => '苹果',
//                'fields' => ['goods_name'],     //这里增加多字段
//                'type' => 'best_fields'         //most_fields多字段匹配更高，best_fields齐全匹配占比更高
//            ]
//        ];

        // 联结搜寻must联结必须,should联结能够,must_not联结不必须, 联结搜寻相似SQL的多字段查问(就应用must)
//        $where = [
//            'bool' => [
//                'must' => [
//                    'match' => [
//                        'goods_name' => '苹果'
//                    ]
//                ],
//                'should' => [
//                    'match' => [
//                        'level' => '3'
//                    ]
//                ]
//            ]
//        ];

        // 排序非必填
        $sort = [
            "sort" => "asc"
        ];

        $res = app('es')->query('goods',$where,$sort,0,3000);
        dump($res);die;

//        $res = app('es')->queryData('class','class_name',0,20);
//        dump($res);die;
    }

    // 获取索引(索引中的某个文档)
    public function getDoc()
    {
        $res = app('es')->getIndex('goods',1500);
        dump($res);die;
    }

    // 获取的索引配置
    public function getIndexConfig()
    {
        $res = app('es')->getIndexConfig('class,user,goods');
        dump($res);die;
    }
}

评论

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

这个站点使用 Akismet 来减少垃圾评论。了解你的评论数据如何被处理。

更多文章