From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/zh-cn/web/http/methods/connect/index.html | 85 +++++++++++++++++ files/zh-cn/web/http/methods/delete/index.html | 103 ++++++++++++++++++++ files/zh-cn/web/http/methods/get/index.html | 71 ++++++++++++++ files/zh-cn/web/http/methods/head/index.html | 77 +++++++++++++++ files/zh-cn/web/http/methods/index.html | 71 ++++++++++++++ files/zh-cn/web/http/methods/options/index.html | 122 ++++++++++++++++++++++++ files/zh-cn/web/http/methods/patch/index.html | 97 +++++++++++++++++++ files/zh-cn/web/http/methods/post/index.html | 120 +++++++++++++++++++++++ files/zh-cn/web/http/methods/put/index.html | 101 ++++++++++++++++++++ files/zh-cn/web/http/methods/trace/index.html | 77 +++++++++++++++ 10 files changed, 924 insertions(+) create mode 100644 files/zh-cn/web/http/methods/connect/index.html create mode 100644 files/zh-cn/web/http/methods/delete/index.html create mode 100644 files/zh-cn/web/http/methods/get/index.html create mode 100644 files/zh-cn/web/http/methods/head/index.html create mode 100644 files/zh-cn/web/http/methods/index.html create mode 100644 files/zh-cn/web/http/methods/options/index.html create mode 100644 files/zh-cn/web/http/methods/patch/index.html create mode 100644 files/zh-cn/web/http/methods/post/index.html create mode 100644 files/zh-cn/web/http/methods/put/index.html create mode 100644 files/zh-cn/web/http/methods/trace/index.html (limited to 'files/zh-cn/web/http/methods') diff --git a/files/zh-cn/web/http/methods/connect/index.html b/files/zh-cn/web/http/methods/connect/index.html new file mode 100644 index 0000000000..580b9b13f7 --- /dev/null +++ b/files/zh-cn/web/http/methods/connect/index.html @@ -0,0 +1,85 @@ +--- +title: CONNECT +slug: Web/HTTP/Methods/CONNECT +tags: + - 请求方法 + - 隧道 +translation_of: Web/HTTP/Methods/CONNECT +--- +
{{HTTPSidebar}}
+ +

在 HTTP 协议中，CONNECT 方法可以开启一个客户端与所请求资源之间的双向沟通的通道。它可以用来创建隧道（tunnel）。

+ +

例如，CONNECT 可以用来访问采用了 {{Glossary("SSL")}} ({{Glossary("HTTPS")}})  协议的站点。客户端要求代理服务器将 TCP 连接作为通往目的主机隧道。之后该服务器会代替客户端与目的主机建立连接。连接建立好之后，代理服务器会面向客户端发送或接收 TCP 消息流。

+ +

CONNECT 是一个应用范围为点到点的方法。

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Request has bodyNo
Successful response has bodyYes
{{Glossary("Safe")}}No
{{Glossary("Idempotent")}}No
{{Glossary("Cacheable")}}No
Allowed in HTML formsNo
+ +

语法

+ +
CONNECT www.example.com:443 HTTP/1.1
+
+ +

示例

+ +

一些代理服务器在创建隧道时会要求进行身份验证。参见  {{HTTPHeader("Proxy-Authorization")}} 首部。

+ +
CONNECT server.example.com:80 HTTP/1.1
+Host: server.example.com:80
+Proxy-Authorization: basic aGVsbG86d29ybGQ=
+ +

规范

+ + + + + + + + + + + + +
SpecificationTitle
{{RFC("7231", "CONNECT", "4.3.6")}}Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content
+ +

浏览器兼容性

+ + + +

{{Compat("http.methods.CONNECT")}}

+ +

相关内容

+ + diff --git a/files/zh-cn/web/http/methods/delete/index.html b/files/zh-cn/web/http/methods/delete/index.html new file mode 100644 index 0000000000..5da1185b7c --- /dev/null +++ b/files/zh-cn/web/http/methods/delete/index.html @@ -0,0 +1,103 @@ +--- +title: DELETE +slug: Web/HTTP/Methods/DELETE +tags: + - HTTP + - HTTP方法 + - 参考 + - 请求方法 +translation_of: Web/HTTP/Methods/DELETE +--- +
{{HTTPSidebar}}
+ +

