前言:
在开发我的项目中个别都会有搜寻性能。如果是面向 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;
}
}