Skip to main content

http

成员函数函数描述/介绍
http.DoDo 根据构造好的请求结构体引用发送请求,返回响应结构体引用与错误 ! 已弃用
http.ExtractFaviconURLExtractFaviconURL will receive a site url and html content return the favicon url
http.GetGet 根据指定的 URL 发起 GET 请求,它的第一个参数是 URL ,接下来可以接收零个到多个请求选项,用于对此次请求进行配置,例如设置超时时间等 返回响应结构体引用与错误 ! 已弃用,使用 poc.Get 代替
http.GetAllBodyGetAllBody 获取响应结构体引用的原始响应报文
http.NewRequestNewRequest 根据指定的 method 和 URL 生成请求结构体引用,返回请求结构体引用与错误,它的第一个参数是 URL ,接下来可以接收零个到多个请求选项,用于对此次请求进行配置,例如设置超时时间等 注意,此函数只会生成请求结构体引用,不会发起请求 ! 已弃用
http.PostPost 根据指定的 URL 发起 POST 请求,它的第一个参数是 URL ,接下来可以接收零个到多个请求选项,用于对此次请求进行配置,例如设置请求体,设置超时时间等 返回响应结构体引用与错误 ! 已弃用,使用 poc.Post 代替
http.RawRaw 根据原始请求报文生成请求结构体引用,返回请求结构体引用与错误 注意,此函数只会生成请求结构体引用,不会发起请求 ! 已弃用,使用 poc.HTTP 或 poc.HTTPEx 代替
http.RequestRequest 根据指定的 URL 发起请求,它的第一个参数是 URL ,接下来可以接收零个到多个请求选项,用于对此次请求进行配置,例如设置请求体,设置超时时间等 返回响应结构体引用与错误 ! 已弃用,使用 poc.Do 代替
http.RequestFaviconHash
http.RequestToMD5
http.RequestToMMH3Hash128
http.RequestToMMH3Hash128x64
http.RequestToSha1
http.RequestToSha256
http.bodybody 是一个请求选项参数,用于指定请求体
http.contextcontext 是一个请求选项参数,用于设置请求的上下文
http.cookieheader 是一个请求选项参数,用于设置完整的 Cookie 字段
http.dumpdump 获取指定请求结构体引用或响应结构体引用的原始报文,返回原始报文与错误
http.dumpheaddumphead 获取指定请求结构体引用或响应结构体引用的原始报文头部,返回原始报文头部与错误
http.fakeua
http.fromPlugin
http.headerheader 是一个请求选项参数,用于添加/指定请求头
http.jsonjson 是一个请求选项参数,用于指定 JSON 格式的请求体 它会将传入的值进行 JSON 序列化,然后设置序列化后的值为请求体
http.noredirect
http.paramsparams 是一个请求选项参数,用于添加/指定 GET 参数,这会将参数进行 URL 编码
http.postparamspostparams 是一个请求选项参数,用于添加/指定 POST 参数,这会将参数进行 URL 编码
http.proxyproxy 是一个请求选项参数,用于设置一个或多个请求的代理,请求时会根据顺序找到一个可用的代理使用
http.redirectredirect 是一个请求选项参数,它接收重定向处理函数,用于自定义重定向处理逻辑,返回 true 代表继续重定向,返回 false 代表终止重定向 重定向处理函数中第一个参数是当前的请求结构体引用,第二个参数是之前的请求结构体引用
http.runtimeID
http.savesave 是一个请求选项参数,用于指定是否将此次请求的记录保存在数据库中,默认为true即会保存到数据库
http.sessionsession 是一个请求选项参数,用于根据传入的值指定会话,使用相同的值会使用同一个会话,同一个会话会自动复用 Cookie
http.showshow 获取指定请求结构体引用或响应结构体引用的原始报文并输出在标准输出
http.showheadshowhead 获取指定请求结构体引用或响应结构体引用的原始报文头部并输出在标准输出
http.sourcesource 是一个请求选项参数,用于在请求记录保存到数据库时标识此次请求的来源
http.timeoutWithTimeout 是一个请求选项参数,用于设置请求超时时间,单位是秒
http.uauseragent 是一个请求选项参数,用于指定请求的 User-Agent
http.uaranduarand 返回一个随机的 User-Agent
http.useragentuseragent 是一个请求选项参数,用于指定请求的 User-Agent

