Send


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