HTTP DELETE 请求方法用于删除指定的资源。

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
请求是否有主体可以有
成功的返回是否有主体可以有
{{Glossary("安全")}}否
{{Glossary("幂等")}}是
{{Glossary("可缓存")}}否
可以在HTML forms中使用否
+ +

语法

+ +
DELETE /file.html HTTP/1.1
+
+ +

示例

+ +

请求

+ +
DELETE /file.html HTTP/1.1
+ +

响应

+ +

如果 DELETE 方法成功执行，那么可能会有以下几种状态码：

+ + + +
HTTP/1.1 200 OK
+Date: Wed, 21 Oct 2015 07:28:00 GMT
+
+<html>
+  <body>
+    <h1>File deleted.</h1>
+  </body>
+</html>
+ +

规范

+ + + + + + + + + + + + +
SpecificationTitle
{{RFC("7231", "DELETE", "4.3.5")}} +

Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content

+
+ +

Browser compatibility

+ +

{{Compat("http.methods.DELETE")}}

+ +

相关内容

+ + + +

 

+ +

 

diff --git a/files/zh-cn/web/http/methods/get/index.html b/files/zh-cn/web/http/methods/get/index.html new file mode 100644 index 0000000000..5f59bd2423 --- /dev/null +++ b/files/zh-cn/web/http/methods/get/index.html @@ -0,0 +1,71 @@ +--- +title: GET +slug: Web/HTTP/Methods/GET +tags: + - HTTP + - 参考 + - 请求方法 +translation_of: Web/HTTP/Methods/GET +--- +
{{HTTPSidebar}}
+ +

HTTP GET 方法请求指定的资源。使用 GET 的请求应该只用于获取数据。

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
请求是否有主体否
成功的响应是否有主体是
{{Glossary("安全")}}是
{{Glossary("幂等")}}是
{{Glossary("可缓存")}}是
HTML 表单是否支持是
+ +

语法

+ +
GET /index.html
+
+ +

规范

+ + + + + + + + + + + + +
规范标题
{{RFC("7231", "GET", "4.3.1")}}Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content
+ +

浏览器兼容性

+ +

{{Compat("http.methods.GET")}}

+ +

另见

+ + diff --git a/files/zh-cn/web/http/methods/head/index.html b/files/zh-cn/web/http/methods/head/index.html new file mode 100644 index 0000000000..5b48e1a727 --- /dev/null +++ b/files/zh-cn/web/http/methods/head/index.html @@ -0,0 +1,77 @@ +--- +title: HEAD +slug: Web/HTTP/Methods/HEAD +tags: + - HTTP + - 参考 + - 请求方法 +translation_of: Web/HTTP/Methods/HEAD +--- +
{{HTTPSidebar}}
+ +

HTTP HEAD 方法 请求资源的头部信息, 并且这些头部与 HTTP {{HTTPMethod("GET")}} 方法请求时返回的一致. 该请求方法的一个使用场景是在下载一个大文件前先获取其大小再决定是否要下载, 以此可以节约带宽资源.

+ +

HEAD 方法的响应不应包含响应正文. 即使包含了正文也必须忽略掉. 虽然描述正文信息的 {{glossary("Entity header", "entity headers")}}, 例如 {{HTTPHeader("Content-Length")}} 可能会包含在响应中, 但它们并不是用来描述 HEAD 响应本身的, 而是用来描述同样情况下的 {{HTTPMethod("GET")}} 请求应该返回的响应.

+ +

如果 HEAD 请求的结果显示在上一次 {{HTTPMethod("GET")}} 请求后缓存的资源已经过期了, 即使没有发出{{HTTPMethod("GET")}}请求，缓存也会失效

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
请求是否有正文否
成功的响应是否有正文否
{{Glossary("安全")}}是
{{Glossary("幂等")}}是
{{Glossary("可缓存")}}是
HTML 表单 是否支持否
+ +