函数定义#

Do#

详细描述#

Do 根据构造好的请求结构体引用发送请求,返回响应结构体引用与错误

! 已弃用

Example:

req, err = http.Raw("GET / HTTP/1.1\r\nHost: www.yaklang.com\r\n\r\n")rsp, err = http.Do(req)

定义#

Do(i any) (*http.Response, error)

参数#

参数名参数类型参数解释
iany

返回值#

返回值(顺序)返回值类型返回值解释
r1*http.Response
r2error

ExtractFaviconURL#

详细描述#

ExtractFaviconURL will receive a site url and html content return the favicon url

Example:

http.ExtractFaviconURL("https://www.baidu.com", []byte(`<link rel="shortcut icon" href="/favicon.ico" type="image/x-icon">`))http.ExtractFaviconURL("https://www.baidu.com", []byte(`<link rel="icon" href="/favicon.ico" type="image/x-icon">`))http.ExtractFaviconURL("https://www.baidu.com", []byte(`<link rel="icon" href="/favicon.png" type="image/png">`))

定义#

ExtractFaviconURL(siteURL string, content []byte) (string, error)

参数#

参数名参数类型参数解释
siteURLstring
content[]byte

返回值#

返回值(顺序)返回值类型返回值解释
r1string
r2error

Get#

详细描述#

Get 根据指定的 URL 发起 GET 请求,它的第一个参数是 URL ,接下来可以接收零个到多个请求选项,用于对此次请求进行配置,例如设置超时时间等

返回响应结构体引用与错误

! 已弃用,使用 poc.Get 代替

Example:

rsp, err = http.Get("http://www.yaklang.com", http.timeout(10))

定义#

Get(url string, options ...http_struct.HttpOption) (*http_struct.YakHttpResponse, error)

参数#

参数名参数类型参数解释
urlstring
options...http_struct.HttpOption

返回值#

返回值(顺序)返回值类型返回值解释
r1*http_struct.YakHttpResponse
r2error

GetAllBody#

详细描述#

GetAllBody 获取响应结构体引用的原始响应报文

Example:

rsp, err = http.Get("http://www.yaklang.com")raw = http.GetAllBody(rsp)

定义#

GetAllBody(raw any) []byte

参数#

参数名参数类型参数解释
rawany

返回值#

返回值(顺序)返回值类型返回值解释
r1[]byte

NewRequest#

详细描述#

NewRequest 根据指定的 method 和 URL 生成请求结构体引用,返回请求结构体引用与错误,它的第一个参数是 URL ,接下来可以接收零个到多个请求选项,用于对此次请求进行配置,例如设置超时时间等

注意,此函数只会生成请求结构体引用,不会发起请求

! 已弃用

Example:

req, err = http.NewRequest("GET", "http://www.yaklang.com", http.timeout(10))

定义#

NewRequest(method string, url string, opts ...http_struct.HttpOption) (*http_struct.YakHttpRequest, error)

参数#

参数名参数类型参数解释
methodstring
urlstring
opts...http_struct.HttpOption

返回值#

返回值(顺序)返回值类型返回值解释
r1*http_struct.YakHttpRequest
r2error

Post#

详细描述#

Post 根据指定的 URL 发起 POST 请求,它的第一个参数是 URL ,接下来可以接收零个到多个请求选项,用于对此次请求进行配置,例如设置请求体,设置超时时间等

返回响应结构体引用与错误

! 已弃用,使用 poc.Post 代替

Example:

rsp, err = http.Post("http://pie.dev/post", http.body("a=b&c=d"), http.timeout(10))

定义#

Post(url string, options ...http_struct.HttpOption) (*http_struct.YakHttpResponse, error)

参数#

参数名参数类型参数解释
urlstring
options...http_struct.HttpOption

返回值#

返回值(顺序)返回值类型返回值解释
r1*http_struct.YakHttpResponse
r2error

Raw#

详细描述#

Raw 根据原始请求报文生成请求结构体引用,返回请求结构体引用与错误

