PHP中使用ElasticSearch最新例項講解
阿新 • • 發佈：2021-03-20
網上很多關於ES的例子都過時了，版本很老，這篇文章的測試環境是ES6.5
通過composer安裝
composer require 'elasticsearch/elasticsearch'
在程式碼中引入
require 'vendor/autoload.php'; use Elasticsearch\ClientBuilder; $client = ClientBuilder::create()->setHosts(['172.16.55.53'])->build();
下面循序漸進完成一個簡單的新增和搜尋的功能。
首先要新建一個index：
index對應關係型資料（以下簡稱 mysql）裡面的資料庫，而不是對應MySQL裡面的索引，這點要清楚
$params = [
'index' => 'myindex',#index的名字不能是大寫和下劃線開頭
'body' => [
'settings' => [
'number_of_shards' => 2,'number_of_replicas' => 0
]
]
];
$client->indices()->create($params);
在MySQL裡面，光有了資料庫還不行，還需要建立表，ES也是一樣的，ES中的type對應MySQL裡面的表。
注意：ES6以前，一個index有多個type,就像MySQL中一個數據庫有多個表一樣自然，但是ES6以後，每個index只允許一個type,在往以後的版本中很可能會取消type。
type不是單獨定義的，而是和欄位一起定義
$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','age' => [
'type' => 'integer'
]
]
]
]
];
$client->indices()->putMapping($params);在定義欄位的時候，可以看出每個欄位可以定義單獨的型別，在first_name中還自定義了分詞器 ik,
這個分詞器是一個外掛，需要單獨安裝的，參考另一篇文章：ElasticSearch基本嘗試
現在資料庫和表都有了，可以往裡面插入資料了
概念：這裡的 資料 在ES中叫文件
$params = [
'index' => 'myindex',//'id' => 1,#可以手動指定id，也可以不指定隨機生成
'body' => [
'first_name' => '張','lastDdoPxe_name' => '三','age' => 35
]
];
$client->index($params);
多插入一點資料，然後來看看怎麼把資料取出來：
通過id取出單條資料：
插曲：如果你之前新增文件的時候沒有傳入id，ES會隨機生成一個id，這個時候怎麼通過id查？id是多少都不知道啊。
所以這個插入一個簡單的搜尋，最簡單的，一個搜尋條件都不要，返回所有index下所有文件：
$data = $client->search();
現在可以去找一找id了，不過你會發現id可能長這樣：zU65WWgBVD80YaV8iVMk，不要驚訝，這是ES隨機生成的。
現在可以通過id查詢指定文件了：
$params = [ 'index' => 'myindex','id' =>'zU65WWgBVD80YaV8iVMk' ]; $data = $client->get($params);
最後一個稍微麻煩點的功能：
注意：這個例子我不打算在此詳細解釋，看不懂沒關係，這篇文章主要的目的是基本用法，並沒有涉及到ES的精髓地方，
ES精髓的地方就在於搜尋，後面的文章我會繼續深入分析
$query = [
'query' => [
'bool' => [
'must' => [
'match' => [
'first_name' => '張DdoPxe',]
],'filter' => [
'range' => [
'age' => ['gt' => 76]
]
]
]
]
];
$params = [
'www.cppcns.comindex' => 'myindex',// 'index' => 'm*',#index 和 type 是可以模糊匹配的，甚至這兩個引數都是可選的
'type' => 'mytype','_source' => ['first_name','age'],// 請求指定的欄位
'body' => array_merge([
'from' => 0,'size' => 5
],$query)
];
$data = $this->EsClient->search($params);
上面的是一個簡單的使用流程，但是不夠完整，只講了新增文件，沒有說怎麼刪除文件，
下面我貼出完整的測試程式碼，基於Laravel環境，當然環境隻影響執行，不影響理解，包含基本的常用操作：
<?php
use Elasticsearch\ClientBuilder;
use Faker\Generator as Faker;
/**
* ES 的 php 實測程式碼
*/
class EsDemo {
private $EsClient = null;
private $faker = null;
/**
* 為了簡化測試，本測試預設只操作一個Index，一個Type，
* 所以這裡固定為 megacorp和employee
*/
private $index = 'megacorp';
private $type = 'employee';
public function __construct(Faker $faker) {
/**
* 例項化 ES 客戶端
*/
$this->EsClient = ClientBuilder::create()->setHosts(['172.16.55.53'])->build();
/**
* 這是一個數據生成庫，詳細資訊可以參考網路
*/
$this->faker = $faker;
}
/**
* 批量生成文件
* @param $num
*/
public function generateDoc($nu程式設計客棧m = 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)
]);
}
}
/**
* 刪除一個文件
* @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 和 type 是可以模糊匹配的，甚至這兩個引數都是可選的
'type' => $this->type,// 請求指定的欄位
'body' => array_merge([
'from' => $from,'size' => $size
],$query)
];
return $this->EsClient->search($params);
}
/**
* 一次獲取多個文件
* @param $ids
* @return array
*/
public function getDocs($ids) {
$params = [
'index' => $this->index,'body' => ['ids' => $ids]
];
return $this->EsClient->mget($params);
}
/**
* 獲取單個文件
* @param $id
* @return array
*/
public function getDoc($id) {
$params = [
'index' => $this->index,'id' =>$id
];
return $this->EsClient->get($params);
}
/**
* 更新一個文件
* @param $id
* @return array
*/
public function updateDoc($id) {
$params = [
'index' => $this->index,'id' =>$id,'body' => [
'doc' => [
'first_name' => '張','last_name' => '三','age' => 99
]
]
];
return $this->EsClient->update($params);
}
/**
* 新增一個文件到 Index 的Type中
* @param array $body
* @return void
*/
public function putDoc($body = []) {
$params = [
'index' => $this->index,// 'id' => 1,#可以手動指定id，也可以不指定隨機生成
'body' => $body
];
$this->EsClient->index($params);
}
/**
* 刪除所有的 Index
*/
public function delAllIndex() {
$indexList = $this->esStatus()['indices'];
foreach ($indexList as $item => $index) {
$this->delIndex();
}
}
/**
* 獲取 ES 的狀態資訊，包括index 列表
* @return array
*/
public function esStatus() {
return $this->EsClient->indices()->stats();
}
/**
* 建立一個索引 Index （非關係型資料庫裡面那個索引，而是關係型資料裡面的資料庫的意思）
* @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);
}
/**
* 刪除一個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);
}
/**
* 建立文件模板
* @return void
*/
public function createMapping() {
$this->createIndex();
$params = [
'index' => $this->index,'body' => [
$this->type => [
'_source' => [
'enabled' => true
],'properties' => [
'id' => [
'type' => 'integer'
],'first_name' =>程式設計客棧; [
'type' => 'text','analyzer' => 'ik_max_word'
],'last_name' => [
'type' => 'text','age' => [
'type' => 'integer'
]
]
]
]
];
$this->EsClient->indices()->putMapping($params);
$this->generateDoc();
}
}
到此這篇關於PHP中使用ElasticSearch最新例項講解的文章就介紹到這了,更多相關PHP中使用ElasticSearch最內容請搜尋我們以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援我們！