網(wǎng)上很多關(guān)于ES的例子都過(guò)時(shí)了,版本很老,這篇文章的測(cè)試環(huán)境是ES6.5
通過(guò)composer安裝
composer require 'elasticsearch/elasticsearch'
在代碼中引入
require 'vendor/autoload.php';
use Elasticsearch\ClientBuilder;
$client = ClientBuilder::create()->setHosts(['172.16.55.53'])->build();
下面循序漸進(jìn)完成一個(gè)簡(jiǎn)單的添加和搜索的功能。
首先要新建一個(gè)index:
index對(duì)應(yīng)關(guān)系型數(shù)據(jù)(以下簡(jiǎn)稱(chēng)MySQL)里面的數(shù)據(jù)庫(kù),而不是對(duì)應(yīng)MySQL里面的索引,這點(diǎn)要清楚
$params = [
'index' => 'myindex', #index的名字不能是大寫(xiě)和下劃線開(kāi)頭
'body' => [
'settings' => [
'number_of_shards' => 2,
'number_of_replicas' => 0
]
]
];
$client->indices()->create($params);
在MySQL里面,光有了數(shù)據(jù)庫(kù)還不行,還需要建立表,ES也是一樣的,ES中的type對(duì)應(yīng)MySQL里面的表。
注意:ES6以前,一個(gè)index有多個(gè)type,就像MySQL中一個(gè)數(shù)據(jù)庫(kù)有多個(gè)表一樣自然,但是ES6以后,每個(gè)index只允許一個(gè)type,在往以后的版本中很可能會(huì)取消type。
type不是單獨(dú)定義的,而是和字段一起定義
$params = [
'index' => 'myindex',
'type' => 'mytype',
'body' => [
'mytype' => [
'_source' => [
'enabled' => true
],
'properties' => [
'id' => [
'type' => 'integer'
],
'first_name' => [
'type' => 'text',
'analyzer' => 'ik_max_word'
],
'last_name' => [
'type' => 'text',
'analyzer' => 'ik_max_word'
],
'age' => [
'type' => 'integer'
]
]
]
]
];
$client->indices()->putMapping($params);
在定義字段的時(shí)候,可以看出每個(gè)字段可以定義單獨(dú)的類(lèi)型,在first_name中還自定義了分詞器 ik,
這個(gè)分詞器是一個(gè)插件,需要單獨(dú)安裝的,參考另一篇文章:ElasticSearch基本嘗試
現(xiàn)在數(shù)據(jù)庫(kù)和表都有了,可以往里面插入數(shù)據(jù)了
概念:這里的 數(shù)據(jù) 在ES中叫文檔
$params = [
'index' => 'myindex',
'type' => 'mytype',
//'id' => 1, #可以手動(dòng)指定id,也可以不指定隨機(jī)生成
'body' => [
'first_name' => '張',
'last_name' => '三',
'age' => 35
]
];
$client->index($params);
多插入一點(diǎn)數(shù)據(jù),然后來(lái)看看怎么把數(shù)據(jù)取出來(lái):
通過(guò)id取出單條數(shù)據(jù):
插曲:如果你之前添加文檔的時(shí)候沒(méi)有傳入id,ES會(huì)隨機(jī)生成一個(gè)id,這個(gè)時(shí)候怎么通過(guò)id查?id是多少都不知道啊。
所以這個(gè)插入一個(gè)簡(jiǎn)單的搜索,最簡(jiǎn)單的,一個(gè)搜索條件都不要,返回所有index下所有文檔:
$data = $client->search();
現(xiàn)在可以去找一找id了,不過(guò)你會(huì)發(fā)現(xiàn)id可能長(zhǎng)這樣:zU65WWgBVD80YaV8iVMk,不要驚訝,這是ES隨機(jī)生成的。
現(xiàn)在可以通過(guò)id查找指定文檔了:
$params = [
'index' => 'myindex',
'type' => 'mytype',
'id' =>'zU65WWgBVD80YaV8iVMk'
];
$data = $client->get($params);
最后一個(gè)稍微麻煩點(diǎn)的功能:
注意:這個(gè)例子我不打算在此詳細(xì)解釋?zhuān)床欢疀](méi)關(guān)系,這篇文章主要的目的是基本用法,并沒(méi)有涉及到ES的精髓地方,
ES精髓的地方就在于搜索,后面的文章我會(huì)繼續(xù)深入分析
$query = [
'query' => [
'bool' => [
'must' => [
'match' => [
'first_name' => '張',
]
],
'filter' => [
'range' => [
'age' => ['gt' => 76]
]
]
]
]
];
$params = [
'index' => 'myindex',
// 'index' => 'm*', #index 和 type 是可以模糊匹配的,甚至這兩個(gè)參數(shù)都是可選的
'type' => 'mytype',
'_source' => ['first_name','age'], // 請(qǐng)求指定的字段
'body' => array_merge([
'from' => 0,
'size' => 5
],$query)
];
$data = $this->EsClient->search($params);
上面的是一個(gè)簡(jiǎn)單的使用流程,但是不夠完整,只講了添加文檔,沒(méi)有說(shuō)怎么刪除文檔,
下面我貼出完整的測(cè)試代碼,基于Laravel環(huán)境,當(dāng)然環(huán)境只影響運(yùn)行,不影響理解,包含基本的常用操作:
?php
use Elasticsearch\ClientBuilder;
use Faker\Generator as Faker;
/**
* ES 的 php 實(shí)測(cè)代碼
*/
class EsDemo {
private $EsClient = null;
private $faker = null;
/**
* 為了簡(jiǎn)化測(cè)試,本測(cè)試默認(rèn)只操作一個(gè)Index,一個(gè)Type,
* 所以這里固定為 megacorp和employee
*/
private $index = 'megacorp';
private $type = 'employee';
public function __construct(Faker $faker) {
/**
* 實(shí)例化 ES 客戶端
*/
$this->EsClient = ClientBuilder::create()->setHosts(['172.16.55.53'])->build();
/**
* 這是一個(gè)數(shù)據(jù)生成庫(kù),詳細(xì)信息可以參考網(wǎng)絡(luò)
*/
$this->faker = $faker;
}
/**
* 批量生成文檔
* @param $num
*/
public function generateDoc($num = 100) {
foreach (range(1,$num) as $item) {
$this->putDoc([
'first_name' => $this->faker->name,
'last_name' => $this->faker->name,
'age' => $this->faker->numberBetween(20,80)
]);
}
}
/**
* 刪除一個(gè)文檔
* @param $id
* @return array
*/
public function delDoc($id) {
$params = [
'index' => $this->index,
'type' => $this->type,
'id' =>$id
];
return $this->EsClient->delete($params);
}
/**
* 搜索文檔,query是查詢條件
* @param array $query
* @param int $from
* @param int $size
* @return array
*/
public function search($query = [], $from = 0, $size = 5) {
// $query = [
// 'query' => [
// 'bool' => [
// 'must' => [
// 'match' => [
// 'first_name' => 'Cronin',
// ]
// ],
// 'filter' => [
// 'range' => [
// 'age' => ['gt' => 76]
// ]
// ]
// ]
//
// ]
// ];
$params = [
'index' => $this->index,
// 'index' => 'm*', #index 和 type 是可以模糊匹配的,甚至這兩個(gè)參數(shù)都是可選的
'type' => $this->type,
'_source' => ['first_name','age'], // 請(qǐng)求指定的字段
'body' => array_merge([
'from' => $from,
'size' => $size
],$query)
];
return $this->EsClient->search($params);
}
/**
* 一次獲取多個(gè)文檔
* @param $ids
* @return array
*/
public function getDocs($ids) {
$params = [
'index' => $this->index,
'type' => $this->type,
'body' => ['ids' => $ids]
];
return $this->EsClient->mget($params);
}
/**
* 獲取單個(gè)文檔
* @param $id
* @return array
*/
public function getDoc($id) {
$params = [
'index' => $this->index,
'type' => $this->type,
'id' =>$id
];
return $this->EsClient->get($params);
}
/**
* 更新一個(gè)文檔
* @param $id
* @return array
*/
public function updateDoc($id) {
$params = [
'index' => $this->index,
'type' => $this->type,
'id' =>$id,
'body' => [
'doc' => [
'first_name' => '張',
'last_name' => '三',
'age' => 99
]
]
];
return $this->EsClient->update($params);
}
/**
* 添加一個(gè)文檔到 Index 的Type中
* @param array $body
* @return void
*/
public function putDoc($body = []) {
$params = [
'index' => $this->index,
'type' => $this->type,
// 'id' => 1, #可以手動(dòng)指定id,也可以不指定隨機(jī)生成
'body' => $body
];
$this->EsClient->index($params);
}
/**
* 刪除所有的 Index
*/
public function delAllIndex() {
$indexList = $this->esStatus()['indices'];
foreach ($indexList as $item => $index) {
$this->delIndex();
}
}
/**
* 獲取 ES 的狀態(tài)信息,包括index 列表
* @return array
*/
public function esStatus() {
return $this->EsClient->indices()->stats();
}
/**
* 創(chuàng)建一個(gè)索引 Index (非關(guān)系型數(shù)據(jù)庫(kù)里面那個(gè)索引,而是關(guān)系型數(shù)據(jù)里面的數(shù)據(jù)庫(kù)的意思)
* @return void
*/
public function createIndex() {
$this->delIndex();
$params = [
'index' => $this->index,
'body' => [
'settings' => [
'number_of_shards' => 2,
'number_of_replicas' => 0
]
]
];
$this->EsClient->indices()->create($params);
}
/**
* 檢查Index 是否存在
* @return bool
*/
public function checkIndexExists() {
$params = [
'index' => $this->index
];
return $this->EsClient->indices()->exists($params);
}
/**
* 刪除一個(gè)Index
* @return void
*/
public function delIndex() {
$params = [
'index' => $this->index
];
if ($this->checkIndexExists()) {
$this->EsClient->indices()->delete($params);
}
}
/**
* 獲取Index的文檔模板信息
* @return array
*/
public function getMapping() {
$params = [
'index' => $this->index
];
return $this->EsClient->indices()->getMapping($params);
}
/**
* 創(chuàng)建文檔模板
* @return void
*/
public function createMapping() {
$this->createIndex();
$params = [
'index' => $this->index,
'type' => $this->type,
'body' => [
$this->type => [
'_source' => [
'enabled' => true
],
'properties' => [
'id' => [
'type' => 'integer'
],
'first_name' => [
'type' => 'text',
'analyzer' => 'ik_max_word'
],
'last_name' => [
'type' => 'text',
'analyzer' => 'ik_max_word'
],
'age' => [
'type' => 'integer'
]
]
]
]
];
$this->EsClient->indices()->putMapping($params);
$this->generateDoc();
}
}
到此這篇關(guān)于PHP中使用ElasticSearch最新實(shí)例講解的文章就介紹到這了,更多相關(guān)PHP中使用ElasticSearch最內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
您可能感興趣的文章:- 時(shí)間輕松學(xué)會(huì).NET Core操作ElasticSearch7的方法
- Java調(diào)用elasticsearch本地代碼的操作方法
- 使用elasticsearch定時(shí)刪除索引數(shù)據(jù)
- Elasticsearch工具cerebro的安裝與使用教程
- Java elasticSearch-api的具體操作步驟講解