Elasticsearch-PHP基本API使用教程

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

下载安装Elasticsearch-PHP
下载Elasticsearch-PHP的话。你可以直接去GitHub上下载，也可以通过Composer包管理工具直接下载。这里我是通过Composer包管理工具直接下载，所以此时我们需要安装Composer，其实很简单的

，可以参考composer详细安装教程。
安装好Composer之后就可以进行Elasticsearch-PHP的下载了。
首先我们在服务器根目录下创建一个elasticphp文件夹，在该文件夹中创建一个composer.json文件，内容如下：

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

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



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



接下来我们可以在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安装成功：




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