语法

+ +
HEAD /index.html
+
+ +

规范

+ + + + + + + + + + + + +
规范标题
{{RFC("7231", "HEAD", "4.3.2")}}Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content
+ +

浏览器兼容性

+ + + +

{{Compat("http.methods.HEAD")}}

+ +

?另见

+ + diff --git a/files/zh-cn/web/http/methods/index.html b/files/zh-cn/web/http/methods/index.html new file mode 100644 index 0000000000..6f926a633d --- /dev/null +++ b/files/zh-cn/web/http/methods/index.html @@ -0,0 +1,71 @@ +--- +title: HTTP 请求方法 +slug: Web/HTTP/Methods +tags: + - Browser support for JavaScript APIs + - HTTP + - 'HTTP Methods: GET vs. POST' + - Methods + - Reference + - Safe and Idempotent Methods + - methods for HTTP/1.1 + - '词汇表:幂等 可缓存' +translation_of: Web/HTTP/Methods +--- +

{{HTTPSidebar}}

+ +

HTTP 定义了一组请求方法, 以表明要对给定资源执行的操作。指示针对给定资源要执行的期望动作. 虽然他们也可以是名词, 但这些请求方法有时被称为HTTP动词. 每一个请求方法都实现了不同的语义, 但一些共同的特征由一组共享：: 例如一个请求方法可以是 {{glossary("safe")}}, {{glossary("idempotent")}}, 或 {{glossary("cacheable")}}.

+ +
+
GET
+
GET方法请求一个指定资源的表示形式. 使用GET的请求应该只被用于获取数据.
+
HEAD
+
HEAD方法请求一个与GET请求的响应相同的响应，但没有响应体.
+
POST
+
POST方法用于将实体提交到指定的资源，通常导致在服务器上的状态变化或副作用. 
+
PUT
+
PUT方法用请求有效载荷替换目标资源的所有当前表示。
+
DELETE
+
DELETE方法删除指定的资源。
+
CONNECT
+
CONNECT方法建立一个到由目标资源标识的服务器的隧道。
+
OPTIONS
+
OPTIONS方法用于描述目标资源的通信选项。
+
TRACE
+
TRACE方法沿着到目标资源的路径执行一个消息环回测试。
+
PATCH
+
PATCH方法用于对资源应用部分修改。
+
+

规范

+ + + + + + + + + + + + + + + + + + + +
规范标题注解
{{RFC("7231", "Request methods", "4")}}Hypertext Transfer Protocol (HTTP/1.1): Semantics and ContentSpecifies GET, HEAD, POST, PUT, DELETE, CONNECT, OPTIONS, TRACE.
{{RFC("5789", "Patch method", "2")}}PATCH Method for HTTPSpecifies PATCH.
+
+
+ +

浏览器兼容性

+ +

{{Compat}}

+ +

另见

+ + diff --git a/files/zh-cn/web/http/methods/options/index.html b/files/zh-cn/web/http/methods/options/index.html new file mode 100644 index 0000000000..3537e8e1c3 --- /dev/null +++ b/files/zh-cn/web/http/methods/options/index.html @@ -0,0 +1,122 @@ +--- +title: OPTIONS +slug: Web/HTTP/Methods/OPTIONS +translation_of: Web/HTTP/Methods/OPTIONS +--- +
{{HTTPSidebar}}
+ +

HTTP 的 OPTIONS 方法 用于获取目的资源所支持的通信选项。客户端可以对特定的 URL 使用 OPTIONS 方法，也可以对整站（通过将 URL 设置为“*”）使用该方法。

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Request has bodyNo
Successful response has bodyYes
{{Glossary("Safe")}}Yes
{{Glossary("Idempotent")}}Yes
{{Glossary("Cacheable")}}No
Allowed in HTML formsNo
+ +

语法

+ +
OPTIONS /index.html HTTP/1.1
+OPTIONS * HTTP/1.1
+
+ +

示例

+ +

检测服务器所支持的请求方法

