Elasticsearch-PHP基本API使用教程

ゝ一纸荒年。 2022-07-13 03:27 226阅读 0赞

**前言**

Elasticsearch-PHP是PHP连接Elasticsearch库的扩展，是用PHP语言开发的，类似于PHP通过Predis操作redis库的功能。如果想详细了解Elasticsearch的话，可以下载[《Elasticsearch权威指南（中文版）.pdf》][Elasticsearch_.pdf]。

**下载安装Elasticsearch-PHP**

下载Elasticsearch-PHP的话。你可以直接去GitHub上[下载][Link 1]，也可以通过Composer包管理工具直接下载。这里我是通过Composer包管理工具直接下载，所以此时我们需要安装Composer，其实很简单的![微笑][smile.gif]，可以参考[composer详细安装教程][composer]。

安装好Composer之后就可以进行Elasticsearch-PHP的下载了。

首先我们在服务器根目录下创建一个elasticphp文件夹，在该文件夹中创建一个composer.json文件，内容如下：

{
        "require": {
            "elasticsearch/elasticsearch": "2.2.1"
        }
    }

然后启动Windows命令窗口cmd，进入到elasticphp目录下，运行：composer  update   命令。如下图所示：

![Center][]

在这个下载过程中可能需要等待一段时间，下载完后再elasticphp目录下会出现vender目录文件，如下图所示：

![Center 1][]

接下来我们可以在elasticphp目录下创建一个index.php文件，内容如下：

require 'vendor/autoload.php';    //加载自动加载文件
    
    #如果没有设置主机地址默认为127.0.0.1:9200
    $client = Elasticsearch\ClientBuilder::create()->setHosts(['localhost:9200'])->build();
    var_dump($client);

如果出现如下图所示，表示连接Elasticsearch服务成功，也即Elasticsearch-PHP安装成功：

![Center 2][]

**PHP通过Elasticsearch-PHP操作Elasticsearch库**

> PHP使用Elasticsearch-PHP的要求：
> 
>  *  PHP的版本在5.3以上，我的版本是PHP5.5。  
>     
>  *  在php.ini中开启curl和openssl扩展
> 
>   
> 
> 
> 一、通过设置mapping结构创建一个索引库（相当于mysql创建一个数据库）
> 
>     require 'vendor/autoload.php';    //加载自动加载文件
>     
>     #如果没有设置主机地址默认为127.0.0.1:9200
>     $client = Elasticsearch\ClientBuilder::create()->setHosts(['localhost:9200'])->build();
>     
>     /**
>     * 创建库索引的mapping结构
>     */
>     $params = [
>     	'index' => 'my_index',  //索引名（相当于mysql的数据库）
>     	'body' => [
>     		'settings' => [
>     			'number_of_shards' => 5,  #分片数
>     		],
>     		'mappings' => [ 
>     			'my_type' => [ //类型名（相当于mysql的表）
>     				'_all' => [
>     					'enabled' => 'false'
>     				],
>     				'_routing' => [
>     					'required' => 'true'
>     				],
>     				'properties' => [ //文档类型设置（相当于mysql的数据类型）
>     					'name' => [
>     						'type' => 'string',
>     						'store' => 'true'
>     					],
>     					'age' => [
>     						'type' => 'integer'
>     					]
>     				]
>     			]
>     		]
>     	]
>     ];
>     
>     $res = $client->indices()->create($params);   //创建库索引
> 
>   
> 二、库索引操作
> 
>     require 'vendor/autoload.php';    //加载自动加载文件
>     
>     #如果没有设置主机地址默认为127.0.0.1:9200
>     $client = Elasticsearch\ClientBuilder::create()->setHosts(['localhost:9200'])->build();
>     
>     /**
>     * 库索引操作
>     */
>     $params = [
>     	'index' => 'my_index-0',
>     	'client' => [
>     		'ignore' => 404
>     	]
>     ];
>     $res = $client->indices()->delete($params);    //删除库索引
>     $res = $client->indices()->getSettings($params);//获取库索引设置信息
>     $res = $client->indices()->exists($params);   //检测库是否存在
>     $res = $client->indices()->getMapping($params);   //获取mapping信息
> 
>   
> 三、文档操作
> 
>     /**
>     * 获取指定文档
>     */
>     $params = [
>     	'index' => 'my_index',
>     	'type' => 'my_type',
>     	'id' => '3416a75f4cea9109507cacd8e2f2aefc'
>     ];
>     $res = $client->get($params);   //获取指定的文档
>     $res = $client->getSource($params);   //获取指定文档的sourse内容（即字段的信息）
>     
>      //删除指定的文档
>     $res = $client->delete($params); 
>     
>     
>     /**
>     * 更新指定文档
>     */
>     $params = [
>         'index' => 'my_index',
>         'type' => 'my_type',
>         'id' => '3416a75f4cea9109507cacd8e2f2aefc',
>         'body' => [
>             'doc' => [
>                 'age' => 150
>             ]
>         ]
>     ];
>     
>     $res = $client->update($params);
>     
>     
>     /**
>     * 文档查询
>     */
>     $params = [
>         'index' =>  'my_index',   //['my_index1', 'my_index2'],可以通过这种形式进行跨库查询
>         'type' => 'my_type',//['my_type1', 'my_type2'],
>         'body' => [
>             'query' => [
>                 'match' => [
>                     'age' => '24'
>                 ]
>             ],
>             'from' => '0',
>             'size' => '200'
>     		'sort' => [
>     			'age' => 'desc'   //对age字段进行降序排序
>     		]
>         ]
>     ];
>     
>     $res = $client->search($params);
> 
>   
>   
> 
> 
> 更多信息参考https://www.elastic.co/guide/en/elasticsearch/client/php-api/current/\_overview.html

[Elasticsearch_.pdf]: http://download.csdn.net/detail/u014236259/9714127
[Link 1]: https://github.com/elastic/elasticsearch
[smile.gif]: http://static.blog.csdn.net/xheditor/xheditor_emot/default/smile.gif
[composer]: /images/20220713/1076d69fb82947b094d87b107eb6033b.png
[Center]: /images/20220713/82d5f0f8a9a2485b971c96670a93f0ca.png
[Center 1]: /images/20220713/eb6a818635fd49628478d3cf9c6284e3.png
[Center 2]: /images/20220713/f6842e097dd54a5f883788f89efd42a6.png