资讯

精准传达 • 有效沟通

从品牌网站建设到网络营销策划,从策略到执行的一站式服务

轻松集成新版Elasticsearch7.9中文搜索到Laravel7项目

下面由Laravel教程栏目给大家介绍如何轻松集成新版Elasticsearch7.9中文搜索到Laravel7项目,希望对需要的朋友有所帮助!

阜康网站制作公司哪家好,找成都创新互联!从网页设计、网站建设、微信开发、APP开发、成都响应式网站建设等网站项目制作,到程序开发,运营维护。成都创新互联于2013年创立到现在10年的时间,我们拥有了丰富的建站经验和运维经验,来保证我们的工作的顺利进行。专注于网站建设就选成都创新互联

只需五步骤:

1.启动 集成ik中文分词插件的Elasticsearch7.9 Docker镜像
2.Laravel7 配置 Scout
3.配置 Model模型
4.导入数据
5.搜索

演示地址

www.ar414.com/search?query=php%E5%...

搜索范围

文章内容标题标签

结果权重

出现关键词数量出现关键词次数

搜索页面

高亮显示分词显示结果分页前言

主要是博客刚好想做个搜索,顺便就整理成文章

Laravel + Elasticsearch 很多前辈都写过教程和案例,但是随着Elasticsearch和laravel的版本升级 以前的文章很多都不适用新版本的,建议大家使用任何开源项目时应该过一遍文档以当前使用的版本文档为主,教程为辅

Elasticsearch 7.9Laravel 7elasticsearch-analysis-ik v7.9参考ik 中文分词插件elasticsearch 官方文档使用集成ik中文分词插件的Elasticsearch拉取docker
$ docker pull ar414/elasticsearch-7.9-ik-plugin
创建日志和数据存储目录

本地映射到docker容器内,防止docker重启数据丢失

$ mkdir -p /data/elasticsearch/data
$ mkdir -p /data/elasticsearch/log
$ chmod -R 777 /data/elasticsearch/data
$ chmod -R 777 /data/elasticsearch/log
运行
docker run -d -p 9200:9200 -p 9300:9300 -e "discovery.type=single-node" -v /data/elasticsearch/data:/var/lib/elasticsearch -v /data/elasticsearch/log:/var/log/elasticsearch ar414/elasticsearch-7.9-ik-plugin
验证
$ curl http://localhost:9200{
  "name" : "01ac21393985",  "cluster_name" : "docker-cluster",  "cluster_uuid" : "h8L336qcRb2i1aydOv04Og",  "version" : {
    "number" : "7.9.0",    "build_flavor" : "default",    "build_type" : "docker",    "build_hash" : "a479a2a7fce0389512d6a9361301708b92dff667",    "build_date" : "2020-08-11T21:36:48.204330Z",    "build_snapshot" : false,    "lucene_version" : "8.6.0",    "minimum_wire_compatibility_version" : "6.8.0",    "minimum_index_compatibility_version" : "6.0.0-beta1"
  },  "tagline" : "You Know, for Search"}
测试中文分词
curl -X POST "http://localhost:9200/_analyze?pretty" -H 'Content-Type: application/json' -d'
{
  "analyzer": "ik_max_word",
  "text":     "laravel天下无敌"
}
'{
  "tokens" : [
    {
      "token" : "laravel",      "start_offset" : 0,      "end_offset" : 7,      "type" : "ENGLISH",      "position" : 0    },    {
      "token" : "天下无敌",      "start_offset" : 7,      "end_offset" : 11,      "type" : "CN_WORD",      "position" : 1    },    {
      "token" : "天下",      "start_offset" : 7,      "end_offset" : 9,      "type" : "CN_WORD",      "position" : 2    },    {
      "token" : "无敌",      "start_offset" : 9,      "end_offset" : 11,      "type" : "CN_WORD",      "position" : 3    }
  ]}
Laravel 项目中使用 Elasticsearch