+ +

可以使用 OPTIONS 方法对服务器发起请求，以检测服务器支持哪些 HTTP 方法：

+ +
curl -X OPTIONS http://example.org -i
+ +

响应报文包含一个 {{HTTPHeader("Allow")}} 首部字段，该字段的值表明了服务器支持的所有 HTTP 方法：

+ +
HTTP/1.1 200 OK
+Allow: OPTIONS, GET, HEAD, POST
+Cache-Control: max-age=604800
+Date: Thu, 13 Oct 2016 11:45:00 GMT
+Expires: Thu, 20 Oct 2016 11:45:00 GMT
+Server: EOS (lax004/2813)
+x-ec-custom-error: 1
+Content-Length: 0
+
+ +

CORS 中的预检请求

+ +

在 CORS 中，可以使用 OPTIONS 方法发起一个预检请求，以检测实际请求是否可以被服务器所接受。预检请求报文中的 {{HTTPHeader("Access-Control-Request-Method")}} 首部字段告知服务器实际请求所使用的 HTTP 方法；{{HTTPHeader("Access-Control-Request-Headers")}} 首部字段告知服务器实际请求所携带的自定义首部字段。服务器基于从预检请求获得的信息来判断，是否接受接下来的实际请求。

+ +
OPTIONS /resources/post-here/ HTTP/1.1
+Host: bar.other
+Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
+Accept-Language: en-us,en;q=0.5
+Accept-Encoding: gzip,deflate
+Accept-Charset: ISO-8859-1,utf-8;q=0.7,*;q=0.7
+Connection: keep-alive
+Origin: http://foo.example
+Access-Control-Request-Method: POST
+Access-Control-Request-Headers: X-PINGOTHER, Content-Type
+ +

服务器所返回的 {{HTTPHeader("Access-Control-Allow-Methods")}} 首部字段将所有允许的请求方法告知客户端。该首部字段与 {{HTTPHeader("Allow")}} 类似，但只能用于涉及到 CORS 的场景中。

+ +
HTTP/1.1 200 OK
+Date: Mon, 01 Dec 2008 01:15:39 GMT
+Server: Apache/2.0.61 (Unix)
+Access-Control-Allow-Origin: http://foo.example
+Access-Control-Allow-Methods: POST, GET, OPTIONS
+Access-Control-Allow-Headers: X-PINGOTHER, Content-Type
+Access-Control-Max-Age: 86400
+Vary: Accept-Encoding, Origin
+Content-Encoding: gzip
+Content-Length: 0
+Keep-Alive: timeout=2, max=100
+Connection: Keep-Alive
+Content-Type: text/plain
+ +

规范

+ + + + + + + + + + + + +
SpecificationTitle
{{RFC("7231", "OPTIONS", "4.3.7")}}Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content
+ +

浏览器兼容性

+ + + +

{{Compat("http/methods", "OPTIONS")}}

+ +

参见

+ + diff --git a/files/zh-cn/web/http/methods/patch/index.html b/files/zh-cn/web/http/methods/patch/index.html new file mode 100644 index 0000000000..a86b50d0f1 --- /dev/null +++ b/files/zh-cn/web/http/methods/patch/index.html @@ -0,0 +1,97 @@ +--- +title: PATCH +slug: Web/HTTP/Methods/PATCH +tags: + - HTTP + - HTTP method + - HTTP方法 + - 参考 + - 请求方法 +translation_of: Web/HTTP/Methods/PATCH +--- +
{{HTTPSidebar}}
+ +

在HTTP协议中，请求方法 PATCH  用于对资源进行部分修改。

+ +

在HTTP协议中， {{HTTPMethod("PUT")}} 方法已经被用来表示对资源进行整体覆盖， 而 {{HTTPMethod("POST")}} 方法则没有对标准的补丁格式的提供支持。不同于  PUT 方法，而与 POST 方法类似，PATCH  方法是非幂等的，这就意味着连续多个的相同请求会产生不同的效果。

+ +

