Send

<br/> >i 本文档的最新修订日期是: > **2020-12-27** # Send ## 模块简述 通过HTTP协议,以GET或POST方式发送数据。 ## 公共参数 * **<font color="#ff6600">`url(地址)`</font>** <font color="#0099ff">`(String)`</font> <font color="#BBBBBB">`默认值见方法参数`</font>: 用以指定向何处发送数据。 * **<font color="#ff6600">`data(数据)`</font>** <font color="#0099ff">`(类型见方法参数)`</font> <font color="#BBBBBB">`默认值见方法参数`</font>: 用以指定所发送的数据。 如果值为 <font color="#c7254e">`Array`</font> 类型时,键为字段名,值为字段对应的值,数据会自动进行URL编码。 发送JSON、XML等不应该进行URL编码的数据时,请传入 <font color="#c7254e">`String`</font> 类型的值(如果方法支持的话)。 * **<font color="#ff6600">`header(header)`</font>** <font color="#0099ff">`(Array)`</font> <font color="#BBBBBB">`默认值见方法参数`</font>: 用以指定需要发送的Header头,无需定义键,每一个Header中的字段作为一个元素。 * **<font color="#ff6600">`timeout(超时时间)`</font>** <font color="#0099ff">`(Int)`</font> <font color="#BBBBBB">`默认值见方法参数`</font>: 用以指定超时时间。 值的单位为秒(s)。 ## :: Post()方法 ### 语法 **<font color="#0099ff"><font color="#ff6600">Send</font> :: <font color="#ff6600">Post</font> ( <kbd>传参数组</kbd> )</font>** ### 说明 通过HTTP-POST方式向目标地址发送数据。 此方法 <font color="#c7254e">`支持`</font> 中文参数名。 ### 参数 * **<font color="#ff6600">`url(地址)`</font>** <font color="#0099ff">`(String)`</font> <font color="#BBBBBB">`<必须>`</font>: 详见本模块 <font color="#c7254e">`公共参数`</font> 部分的说明。 * **<font color="#ff6600">`data(数据)`</font>** <font color="#0099ff">`(Array | String)`</font> <font color="#BBBBBB">`<必须>`</font>: 详见本模块 <font color="#c7254e">`公共参数`</font> 部分的说明。 * **<font color="#ff6600">`header(header)`</font>** <font color="#0099ff">`(Array)`</font> <font color="#BBBBBB">`空数组`</font>: 详见本模块 <font color="#c7254e">`公共参数`</font> 部分的说明。 * **<font color="#ff6600">`timeout(超时时间)`</font>** <font color="#0099ff">`(Int)`</font> <font color="#BBBBBB">`15`</font>: 详见本模块 <font color="#c7254e">`公共参数`</font> 部分的说明。 ### 返回 <font color="#0099ff">`(String | Bool)`</font> 类型。 当目标地址对请求响应时,会返回String类型的目标地址的响应。 当服务器网络不畅,或目标地址超时响应时,可能返回空字符串或 <font color="#c7254e">`FALSE`</font> 。 ## :: Get()方法 ### 语法 **<font color="#0099ff"><font color="#ff6600">Send</font> :: <font color="#ff6600">Get</font> ( <kbd>传参数组</kbd> )</font>** ### 说明 通过HTTP-GET方式向目标地址发送数据。 此方法 <font color="#c7254e">`支持`</font> 中文参数名。 ### 参数 * **<font color="#ff6600">`url(地址)`</font>** <font color="#0099ff">`(String)`</font> <font color="#BBBBBB">`<必须>`</font>: 详见本模块 <font color="#c7254e">`公共参数`</font> 部分的说明。 * **<font color="#ff6600">`data(数据)`</font>** <font color="#0099ff">`(Array | String)`</font> <font color="#BBBBBB">`<必须>`</font>: 详见本模块 <font color="#c7254e">`公共参数`</font> 部分的说明。 * **<font color="#ff6600">`header(header)`</font>** <font color="#0099ff">`(Array)`</font> <font color="#BBBBBB">`空数组`</font>: 详见本模块 <font color="#c7254e">`公共参数`</font> 部分的说明。 * **<font color="#ff6600">`timeout(超时时间)`</font>** <font color="#0099ff">`(Int)`</font> <font color="#BBBBBB">`15`</font>: 详见本模块 <font color="#c7254e">`公共参数`</font> 部分的说明。 ### 返回 <font color="#0099ff">`(String | Bool)`</font> 类型。 当目标地址对请求响应时,会返回String类型的目标地址的响应。 当服务器网络不畅,或目标地址超时响应时,可能返回空字符串或 <font color="#c7254e">`FALSE`</font> 。 ## :: Posts()方法 ### 语法 **<font color="#0099ff"><font color="#ff6600">Send</font> :: <font color="#ff6600">Posts</font> ( <kbd>传参数组</kbd> )</font>** ### 说明 通过HTTP-POST方式,用cURL拓展向目标地址发送数据。 此方法 <font color="#c7254e">`支持`</font> 中文参数名。 与本模块中 <font color="#c7254e">`Post`</font> 方法不同的是,本方法可以向目标地址传送文件(二进制数据)。 在使用本方法发出的请求中,Content-Type始终为 <font color="#c7254e">`multipart/form-data`</font>; ### 参数 * **<font color="#ff6600">`url(地址)`</font>** <font color="#0099ff">`(String)`</font> <font color="#BBBBBB">`<必须>`</font>: 详见本模块 <font color="#c7254e">`公共参数`</font> 部分的说明。 * **<font color="#ff6600">`data(数据)`</font>** <font color="#0099ff">`(Array)`</font> <font color="#BBBBBB">`空数组`</font>: 详见本模块 <font color="#c7254e">`公共参数`</font> 部分的说明。 >w 请注意,本参数不支持 <font color="#c7254e">`String`</font> 类型的数据。 * **<font color="#ff6600">`file(文件)`</font>** <font color="#0099ff">`(Array)`</font> <font color="#BBBBBB">`空数组`</font>: 用以指定所发送的文件。 传入的数组的键为字段名,值为字段对应的文件的路径。 * **<font color="#ff6600">`header(header)`</font>** <font color="#0099ff">`(Array)`</font> <font color="#BBBBBB">`空数组`</font>: 详见本模块 <font color="#c7254e">`公共参数`</font> 部分的说明。 * **<font color="#ff6600">`timeout(超时时间)`</font>** <font color="#0099ff">`(Int)`</font> <font color="#BBBBBB">`15`</font>: 详见本模块 <font color="#c7254e">`公共参数`</font> 部分的说明。 ### 返回 <font color="#0099ff">`(String | Bool)`</font> 类型。 当目标地址对请求响应时,会返回String类型的目标地址的响应。 当服务器网络不畅,或目标地址超时响应时,可能返回空字符串或 <font color="#c7254e">`FALSE`</font> 。 >d 此方法依赖于 <font color="#c7254e">`cURL`</font> 拓展,请确保运行环境已安装并开启此与拓展。