今日目標(biāo)
Elasticsearch 和 elasticsearch-head的安裝配置和在PHP-Laravel項(xiàng)目中集成
1.ES版本的選擇
在使用ES前盏道,我們首先要選擇一個(gè)合適的版本,選擇最新的版本永遠(yuǎn)是一個(gè)不會(huì)錯(cuò)的選擇大莫,目前ES官網(wǎng)最新版本是8.0.0-alpha2桑李,發(fā)布于September 17, 2021(2021/9/17),屬于內(nèi)部測(cè)試版,距今只有一個(gè)月時(shí)間蜒犯,由于網(wǎng)絡(luò)上關(guān)于其使用說明較少且可能沒有相對(duì)應(yīng)的php擴(kuò)展包,不太利于學(xué)習(xí)荞膘,故我們可以選擇7.x版本進(jìn)行學(xué)習(xí)愧薛。7.15.1是最新的Release版本,發(fā)布于2021/10/15衫画,距今只有幾天時(shí)間毫炉,所有選擇7.15.1進(jìn)行學(xué)習(xí)是最佳的。
2.ES的下載安裝
我本地調(diào)試學(xué)習(xí)一般使用的是Windows系統(tǒng)削罩,生產(chǎn)環(huán)境使用的是Linux瞄勾,所以這里兩種操作系統(tǒng)下ES的下載安裝都會(huì)用到。
官網(wǎng)下載鏈接:https://www.elastic.co/cn/downloads/elasticsearch#ga-release (屬于中國(guó)節(jié)點(diǎn)弥激,下載速度很快进陡,3分鐘左右就可以下載完成)
Windows下:
選擇windows版本進(jìn)行下載,解壓elasticsearch-7.15.1-windows-x86_64.zip微服,雙擊運(yùn)行bin目錄下的elasticsearch.bat(殺毒軟件可能會(huì)進(jìn)行攔截趾疚,允許即可)
Linux下
mkdir /usr/local/software/es
cd /usr/local/software/es
curl -L -O https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.15.1-linux-x86_64.tar.gz
tar -xvf elasticsearch-7.15.1-darwin-x86_64.tar.gz
./elasticsearch-7.15.1-darwin-x86_64/bin/elasticsearch
檢測(cè)安裝:
命令行提示信息中如果出現(xiàn) publish_address {127.0.0.1:9200}, bound_addresses {127.0.0.1:9200}, {[::1]:9200}則表示安裝成功,或直接訪問 http://localhost:9200 查看es具體信息
{
"name" : "PS2019WRLCRMZY",
"cluster_name" : "elasticsearch",
"cluster_uuid" : "LcZNPNroRDOdQ8f6hkw12Q",
"version" : {
"number" : "7.15.1",
"build_flavor" : "default",
"build_type" : "zip",
"build_hash" : "83c34f456ae29d60e94d886e455e6a3409bba9ed",
"build_date" : "2021-10-07T21:56:19.031608185Z",
"build_snapshot" : false,
"lucene_version" : "8.9.0",
"minimum_wire_compatibility_version" : "6.8.0",
"minimum_index_compatibility_version" : "6.0.0-beta1"
},
"tagline" : "You Know, for Search"
}
3.ES配置文件
解決CORS
找到config文件夾下的elasticsearch.yml以蕴,在文件的末尾添加如下內(nèi)容:
http.cors.enabled: true
http.cors.allow-origin: "*"
4.安裝ES可視化插件elasticsearch-head
elasticsearch-head是用于監(jiān)控 Elasticsearch 狀態(tài)的客戶端插件糙麦,包括數(shù)據(jù)可視化、執(zhí)行增刪改查操作等
安裝node.js
下載地址:https://nodejs.org/en/download/ 根據(jù)自己系統(tǒng)下載相應(yīng)的msi丛肮,雙擊安裝赡磅。安裝head插件
https://github.com/mobz/elasticsearch-head 下載zip文件
解壓至es目錄修改配置 解決跨域
elasticsearch-head-master\Gruntfile.js 97行左右新增 hostname: '*',
connect: {
server: {
options: {
hostname: '*',
port: 9100,
base: '.',
keepalive: true
}
}
}
- elasticsearch-head-master_site\app.js 3795行左右新增 || "http://localhost:9200";
_node_handler: function(data) {
if(data) {
this.prefs.set("app-base_uri", this.cluster.base_uri) || "http://localhost:9200";
if(data.version && data.version.number)
this.cluster.setVersion(data.version.number);
}
},
elasticsearch-head-master\package.json "license": "Apache2" => "license": "Apache-2.0",
運(yùn)行
-
es/es-head目錄下運(yùn)行
- npm install
- npm run start(以后每次),如果還不成功宝与,再執(zhí)行一次npm install
-
瀏覽器中運(yùn)行http://localhost:9100/
5.ES集群健康值
正常情況下焚廊,Elasticsearch 集群健康狀態(tài)分為三種:
green 最健康得狀態(tài)冶匹,說明所有的分片包括備份都可用; 這種情況Elasticsearch集群所有的主分片和副本分片都已分配, Elasticsearch集群是 100% 可用的。
yellow 基本的分片可用咆瘟,但是備份不可用(或者是沒有備份); 這種情況Elasticsearch集群所有的主分片已經(jīng)分片了嚼隘,但至少還有一個(gè)副本是缺失的。不會(huì)有數(shù)據(jù)丟失袒餐,所以搜索結(jié)果依然是完整的飞蛹。不過,你的高可用性在某種程度上被弱化匿乃。如果 更多的 分片消失桩皿,你就會(huì)丟數(shù)據(jù)了。把 yellow 想象成一個(gè)需要及時(shí)調(diào)查的警告幢炸。
red 部分的分片可用泄隔,表明分片有一部分損壞。此時(shí)執(zhí)行查詢部分?jǐn)?shù)據(jù)仍然可以查到宛徊,遇到這種情況佛嬉,還是趕快解決比較好; 這種情況Elasticsearch集群至少一個(gè)主分片(以及它的全部副本)都在缺失中。這意味著你在缺少數(shù)據(jù):搜索只能返回部分?jǐn)?shù)據(jù)闸天,而分配到這個(gè)分片上的寫入請(qǐng)求會(huì)返回一個(gè)異常暖呕。
遇到的問題和解決
在擴(kuò)展包的選擇上,今天遇到了一些問題苞氮,比如選了排名第一的 elasticsearch-php湾揽,但是composer安裝后發(fā)現(xiàn)其并沒有提供相對(duì)應(yīng)的config文件進(jìn)行配置,不是很友好笼吟,所以在對(duì)類庫(kù)封裝api的使用上库物,我們可以也封裝幾個(gè)相對(duì)應(yīng)的方法或者將類的實(shí)例化進(jìn)行封裝,以便于日后可能需要更換其他類庫(kù)時(shí)而產(chǎn)生的代碼大面積修改贷帮。
Ps:最后是通過laravel的容器注入實(shí)現(xiàn)了配置文件的手動(dòng)配置和es的單例實(shí)例化
明日目標(biāo)
Elasticsearch-PHP基本API使用
總結(jié)
到這里我們的Elasticsearch的安裝配置和簡(jiǎn)單使用就完成戚揭,我們可以將index設(shè)為數(shù)據(jù)庫(kù),type設(shè)為表名撵枢,來對(duì)數(shù)據(jù)表進(jìn)行索引管理民晒。