要判断一台服务器是否支持  PATCH 方法，那么就看它是否将其添加到了响应首部 {{HTTPHeader("Allow")}} 或者 {{HTTPHeader("Access-Control-Allow-Methods")}} （在跨域访问的场合，CORS）的方法列表中 。

+ +

另外一个支持 PATCH 方法的隐含迹象是 {{HTTPHeader("Accept-Patch")}} 首部的出现，这个首部明确了服务器端可以接受的补丁文件的格式。

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Request has bodyYes
Successful response has bodyNo
{{Glossary("Safe")}}No
{{Glossary("Idempotent")}}No
{{Glossary("Cacheable")}}No
Allowed in HTML formsNo
+ +

语法

+ +
PATCH /file.txt HTTP/1.1
+
+ +

示例

+ +

请求

+ +
PATCH /file.txt HTTP/1.1
+Host: www.example.com
+Content-Type: application/example
+If-Match: "e0023aa4e"
+Content-Length: 100
+
+[description of changes]
+ +

响应

+ +

 {{HTTPStatus("204")}} 状态码表示这是一个操作成功的响应，因为响应中不带有消息主体。

+ +
HTTP/1.1 204 No Content
+Content-Location: /file.txt
+ETag: "e0023aa4f"
+ +

规范

+ + + + + + + + + + + + +
SpecificationTitle
{{RFC("5789", "PATCH")}}PATCH Method for HTTP
+ +

相关内容

+ + diff --git a/files/zh-cn/web/http/methods/post/index.html b/files/zh-cn/web/http/methods/post/index.html new file mode 100644 index 0000000000..7521f6b0ee --- /dev/null +++ b/files/zh-cn/web/http/methods/post/index.html @@ -0,0 +1,120 @@ +--- +title: POST +slug: Web/HTTP/Methods/POST +tags: + - HTTP + - 参考 + - 请求方法 +translation_of: Web/HTTP/Methods/POST +--- +
{{HTTPSidebar}}
+ +

HTTP POST 方法 发送数据给服务器. 请求主体的类型由 {{HTTPHeader("Content-Type")}} 首部指定.

+ +

PUT 和{{HTTPMethod("POST")}}方法的区别是,PUT方法是幂等的：连续调用一次或者多次的效果相同（无副作用）。连续调用同一个POST可能会带来额外的影响，比如多次提交订单。

+ +

一个 POST 请求通常是通过 HTML 表单发送, 并返回服务器的修改结果. 在这种情况下, content type 是通过在 {{HTMLElement("form")}} 元素中设置正确的 {{htmlattrxref("enctype", "form")}} 属性, 或是在 {{HTMLElement("input") }} 和 {{HTMLElement("button")}} 元素中设置 {{htmlattrxref("formenctype", "input")}} 属性来选择的:

+ + + +

当 POST 请求是通过除 HTML 表单之外的方式发送时, 例如使用 {{domxref("XMLHttpRequest")}}, 那么请求主体可以是任何类型.按HTTP 1.1规范中描述，POST为了以统一的方法来涵盖以下功能：

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
请求是否有主体是
成功的响应是否有主体是
{{Glossary("安全")}}否
{{Glossary("幂等")}}否
{{Glossary("可缓存")}}Only if freshness information is included
HTML 表单是否支持是
+ +

语法

+ +
POST /index.html
+
+ +

示例

+ +

使用默认的 application/x-www-form-urlencoded 做为 content type 的简单表单:

+ +
POST / HTTP/1.1
+Host: foo.com
+Content-Type: application/x-www-form-urlencoded
+Content-Length: 13
+
+say=Hi&to=Mom
+ +

使用 multipart/form-data 作为 content type 的表单:

+ +
POST /test.html HTTP/1.1
+Host: example.org
+Content-Type: multipart/form-data;boundary="boundary"
+
+--boundary
+Content-Disposition: form-data; name="field1"
+
+value1
+--boundary
+Content-Disposition: form-data; name="field2"; filename="example.txt"
+
+value2
+ +

规范

+ + + + + + + + + + + + +
规范标题
{{RFC("7231", "POST", "4.3.3")}}Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content
+ +

