Skip to content

Commit 5d4b18c

Browse files
author
mosongxing
committed
Fix:quickstart 校验
1 parent 2518243 commit 5d4b18c

File tree

2 files changed

+16
-13
lines changed

2 files changed

+16
-13
lines changed

overview.asciidoc

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
[[_overview]]
22
== 概述
33

4-
这是 Elasticsearch 官方的 PHP 客户端。本客户端基于https://en.wikipedia.org/wiki/Low-level_design/[低级设计模式],使用时不会偏离 REST API 的用法。
4+
这是 Elasticsearch 官方的 PHP 客户端。我们把 Elasticsearch-PHP 设计成低级客户端(https://en.wikipedia.org/wiki/Low-level_design[低级设计模式],使用时不会偏离 REST API 的用法。
55

6-
客户端所有方法几乎都与 REST API 对应,而且也与其他编程语言的客户端(如 ruby, python 等)方法结构相对应。我们希望这种对应方式可以方便开发者更加容易上手客户端,且以最小的代价快速从一种编程语言转换到另一种编程语言。
6+
客户端所有方法几乎都与 REST API 对应,而且也与其他编程语言的客户端(如 ruby, python 等)方法结构相似。我们希望这种对应方式可以方便开发者更加容易上手客户端,且以最小的代价快速从一种编程语言转换到另一种编程语言。
77

8-
本客户端设计得很“灵活”。虽然有一些通用的细节添加进了客户端(集群状态探查,轮询调度请求等),但总的来说它是十分基础的。这也是有意这样设计。我们只是设计了基础方法,更多的复杂类库可以在此衍生出来。
8+
本客户端设计得很“灵活”。虽然有一些通用的细节添加进了客户端(集群状态嗅探,轮询调度请求等),但总的来说它是十分基础的。这也是有意这样设计。我们只是设计了基础方法,更多的复杂类库可以在此衍生出来。

quickstart.asciidoc

Lines changed: 13 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
[[_quickstart]]
22
== 快速开始
33

4-
这一节会概述一下客户端以及客户端的一些主要方法的使用
4+
这一节会概述一下客户端以及客户端的一些主要方法的使用规则
55

66
=== 安装
77

@@ -37,9 +37,9 @@ $client = ClientBuilder::create()->build();
3737

3838
=== 索引一个文档
3939

40-
在 elasticsearch-php 中,几乎一切操作都是用关联数组来配置。REST 路径(endpoint)、文档和可选参数——都是关联数组来配置
40+
在 elasticsearch-php 中,几乎一切操作都是用关联数组来配置。REST 路径(endpoint)、文档和可选参数都是用关联数组来配置
4141

42-
为了索引一个文档,我们要指定4部分信息:index,type,id和一个body。构建一个键值对的关联数组就可以完成上面的内容。请求体的键值对格式与文档的数据保持一致性。(译者注:如['testField' => 'abc']在文档中则为{"testField" : "abc"}):
42+
为了索引一个文档,我们要指定4部分信息:index,type,id 和一个 body。构建一个键值对的关联数组就可以完成上面的内容。body 的键值对格式与文档的数据保持一致性。(译者注:如 ["testField" => "abc"] 在文档中则为 {"testField" : "abc"}):
4343

4444
[source,php]
4545
--------------------------------------------------
@@ -93,8 +93,8 @@ $response = $client->get($params);
9393
print_r($response);
9494
--------------------------------------------------
9595

96-
响应数据包含一些元数据(如index,type等)和_source 属性,
97-
这些是你最初发送给 Elasticsearch 的数据
96+
响应数据包含一些元数据(如 index,type 等)和 `_source` 属性,
97+
这是你发送给 Elasticsearch 的原始文档数据
9898

9999
[source,php]
100100
--------------------------------------------------
@@ -134,7 +134,7 @@ $response = $client->search($params);
134134
print_r($response);
135135
--------------------------------------------------
136136

137-
这个响应数据与前面例子的响应数据有所不同。这里有一些元数据(如took, timed_out等)和一个hits的数组,这代表了你的搜索结果。而 hits 内部也有一个 hits,内部的 hits 包含个人的的搜索数据
137+
这个响应数据与前面例子的响应数据有所不同。这里有一些元数据(如 `took`, `timed_out` 等)和一个 `hits` 的数组,这代表了你的搜索结果。而 `hits` 内部也有一个 `hits` 数组,内部的 `hits` 包含特定的搜索结果
138138

139139
[source,php]
140140
--------------------------------------------------
@@ -188,7 +188,7 @@ $response = $client->delete($params);
188188
print_r($response);
189189
--------------------------------------------------
190190

191-
你会注意到删除文档的语法与获取文档的语法是一样的。唯一不同的是 delete 方法替代了 get 方法。下面响应数据代表文档已被删除:
191+
你会注意到删除文档的语法与获取文档的语法是一样的。唯一不同的是 `delete` 方法替代了 `get` 方法。下面响应数据代表文档已被删除:
192192

193193
[source,php]
194194
--------------------------------------------------
@@ -213,7 +213,7 @@ Array
213213

214214
=== 删除一个索引
215215

216-
由于 elasticsearch 的动态特性,我们创建的第一个文档会自动创建一个索引,同时也会把 settings 里面的参数配置为默认参数。由于我们在后面要指定特定的 settings,所以现在要删除掉这个索引:
216+
由于 elasticsearch 的动态特性,我们创建的第一个文档会自动创建一个索引,同时也会把 settings 里面的参数设定为默认参数。由于我们在后面要指定特定的 settings,所以现在要删除掉这个索引:
217217

218218
[source,php]
219219
--------------------------------------------------
@@ -224,10 +224,10 @@ Array
224224
print_r($response);
225225
--------------------------------------------------
226226

227-
[source,php]
228-
--------------------------------------------------
229227
响应数据是:
230228

229+
[source,php]
230+
--------------------------------------------------
231231
Array
232232
(
233233
[acknowledged] => 1
@@ -252,9 +252,12 @@ $params = [
252252
253253
$response = $client->indices()->create($params);
254254
print_r($response);
255+
--------------------------------------------------
255256

256257
Elasticsearch会创建一个索引,并配置你指定的参数值,然后返回一个消息确认:
257258

259+
[source,php]
260+
--------------------------------------------------
258261
Array
259262
(
260263
[acknowledged] => 1

0 commit comments

Comments
 (0)