发起 PUT 请求 (http.put)

声明

HTTP状态码, 返回头JSON文本, 返回主体 = http.put(URL [, 超时秒, 请求头, 请求主体, URL不ESCAPE ])

参数及返回值

• URL
  • 文本型，需要请求的 URL 地址，该方法默认会对 URL 进行 escape 处理，如不需要可参考 URL不ESCAPE 参数说明
• 超时秒
  • 实数型，可选参数，请求超时时间，单位秒，默认 2
  • *1.2-3 版以上默认超时改为 10 秒
• 请求头
  • 表型，可选参数，发出的请求的头部信息，形式 {field1 = value1, field2 = value2, ...}，默认 {}
• 请求主体
  • 字符串型，可选参数，使用 put 发送出去的内容，默认是空字符串
• URL不ESCAPE *1.1.3-1 新增
  • 布尔型，可选参数，true 表示不对 URL 进行 escape 直接请求，默认 false
  • 对 URL 进行自定义 escape 可参考 lcurl 模块 的 easy:escape、easy:unescape
• HTTP状态码
  • 整数型，返回当次请求的 http 状态码，请求超时返回 -1
• 返回头JSON文本
  • 文本型 或 nil，请求完成返回的 JSON 形式头部信息，请求超时返回 nil
• 返回主体
  • 字符串型 或 nil，请求完成返回的内容，请求超时返回 nil

说明

使用 HTTP/1.1 协议的 PUT 方法发送数据到网络中，它与 POST 用法一致
这个函数在 1.1.1-1 版以上方可使用
这个函数可能会让出，在这个函数返回之前，其它的 线程 可能会得到运行机会

示例

local code, res_headers, body = http.put("http://www.baidu.com", 1, {
    ["User-Agent"] = "Mozilla/4.0 (compatible; MSIE 8.0; Windows NT 6.0)", -- 模拟 IE8 的请求
    ["Cookie"] = "大佬你会不会啊？"; -- 顺带 Cookie 提交
}, "需要发送过去的数据")
if code==200 then -- 如果返回的状态码是 HTTP_OK
    sys.alert(body) -- 输出百度首页的网页html
end

注：上述代码中使用了非本章函数 sys.alert