Elasticsearch官方有提供 SDK,在 Laravel 项目中可以更加优雅快速的接入 Elasticsearch,Laravel 本身有提供 Scout全文搜索 的解决方案,我们只需将默认的 Algolia 驱动 替换成ElasticSearch驱动

安装laravel/scoutmatchish/laravel-scout-elasticsearch
$ composer require laravel/scout
$ composer require matchish/laravel-scout-elasticsearch
配置

生成 Scout 配置文件(config/scout.php)

$ php artisan vendor:publish --provider="Laravel\\Scout\\ScoutServiceProvider"Copied File [\\vendor\\laravel\\scout\\config\\scout.php] To [\\config\\scout.php]Publishing complete.

指定 Scout 驱动

第一种:在.env文件中指定(建议)
SCOUT_DRIVER=Matchish\\ScoutElasticSearch\\Engines\\ElasticSearchEngine
第二种:在config/scout.php直接修改默认驱动
'driver' => env('SCOUT_DRIVER', 'algolia')改为'driver' => env('SCOUT_DRIVER', 'Matchish\\ScoutElasticSearch\\Engines\\ElasticSearchEngine')

指定Elasticsearch服务IP端口

如果使用docker部署则使用docker0的IP,Linux通过ifconfig查看

.env中配置

ELASTICSEARCH_HOST=172.17.0.1:9200

注册服务
config/app.php

'providers' => [
 // Other Service Providers
 \\Matchish\\ScoutElasticSearch\\ElasticSearchServiceProvider::class],

清除配置缓存

$ php artisan config:clear

至此 laravel 已经接入 Elasticsearch

实际业务中使用需求

通过博客右上角的搜索框可以搜索到与关键词相关的文章,从以下几点匹配

文章内容文章标题文章标签

涉及到2张 Mysql表 以及字段

articletitletagsarticle_contentcontent为文章配置 Elasticsearch 索引

创建索引配置文件(config/elasticsearch.php)

$ touch config/elasticsearch.php

elasticsearch.php 配置字段映射

 [
     'mappings' => [
         'blog-articles' => [
             "properties"=>  [
                 "content"=>  [
                     "type"=>  "text",
                     "analyzer"=>  "ik_max_word",
                     "search_analyzer"=>  "ik_smart"
                 ],
                 "tags"=>  [
                     "type"=>  "text",
                     "analyzer"=>  "ik_max_word",
                     "search_analyzer"=>  "ik_smart"
                 ],
                 "title"=>  [
                     "type"=>  "text",
                     "analyzer"=>  "ik_max_word",
                     "search_analyzer"=>  "ik_smart"
                 ]
             ]
         ]
     ]
 ],];
analyzer:字段文本的分词器search_analyzer:搜索词的分词器根据具体业务场景选择(颗粒小占用资源多,一般场景analyzer使用ik_max_word,search_analyzer使用ik_smart):ik_max_word:ik中文分词插件提供,对文本进行数量分词
laravel天下无敌-> laravel天下无敌,天下,无敌ik_smart: ik中文分词插件提供,对文本进行最小数量分词
laravel天下无敌-> laravel天下无敌配置文章模型

建议先看一遍 Laravel Scout 使用文档

引入Laravel Scout

namespace App\\Models\\Blog;

 use Laravel\\Scout\\Searchable;

 class Article extends BlogBaseModel
 {
     use Searchable;
 }

指定索引(刚刚配置文件中的elasticsearch.indices.mappings.blog-articles)

/**
  * 指定索引
  * @return string
  */
 public function searchableAs()
 {
     return 'blog-articles';
 }

设置导入索引的数据字段

/**
  * 设置导入索引的数据字段
  * @return array
  */
 public function toSearchableArray()
 {
     return [
         'content' => ArticleContent::query()
             ->where('article_id',$this->id)
             ->value('content'),
         'tags'    => implode(',',$this->tags),
         'title'   => $this->title
     ];
 }

指定 搜索索引中存储的唯一ID