浏览器兼容性

+ + + +

{{Compat("http.methods.POST")}}

+ +

另见

+ + diff --git a/files/zh-cn/web/http/methods/put/index.html b/files/zh-cn/web/http/methods/put/index.html new file mode 100644 index 0000000000..eeddfdd5c8 --- /dev/null +++ b/files/zh-cn/web/http/methods/put/index.html @@ -0,0 +1,101 @@ +--- +title: PUT +slug: Web/HTTP/Methods/PUT +tags: + - HTTP + - HTTP method + - Request method + - put +translation_of: Web/HTTP/Methods/PUT +--- +
{{HTTPSidebar}}
+ +

HTTP PUT 请求方法使用请求中的负载创建或者替换目标资源。

+ +

PUT 与 {{HTTPMethod("POST")}} 方法的区别在于，PUT方法是幂等的：调用一次与连续调用多次是等价的（即没有副作用），而连续调用多次POST方法可能会有副作用，比如将一个订单重复提交多次。

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Request has bodyYes
Successful response has bodyNo
{{Glossary("Safe")}}No
{{Glossary("Idempotent")}}Yes
{{Glossary("Cacheable")}}No
Allowed in HTML formsNo
+ +

语法

+ +
PUT /new.html HTTP/1.1
+
+ +

示例

+ +

请求

+ +
PUT /new.html HTTP/1.1
+Host: example.com
+Content-type: text/html
+Content-length: 16
+
+<p>New File</p>
+ +

应答

+ +

如果目标资源不存在，并且PUT方法成功创建了一份，那么源头服务器必须返回{{HTTPStatus("201")}} (Created) 来通知客户端资源已创建。

+ +
HTTP/1.1 201 Created
+Content-Location: /new.html
+ +

如果目标资源已经存在，并且依照请求中封装的表现形式成功进行了更新，那么，源头服务器必须返回{{HTTPStatus("200")}} (OK) 或者{{HTTPStatus("204")}} (No Content) 来表示请求的成功完成。

+ +
HTTP/1.1 204 No Content
+Content-Location: /existing.html
+
+ +

规范

+ + + + + + + + + + + + +
SpecificationTitle
{{RFC("7231", "PUT", "4.3.4")}}Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content
+ +

浏览器兼容性

+ + + +

{{Compat("http.methods.PUT")}}

+ +

参见

+ + diff --git a/files/zh-cn/web/http/methods/trace/index.html b/files/zh-cn/web/http/methods/trace/index.html new file mode 100644 index 0000000000..47f22c8da2 --- /dev/null +++ b/files/zh-cn/web/http/methods/trace/index.html @@ -0,0 +1,77 @@ +--- +title: TRACE +slug: Web/HTTP/Methods/TRACE +translation_of: Web/HTTP/Methods/TRACE +--- +
{{HTTPSidebar}}
+ +

HTTP TRACE 方法 实现沿通向目标资源的路径的消息环回（loop-back）测试 ，提供了一种实用的 debug 机制。

+ +

请求的最终接收者应当原样反射（reflect）它接收到的消息，除了以下字段部分，作为一个{{httpheader("Content-Type")}} 为 message/http  的200（OK）响应的消息的主体（body）返回给客户端 。

+ +

最终接收者是指初始（origin）服务器，或者第一个接收到 {{httpheader("Max-Forwards")}} 值为 0的请求的服务器。

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
有主体（body）的请求（request）否
包含主体（body）的成功的响应（response）否
{{Glossary("Safe")}}否
{{Glossary("Idempotent")}}是
{{Glossary("Cacheable")}}否
允许用于 HTML 表单（form）否
+ +

语法

+ +
TRACE /index.html
+
+ +

规范

+ + + + + + + + + + + + + + +
规范标题
{{RFC("7231", "TRACE", "4.3.8")}}Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content
+ +

浏览器兼容性

+ + + +

{{Compat("http.methods.TRACE")}}

+ +

参考

+ + + +

 

-- cgit v1.2.3-54-g00ecf