es环境安装及php对接使用

news/2024/5/17 18:49:53

Elasticsearch

Elasticsearch 是一个分布式、高扩展、高实时的搜索与数据分析引擎。它提供了一个分布式多用户能力的全文搜索引擎，基于RESTful web接口。Elasticsearch是用Java语言开发的，并作为Apache许可条款下的开放源码发布，是一种流行的企业级搜索引擎。Elasticsearch用于云计算中，能够达到实时搜索，稳定，可靠，快速，安装使用方便。官方客户端在Java、.NET（C#）、PHP、Python、Apache Groovy、Ruby和许多其他语言中都是可用的。

安装

本文只介绍windows环境的使用及安装。

进入官网：
https://www.elastic.co/cn/downloads/elasticsearch
下载对应版本:

注意：下载对应的版本，版本号要跟php composer 里面的elasticsearch/elasticsearch 的版本号一致。

在这里插入图片描述

比如本次下载的 elasticsearch 为8.4版本，composer 包elasticsearch/elasticsearch也要8.4版本。否则在使用php客户端的时候会出错。

解压安装包：
进入解压的文件，找到bin 目录，执行elasticsearch.bat

第一次执行应该会报错，因为默认是开启ssl认证和密码认证这些的。
需要进入config 目录，找到elasticsearch.yml 配置文件:

在这里插入图片描述

修改：xpack.security.enabled: true 为falsexpack.security.http.ssl:enabled: true 为false# 增加新的参数，这样head插件可以访问es
http.cors.enabled: true
http.cors.allow-origin: "*"

保存，再次执行elasticsearch.bat,在浏览器中访问127.0.0.1:9200，有返回json表示成功
在这里插入图片描述

安装es可视化插件 elasticsearch-head

该插件需要node支持。

源代码下载：https://github.com/mobz/elasticsearch-head

进入目录：
打开cmd控制窗口，或者用编辑器打开项目然后打开命令窗口。
执行安装命令：npm install
运行命令： npm run start

运行后，打开浏览器http://localhost:9100，查看界面。可以在数据浏览里面查看数据
请添加图片描述

laravel 对接使用

本文以laravel9为测试用例。使用scout包作为laravel的全文检索。

下载composer scout

composer require laravel/scout

下载scout 可用的elasticsearch 驱动支持
目前支持的驱动有：

composer require babenkoivan/elastic-scout-drivercomposer require babenkoivan/elastic-scout-driver-plus

本文用的是 composer require babenkoivan/elastic-scout-driver

安装完后：执行发布命令

php artisan vendor:publish --provider="Laravel\Scout\ScoutServiceProvider"

此命令将会在你的 config 目录下生成一个 scout.php 配置文件
你需要把scout驱动更改为es驱动：

'driver' => env('SCOUT_DRIVER', 'elastic'),

生成es配置命令：

php artisan vendor:publish --provider="Elastic\Client\ServiceProvider"

此命令会生成es驱动配置文件config/elastic.client.php 更改对应的配置：

<?php declare(strict_types=1);return ['default' => env('ELASTIC_CONNECTION', 'default'),'connections' => ['default' => ['hosts' => [env('ELASTIC_HOST', 'localhost:9200'),],],],
];

laravel 模型中使用搜索引擎

用laravel 模型操作es，数据源其实是有两份的。数据库里面一份，es里面一份。es里面的数据跟数据库里面的数据其实是一样的。模型检索数据的时候，用到全文检索，就是去es里面查询，如果没有用到就在数据库里面查询。
同时模型在curd的时候，会自动同步到es里面。

创建一个模型：


<?phpnamespace App\Models;use DateTimeInterface;
use App\Models\BaseModel as Model;
use Laravel\Scout\Searchable;class Test extends Model
{use Searchable;protected $table='sys_test';protected function serializeDate(DateTimeInterface $date){return $date->format('Y-m-d H:i:s');}/*** 获取与模型关联的索引的名称。** @return string*/public function searchableAs(){return 'laravel';}}

导入已有项目数据:

如果,你的项目中已经有数据在表中，需要把数据导入到es里面，就需要执行下面命令：

php artisan scout:import "App\Models\Test"

使用:

使用跟正常laravel模型大致操作一样，搜索的时候用search

 //查询$data= Test::search('李')->get();dd($data->toArray());

官方包正常使用es

下载官方扩展

composer require elasticsearch/elasticsearch

注意：composer require elasticsearch/elasticsearch 版本需要跟你下载的es安装包保持一致

# 我下载的8.4 版本，8.4版本需要 elastic/transport 8.4
composer require elasticsearch/elasticsearch ^8.4

本测试环境： php8.0 laravel9 composer2.2.8

添加配置文件：

添加配置文件：
config/database.php 里面加上如下配置：//es 配置'elastic'=>['hosts' => explode(',',env('ELASTIC_HOST')),]

env 添加配置：ELASTIC_HOST=http://127.0.0.1:9200

创建服务提供者：EsServiceProvider.php

<?phpnamespace App\Providers;use Elastic\Elasticsearch\ClientBuilder;
use Illuminate\Support\ServiceProvider;class EsServiceProvider extends ServiceProvider
{/*** Register any application services.** @return void*/public function register(){$this->app->singleton('Es',function (){// 从配置文件读取 Elasticsearch 服务器列表$builder = ClientBuilder::create()->setHosts(config('database.elastic.hosts'));// 如果是开发环境if (app()->environment()==='local'){// 配置日志，Elasticsearch 的请求和返回数据将打印到日志文件中，方便我们调试$builder->setLogger(app('log')->driver());}return $builder->build();});}/*** Bootstrap any application services.** @return void*/public function boot(){//}
}

注册服务提供者：

config/app.php 里面加上刚才的服务提供者：

 App\Providers\EsServiceProvider::class, //es 搜索

使用：

//查询$params = ['index' => 'laravel','type' => 'sys_test','id' => 2
];$response = app('Es')->get($params);
dd($response->asArray());//更新$params = ['index' => 'laravel','type' => 'sys_test','id' => 2,'body' => ['doc' => ['name' => 'liceshi']]
];
$response = app('Es')->update($params);
dd($response->getContents());