/**
  * 指定 搜索索引中存储的唯一ID
  * @return mixed
  */
 public function getScoutKey()
 {
     return $this->id;
 }

 /**
  * 指定 搜索索引中存储的唯一ID的键名
  * @return string
  */
 public function getScoutKeyName()
 {
     return 'id';
 }
数据导入

其实是将数据表中的数据通过Elasticsearch导入到Lucene
Elasticsearch 是 Lucene 的封装,提供了 REST API 的操作接口

一键自动导入: php artisan scout:import导入指定模型: php artisan scout:import ${model}
$ php artisan scout:import "App\\Models\\Blog\\Article"Importing [App\\Models\\Blog\\Article]Switching to the new index
5/5 [⚬⚬⚬⚬⚬⚬⚬⚬⚬⚬⚬⚬⚬⚬⚬⚬⚬⚬⚬⚬⚬⚬⚬⚬⚬⚬⚬⚬] 100%[OK] All [App\\Models\\Blog\\Article] records have been imported.

导入失败,常见原因:

Unresolvable dependency resolving [Parameter #0 [ integer $retries ]] in class Elasticsearch\\Transport解决: 修改配置后,没有清除配置缓存invalid_index_name_exception解决: searchableAs配置错误,为索引创建别名后,指定别名检查索引是否正确
$ curl -XGET http://localhost:9200/blog-articles/_mapping?pretty{
  "blog-articles_1598362919" : {
    "mappings" : {
      "properties" : {
        "__class_name" : {
          "type" : "text",          "fields" : {
            "keyword" : {
              "type" : "keyword",              "ignore_above" : 256            }
          }
        },        "content" : {
          "type" : "text",          "analyzer" : "ik_max_word",          "search_analyzer" : "ik_smart"
        },        "tags" : {
          "type" : "text",          "analyzer" : "ik_max_word",          "search_analyzer" : "ik_smart"
        },        "title" : {
          "type" : "text",          "analyzer" : "ik_max_word",          "search_analyzer" : "ik_smart"
        }
      }
    }
  }}
测试

创建一个测试命令行

$ php artisan make:command ElasticTest

代码

getPreciseTimestamp(3);
        $articles = Article::search($this->argument('query'))->get()->toArray();
        $userTime = Carbon::now()->getPreciseTimestamp(3) - $startTime;
        echo "耗时(毫秒):{$userTime} \\n";

        //content在另外一张表中,方便观察测试 这里输出
        if(!empty($articles)) {
            foreach($articles as &$article) {
                $article = ArticleContent::query()->where('article_id',$article['id'])->value('content');
            }
        }

        var_dump($articles);

    }}
测试
$ php artisan elasticsearch 周杰伦

复杂查询
例如:自定义高亮显示
//ONGR\\ElasticsearchDSL\\Highlight\\Highlight ArticleModel::search($query,function($client,$body) {
         $higlight = new Highlight();
         $higlight->addField('content',['type' => 'plain']);
         $higlight->addField('title');
         $higlight->addField('tags');
         $body->addHighlight($higlight);
         $body->setSource(['title','tags']);
         return $client->search(['index' => (new ArticleModel())->searchableAs(), 'body' => $body->toArray()]);
     })->raw();

复杂自定义查询回调中的$client和$body,可根据这两个包进行灵活操作

$client 官方 elasticsearch/elasticsearch package(https://packagist.org/packages/elasticsearch/elasticsearch)

$body ongr/elasticsearch-dsl package(https://packagist.org/packages/ongr/elasticsearch-dsl)


本文标题:轻松集成新版Elasticsearch7.9中文搜索到Laravel7项目
文章链接:http://cdkjz.cn/article/choehg.html
多年建站经验

多一份参考,总有益处

联系快上网,免费获得专属《策划方案》及报价

咨询相关问题或预约面谈,可以通过以下方式与我们联系

大客户专线   成都:13518219792   座机:028-86922220