es环境安装及php对接使用

news2025/2/22 10:06:51

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 为false
      xpack.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-driver

composer 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里面。

创建一个模型：


<?php

namespace 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

<?php

namespace 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());