網(wǎng)上很多關(guān)于ES的例子都過時(shí)了,版本很老,這篇文章的測試環(huán)境是ES6.5
通過composer安裝
composer require 'elasticsearch/elasticsearch'
在代碼中引入
require 'vendor/autoload.php'; use Elasticsearch\ClientBuilder; $client = ClientBuilder::create()->setHosts(['172.16.55.53'])->build();
下面循序漸進(jìn)完成一個簡單的添加和搜索的功能。
首先要新建一個index:
index對應(yīng)關(guān)系型數(shù)據(jù)(以下簡稱MySQL)里面的數(shù)據(jù)庫,而不是對應(yīng)MySQL里面的索引,這點(diǎn)要清楚
$params = [ 'index' => 'myindex', #index的名字不能是大寫和下劃線開頭 'body' => [ 'settings' => [ 'number_of_shards' => 2, 'number_of_replicas' => 0 ] ] ]; $client->indices()->create($params);
在MySQL里面,光有了數(shù)據(jù)庫還不行,還需要建立表,ES也是一樣的,ES中的type對應(yīng)MySQL里面的表。
注意:ES6以前,一個index有多個type,就像MySQL中一個數(shù)據(jù)庫有多個表一樣自然,但是ES6以后,每個index只允許一個type,在往以后的版本中很可能會取消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í)候,可以看出每個字段可以定義單獨(dú)的類型,在first_name中還自定義了分詞器 ik,
這個分詞器是一個插件,需要單獨(dú)安裝的,參考另一篇文章:ElasticSearch基本嘗試
現(xiàn)在數(shù)據(jù)庫和表都有了,可以往里面插入數(shù)據(jù)了
概念:這里的 數(shù)據(jù) 在ES中叫文檔
$params = [ 'index' => 'myindex', 'type' => 'mytype', //'id' => 1, #可以手動指定id,也可以不指定隨機(jī)生成 'body' => [ 'first_name' => '張', 'last_name' => '三', 'age' => 35 ] ]; $client->index($params);
多插入一點(diǎn)數(shù)據(jù),然后來看看怎么把數(shù)據(jù)取出來:
通過id取出單條數(shù)據(jù):
插曲:如果你之前添加文檔的時(shí)候沒有傳入id,ES會隨機(jī)生成一個id,這個時(shí)候怎么通過id查?id是多少都不知道啊。
所以這個插入一個簡單的搜索,最簡單的,一個搜索條件都不要,返回所有index下所有文檔:
$data = $client->search();
現(xiàn)在可以去找一找id了,不過你會發(fā)現(xiàn)id可能長這樣:zU65WWgBVD80YaV8iVMk,不要驚訝,這是ES隨機(jī)生成的。
現(xiàn)在可以通過id查找指定文檔了:
$params = [ 'index' => 'myindex', 'type' => 'mytype', 'id' =>'zU65WWgBVD80YaV8iVMk' ]; $data = $client->get($params);
最后一個稍微麻煩點(diǎn)的功能:
注意:這個例子我不打算在此詳細(xì)解釋,看不懂沒關(guān)系,這篇文章主要的目的是基本用法,并沒有涉及到ES的精髓地方,
ES精髓的地方就在于搜索,后面的文章我會繼續(xù)深入分析
$query = [ 'query' => [ 'bool' => [ 'must' => [ 'match' => [ 'first_name' => '張', ] ], 'filter' => [ 'range' => [ 'age' => ['gt' => 76] ] ] ] ] ]; $params = [ 'index' => 'myindex', // 'index' => 'm*', #index 和 type 是可以模糊匹配的,甚至這兩個參數(shù)都是可選的 'type' => 'mytype', '_source' => ['first_name','age'], // 請求指定的字段 'body' => array_merge([ 'from' => 0, 'size' => 5 ],$query) ]; $data = $this->EsClient->search($params);
上面的是一個簡單的使用流程,但是不夠完整,只講了添加文檔,沒有說怎么刪除文檔,
下面我貼出完整的測試代碼,基于Laravel環(huán)境,當(dāng)然環(huán)境只影響運(yùn)行,不影響理解,包含基本的常用操作:
?php use Elasticsearch\ClientBuilder; use Faker\Generator as Faker; /** * ES 的 php 實(shí)測代碼 */ class EsDemo { private $EsClient = null; private $faker = null; /** * 為了簡化測試,本測試默認(rèn)只操作一個Index,一個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(); /** * 這是一個數(shù)據(jù)生成庫,詳細(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) ]); } } /** * 刪除一個文檔 * @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 是可以模糊匹配的,甚至這兩個參數(shù)都是可選的 'type' => $this->type, '_source' => ['first_name','age'], // 請求指定的字段 '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, 'type' => $this->type, 'body' => ['ids' => $ids] ]; return $this->EsClient->mget($params); } /** * 獲取單個文檔 * @param $id * @return array */ public function getDoc($id) { $params = [ 'index' => $this->index, 'type' => $this->type, 'id' =>$id ]; return $this->EsClient->get($params); } /** * 更新一個文檔 * @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); } /** * 添加一個文檔到 Index 的Type中 * @param array $body * @return void */ public function putDoc($body = []) { $params = [ 'index' => $this->index, 'type' => $this->type, // 'id' => 1, #可以手動指定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)建一個索引 Index (非關(guān)系型數(shù)據(jù)庫里面那個索引,而是關(guān)系型數(shù)據(jù)里面的數(shù)據(jù)庫的意思) * @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); } /** * 創(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)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
標(biāo)簽:白城 鶴崗 克拉瑪依 六安 遼陽 唐山 鷹潭 柳州
巨人網(wǎng)絡(luò)通訊聲明:本文標(biāo)題《PHP中使用ElasticSearch最新實(shí)例講解》,本文關(guān)鍵詞 PHP,中,使用,ElasticSearch,最新,;如發(fā)現(xiàn)本文內(nèi)容存在版權(quán)問題,煩請?zhí)峁┫嚓P(guān)信息告之我們,我們將及時(shí)溝通與處理。本站內(nèi)容系統(tǒng)采集于網(wǎng)絡(luò),涉及言論、版權(quán)與本站無關(guān)。