今日目标
Elasticsearch 和 elasticsearch-head的安装配置和在PHP-Laravel项目中集成
1.ES版本的选择
在使用ES前,我们首先要选择一个合适的版本,选择最新的版本永远是一个不会错的选择,目前ES官网最新版本是8.0.0-alpha2,发布于September 17, 2021(2021/9/17),属于内部测试版,距今只有一个月时间,由于网络上关于其使用说明较少且可能没有相对应的php扩展包,不太利于学习,故我们可以选择7.x版本进行学习。7.15.1是最新的Release版本,发布于2021/10/15,距今只有几天时间,所有选择7.15.1进行学习是最佳的。
2.ES的下载安装
我本地调试学习一般使用的是Windows系统,生产环境使用的是Linux,所以这里两种操作系统下ES的下载安装都会用到。
官网下载链接:https://www.elastic.co/cn/downloads/elasticsearch#ga-release (属于中国节点,下载速度很快,3分钟左右就可以下载完成)
Windows下:
选择windows版本进行下载,解压elasticsearch-7.15.1-windows-x86_64.zip,双击运行bin目录下的elasticsearch.bat(杀毒软件可能会进行拦截,允许即可)
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
检测安装:
命令行提示信息中如果出现 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,在文件的末尾添加如下内容:
http.cors.enabled: true
http.cors.allow-origin: "*"
4.安装ES可视化插件elasticsearch-head
elasticsearch-head是用于监控 Elasticsearch 状态的客户端插件,包括数据可视化、执行增删改查操作等
安装node.js
下载地址:https://nodejs.org/en/download/ 根据自己系统下载相应的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",
运行
-
es/es-head目录下运行
- npm install
- npm run start(以后每次),如果还不成功,再执行一次npm install
-
浏览器中运行http://localhost:9100/
5.ES集群健康值
正常情况下,Elasticsearch 集群健康状态分为三种:
green 最健康得状态,说明所有的分片包括备份都可用; 这种情况Elasticsearch集群所有的主分片和副本分片都已分配, Elasticsearch集群是 100% 可用的。
yellow 基本的分片可用,但是备份不可用(或者是没有备份); 这种情况Elasticsearch集群所有的主分片已经分片了,但至少还有一个副本是缺失的。不会有数据丢失,所以搜索结果依然是完整的。不过,你的高可用性在某种程度上被弱化。如果 更多的 分片消失,你就会丢数据了。把 yellow 想象成一个需要及时调查的警告。
red 部分的分片可用,表明分片有一部分损坏。此时执行查询部分数据仍然可以查到,遇到这种情况,还是赶快解决比较好; 这种情况Elasticsearch集群至少一个主分片(以及它的全部副本)都在缺失中。这意味着你在缺少数据:搜索只能返回部分数据,而分配到这个分片上的写入请求会返回一个异常。
遇到的问题和解决
在扩展包的选择上,今天遇到了一些问题,比如选了排名第一的 elasticsearch-php,但是composer安装后发现其并没有提供相对应的config文件进行配置,不是很友好,所以在对类库封装api的使用上,我们可以也封装几个相对应的方法或者将类的实例化进行封装,以便于日后可能需要更换其他类库时而产生的代码大面积修改。
Ps:最后是通过laravel的容器注入实现了配置文件的手动配置和es的单例实例化
明日目标
Elasticsearch-PHP基本API使用
总结
到这里我们的Elasticsearch的安装配置和简单使用就完成,我们可以将index设为数据库,type设为表名,来对数据表进行索引管理。