輕鬆整合新版Elasticsearch7.9中文搜尋到Laravel7項目-Laravel-PHP中文網

首頁

php框架

Laravel

輕鬆整合新版Elasticsearch7.9中文搜尋到Laravel7項目

藏色散人

Sep 16, 2020 am 09:15 AM

phplaravel

以下由Laravel教學專欄為大家介紹如何輕鬆整合新版Elasticsearch7.9中文搜尋到Laravel7項目，希望對需要的朋友有幫助！

ar414 5分钟集成新版 Elasticsearch7.9 中文搜索到你的 Laravel7 项目

只需五個步驟：

1、啟動整合ik中文分詞外掛程式的Elasticsearch7.9 Docker映像

課程推薦→：《elasticsearch全文搜尋實戰》（實戰影片）

來自課程《千萬級資料並發解決方案（理論實戰）》

2、Laravel7 配置Scout

3、配置Model模型

4、導入資料

5、搜尋

#示範位址

ar414 5分钟集成新版 Elasticsearch7.9 中文搜索到你的 Laravel7 项目

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

搜尋範圍

文章內容
標題
標籤

#結果權重

出現關鍵字數量
出現關鍵字次數

搜尋頁面

#高亮顯示
分詞顯示
結果分頁

#前言

主要是部落格剛好想做個搜尋,順便就整理成文章

Laravel Elasticsearch 很多前輩都寫過教程和案例,但是隨著Elasticsearch和laravel的版本升級以前的文章很多都不適用新版本的,建議大家使用任何開源專案時應該過一遍文件以目前使用的版本文件為主,教程為輔

Elasticsearch 7.9
Laravel 7
elasticsearch-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

輕鬆整合新版Elasticsearch7.9中文搜尋到Laravel7項目
驗證<pre class="brush:php;toolbar:false">$ 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"}</pre>測試中文分詞<pre class="brush:php;toolbar:false">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 } ]}</pre>

Laravel 專案中使用Elasticsearch

#Elasticsearch
優雅

ElasticSearch驅動程式

。

laravel/scout

#輕鬆整合新版Elasticsearch7.9中文搜尋到Laravel7項目

$ composer require laravel/scout
$ composer require 輕鬆整合新版Elasticsearch7.9中文搜尋到Laravel7項目

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

##第一種：在.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####

实际业务中使用

需求

14分钟14秒集成 Elasticsearch中文搜索到你的 Laravel 项目

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

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

涉及到2张 Mysql表以及字段

article
- title
- tags
article_content
- content

为文章配置 Elasticsearch 索引

创建索引配置文件（config/elasticsearch.php）
```
$ touch config/elasticsearch.php
```

elasticsearch.php 配置字段映射

<?phpreturn  [
 &#39;indices&#39; => [
     '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

代码

<?phpnamespace  App\Console\Commands;use App\Models\Blog\Article;use App\Models\Blog\ArticleContent;use Illuminate\Console\Command;use Illuminate\Support\Carbon;class ElasticTest extends Command{
    /**
     * The name and signature of the console command.
     *
     * @var string
     */
    protected $signature = &#39;elasticsearch {query}&#39;;

    /**
     * The console command description.
     *
     * @var string
     */
    protected $description = &#39;elasticsearch test&#39;;

    /**
     * Create a new command instance.
     *
     * @return void
     */
    public function __construct()
    {
        parent::__construct();
    }

    /**
     * Execute the console command.
     *
     * @return mixed
     */
    public function handle()
    {
        //
        $startTime = Carbon::now()->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 周杰伦

ar414 5分钟集成新版 Elasticsearch7.9 中文搜索到你的 Laravel7 项目

复杂查询
例如：自定义高亮显示

//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項目的詳細內容。更多資訊請關注PHP中文網其他相關文章！

陳述

本文轉載於：learnku。如有侵權，請聯絡admin@php.cn刪除

行動中的Laravel：現實世界的應用和示例Apr 16, 2025 am 12:02 AM

laravelcanbeeffectefection ininreal-worldapplications forbuildingscalablewebsolutions.1）ITSImplifieCrudoperationsInrestfulaPisusingEloquentorm.2）laravel'secosystem，包括Toolslikenova，包括Toolslikenova，增強功能

Laravel的主要功能：後端開發Apr 15, 2025 am 12:14 AM

Laravel在後端開發中的核心功能包括路由系統、EloquentORM、遷移功能、緩存系統和隊列系統。 1.路由系統簡化了URL映射，提高了代碼組織和維護性。 2.EloquentORM提供了面向對象的數據操作，提升了開發效率。 3.遷移功能通過版本控制管理數據庫結構，確保一致性。 4.緩存系統減少數據庫查詢，提升響應速度。 5.隊列系統有效處理大規模數據，避免阻塞用戶請求，提升整體性能。

Laravel的後端功能：數據庫，邏輯等等Apr 14, 2025 am 12:04 AM

Laravel在後端開發中表現強大，通過EloquentORM簡化數據庫操作，控制器和服務類處理業務邏輯，並提供隊列、事件等功能。 1)EloquentORM通過模型映射數據庫表，簡化查詢。 2)業務邏輯在控制器和服務類中處理，提高模塊化和可維護性。 3)其他功能如隊列系統幫助處理複雜需求。

Laravel的多功能性：從簡單站點到復雜系統Apr 13, 2025 am 12:13 AM

選擇Laravel開發項目是因為其靈活性和強大功能適應不同規模和復雜度的需求。 Laravel提供路由系統、EloquentORM、Artisan命令行等功能，支持從簡單博客到復雜企業級系統的開發。

Laravel（PHP）與Python：開發環境和生態系統Apr 12, 2025 am 12:10 AM

Laravel和Python在開發環境和生態系統上的對比如下：1.Laravel的開發環境簡單，僅需PHP和Composer，提供了豐富的擴展包如LaravelForge，但擴展包維護可能不及時。 2.Python的開發環境也簡單，僅需Python和pip，生態系統龐大，涵蓋多個領域，但版本和依賴管理可能複雜。

Laravel和後端：為Web應用程序提供動力邏輯Apr 11, 2025 am 11:29 AM

Laravel是如何在後端邏輯中發揮作用的？它通過路由系統、EloquentORM、認證與授權、事件與監聽器以及性能優化來簡化和增強後端開發。 1.路由系統允許定義URL結構和請求處理邏輯。 2.EloquentORM簡化數據庫交互。 3.認證與授權系統便於用戶管理。 4.事件與監聽器實現松耦合代碼結構。 5.性能優化通過緩存和隊列提高應用效率。

為什麼Laravel如此受歡迎？Apr 02, 2025 pm 02:16 PM

Laravel受歡迎的原因包括其簡化開發過程、提供愉快的開發環境和豐富的功能。 1)它吸收了RubyonRails的設計理念，結合PHP的靈活性。 2)提供瞭如EloquentORM、Blade模板引擎等工具，提高開發效率。 3)其MVC架構和依賴注入機制使代碼更加模塊化和可測試。 4)提供了強大的調試工具和性能優化方法，如緩存系統和最佳實踐。