注意,此函数只会生成请求结构体引用,不会发起请求

! 已弃用,使用 poc.HTTP 或 poc.HTTPEx 代替

Example:

req, err = http.Raw("GET / HTTP/1.1\r\nHost: www.yaklang.com\r\n\r\n")

定义#

Raw(i any) (*http.Request, error)

参数#

参数名参数类型参数解释
iany

返回值#

返回值(顺序)返回值类型返回值解释
r1*http.Request
r2error

Request#

详细描述#

Request 根据指定的 URL 发起请求,它的第一个参数是 URL ,接下来可以接收零个到多个请求选项,用于对此次请求进行配置,例如设置请求体,设置超时时间等

返回响应结构体引用与错误

! 已弃用,使用 poc.Do 代替

Example:

rsp, err = http.Request("POST","http://pie.dev/post", http.body("a=b&c=d"), http.timeout(10))

定义#

Request(method string, url string, options ...http_struct.HttpOption) (*http_struct.YakHttpResponse, error)

参数#

参数名参数类型参数解释
methodstring
urlstring
options...http_struct.HttpOption

返回值#

返回值(顺序)返回值类型返回值解释
r1*http_struct.YakHttpResponse
r2error

RequestFaviconHash#

详细描述#

定义#

RequestFaviconHash(urlRaw string) (string, error)

参数#

参数名参数类型参数解释
urlRawstring

返回值#

返回值(顺序)返回值类型返回值解释
r1string
r2error

RequestToMD5#

详细描述#

定义#

RequestToMD5(url string) (string, error)

参数#

参数名参数类型参数解释
urlstring

返回值#

返回值(顺序)返回值类型返回值解释
r1string
r2error

RequestToMMH3Hash128#

详细描述#

定义#

RequestToMMH3Hash128(url string) (string, error)

参数#

参数名参数类型参数解释
urlstring

返回值#

返回值(顺序)返回值类型返回值解释
r1string
r2error

RequestToMMH3Hash128x64#

详细描述#

定义#

RequestToMMH3Hash128x64(url string) (string, error)

参数#

参数名参数类型参数解释
urlstring

返回值#

返回值(顺序)返回值类型返回值解释
r1string
r2error

RequestToSha1#

详细描述#

定义#

RequestToSha1(url string) (string, error)

参数#

参数名参数类型参数解释
urlstring

返回值#

返回值(顺序)返回值类型返回值解释
r1string
r2error

RequestToSha256#

详细描述#

定义#

RequestToSha256(url string) (string, error)

参数#

参数名参数类型参数解释
urlstring

返回值#

返回值(顺序)返回值类型返回值解释
r1string
r2error

body#

详细描述#

body 是一个请求选项参数,用于指定请求体

Example:

rsp, err = http.Post("https://pie.dev/post", http.body("a=b&c=d"))

定义#

body(value any) http_struct.HttpOption

参数#

参数名参数类型参数解释
valueany

返回值#

返回值(顺序)返回值类型返回值解释
r1http_struct.HttpOption

context#

详细描述#

context 是一个请求选项参数,用于设置请求的上下文

Example:

ctx = context.New()rsp, err = http.Get("http://www.example.com", http.context(ctx)) // 向 example.com 发起请求,使用指定的上下文

定义#

context(ctx context.Context) http_struct.HttpOption

参数#

参数名参数类型参数解释
ctxcontext.Context

返回值#

返回值(顺序)返回值类型返回值解释
r1http_struct.HttpOption

cookie#

详细描述#

header 是一个请求选项参数,用于设置完整的 Cookie 字段

Example:

rsp, err = http.Get("http://www.yaklang.com", http.WithCookie("a=b; c=d"))

定义#

cookie(value any) http_struct.HttpOption

参数#

参数名参数类型参数解释
valueany

返回值#

返回值(顺序)返回值类型返回值解释
r1http_struct.HttpOption

dump#

详细描述#

dump 获取指定请求结构体引用或响应结构体引用的原始报文,返回原始报文与错误

Example:

req, err = http.NewRequest("GET", "http://www.yaklang.com", http.timeout(10))reqRaw, err = http.dump(req)rsp, err = http.Do(req)rspRaw, err = http.dump(rsp)

定义#

dump(i any) ([]byte, error)

参数#

参数名参数类型参数解释
iany

返回值#

返回值(顺序)返回值类型返回值解释
r1[]byte
r2error

dumphead#

详细描述#

dumphead 获取指定请求结构体引用或响应结构体引用的原始报文头部,返回原始报文头部与错误

Example:

req, err = http.NewRequest("GET", "http://www.yaklang.com", http.timeout(10))reqHeadRaw, err = http.dumphead(req)rsp, err = http.Do(req)rspHeadRaw, err = http.dumphead(rsp)

定义#

dumphead(i any) ([]byte, error)

参数#

参数名参数类型参数解释
iany

返回值#

返回值(顺序)返回值类型返回值解释
r1[]byte
r2error

fakeua#

详细描述#

定义#

fakeua() http_struct.HttpOption

返回值#

返回值(顺序)返回值类型返回值解释
r1http_struct.HttpOption

fromPlugin#

详细描述#

定义#

fromPlugin(value string) http_struct.HttpOption

参数#

参数名参数类型参数解释
valuestring

返回值#

返回值(顺序)返回值类型返回值解释
r1http_struct.HttpOption

header#

详细描述#

header 是一个请求选项参数,用于添加/指定请求头

Example:

rsp, err = http.Get("http://www.yaklang.com", http.header("AAA", "BBB"))

定义#

header(key any, value any) http_struct.HttpOption

参数#

参数名参数类型参数解释
keyany
valueany

返回值#

返回值(顺序)返回值类型返回值解释
r1http_struct.HttpOption

json#

详细描述#

json 是一个请求选项参数,用于指定 JSON 格式的请求体

它会将传入的值进行 JSON 序列化,然后设置序列化后的值为请求体

Example:

rsp, err = http.Post("https://pie.dev/post", http.header("Content-Type", "application/json"), http.json({"a": "b", "c": "d"}))

定义#

json(value any) http_struct.HttpOption

参数#

参数名参数类型参数解释
valueany

返回值#

返回值(顺序)返回值类型返回值解释
r1http_struct.HttpOption

noredirect#

详细描述#

定义#

noredirect() http_struct.HttpOption

返回值#

返回值(顺序)返回值类型返回值解释
r1http_struct.HttpOption

params#

详细描述#

params 是一个请求选项参数,用于添加/指定 GET 参数,这会将参数进行 URL 编码

Example:

rsp, err = http.Get("http://www.yaklang.com", http.params("a=b"), http.params("c=d"))

定义#

params(i any) http_struct.HttpOption

参数#

参数名参数类型参数解释
iany

返回值#

返回值(顺序)返回值类型返回值解释
r1http_struct.HttpOption

postparams#

详细描述#

postparams 是一个请求选项参数,用于添加/指定 POST 参数,这会将参数进行 URL 编码

Example:

rsp, err = http.Post("http://www.yaklang.com", http.postparams("a=b"), http.postparams("c=d"))

定义#

postparams(i any) http_struct.HttpOption

参数#

参数名参数类型参数解释
iany

返回值#

返回值(顺序)返回值类型返回值解释
r1http_struct.HttpOption

proxy#

详细描述#

proxy 是一个请求选项参数,用于设置一个或多个请求的代理,请求时会根据顺序找到一个可用的代理使用

Example:

rsp, err = http.Get("http://www.yaklang.com", http.proxy("http://127.0.0.1:7890", "http://127.0.0.1:8083"))

定义#

proxy(values ...string) http_struct.HttpOption

参数#

参数名参数类型参数解释
values...string

返回值#

返回值(顺序)返回值类型返回值解释
r1http_struct.HttpOption

redirect#

详细描述#

redirect 是一个请求选项参数,它接收重定向处理函数,用于自定义重定向处理逻辑,返回 true 代表继续重定向,返回 false 代表终止重定向

重定向处理函数中第一个参数是当前的请求结构体引用,第二个参数是之前的请求结构体引用

Example:

rsp, err = http.Get("http://pie.dev/redirect/3", http.redirect(func(r, vias) bool { return true })

定义#

redirect(c func(r *http.Request, vias []*http.Request) bool) http_struct.HttpOption

参数#

参数名参数类型参数解释
cfunc(r *http.Request, vias []*http.Request) bool

返回值#

返回值(顺序)返回值类型返回值解释
r1http_struct.HttpOption

runtimeID#

详细描述#

定义#

runtimeID(value string) http_struct.HttpOption

参数#

参数名参数类型参数解释
valuestring

返回值#

返回值(顺序)返回值类型返回值解释
r1http_struct.HttpOption

save#

详细描述#

save 是一个请求选项参数,用于指定是否将此次请求的记录保存在数据库中,默认为true即会保存到数据库

Example:

http.Get("https://exmaple.com", http.save(true)) // 向 example.com 发起请求,会将此次请求保存到数据库中

定义#

save(value bool) http_struct.HttpOption

参数#

参数名参数类型参数解释
valuebool

返回值#

返回值(顺序)返回值类型返回值解释
r1http_struct.HttpOption

session#

详细描述#

session 是一个请求选项参数,用于根据传入的值指定会话,使用相同的值会使用同一个会话,同一个会话会自动复用 Cookie

Example:

rsp, err = http.Get("http://www.yaklang.com", http.session("request1"))

定义#

session(value any) http_struct.HttpOption

参数#

参数名参数类型参数解释
valueany

返回值#

返回值(顺序)返回值类型返回值解释
r1http_struct.HttpOption

show#

详细描述#

show 获取指定请求结构体引用或响应结构体引用的原始报文并输出在标准输出

Example:

req, err = http.NewRequest("GET", "http://www.yaklang.com", http.timeout(10))http.show(req)rsp, err = http.Do(req)http.show(rsp)

定义#

show(i any)

参数#

参数名参数类型参数解释
iany

showhead#

详细描述#

showhead 获取指定请求结构体引用或响应结构体引用的原始报文头部并输出在标准输出

Example:

req, err = http.NewRequest("GET", "http://www.yaklang.com", http.timeout(10))http.showhead(req)rsp, err = http.Do(req)http.showhead(rsp)

定义#

showhead(i any)

参数#

参数名参数类型参数解释
iany

source#

详细描述#

source 是一个请求选项参数,用于在请求记录保存到数据库时标识此次请求的来源

Example:

rsp, err = http.Get("https://exmaple.com", http.save(true), http.source("test")) // 向 example.com 发起请求,会将此次请求保存到数据库中,指示此次请求的来源为test

定义#

source(value string) http_struct.HttpOption

参数#

参数名参数类型参数解释
valuestring

返回值#

返回值(顺序)返回值类型返回值解释
r1http_struct.HttpOption

timeout#

详细描述#

WithTimeout 是一个请求选项参数,用于设置请求超时时间,单位是秒

Example:

rsp, err = http.Get("http://www.yaklang.com", http.WithTimeout(10))

定义#

timeout(f float64) http_struct.HttpOption

参数#

参数名参数类型参数解释
ffloat64

返回值#

返回值(顺序)返回值类型返回值解释
r1http_struct.HttpOption

ua#

详细描述#

useragent 是一个请求选项参数,用于指定请求的 User-Agent

Example:

rsp, err = http.Get("http://www.yaklang.com", http.ua("yaklang-http"))

定义#

ua(value any) http_struct.HttpOption

参数#

参数名参数类型参数解释
valueany

返回值#

返回值(顺序)返回值类型返回值解释
r1http_struct.HttpOption

uarand#

详细描述#

uarand 返回一个随机的 User-Agent

Example:

ua = http.uarand()

定义#

uarand() string

返回值#

返回值(顺序)返回值类型返回值解释
r1string

useragent#

详细描述#

useragent 是一个请求选项参数,用于指定请求的 User-Agent

Example:

rsp, err = http.Get("http://www.yaklang.com", http.ua("yaklang-http"))

定义#

useragent(value any) http_struct.HttpOption

参数#

参数名参数类型参数解释
valueany

返回值#

返回值(顺序)返回值类型返回值解释
r1http_struct.HttpOption