---
url: /zh/api/scripts/extension-modules/net/http.md
---
# net.http

此模块提供http的各种操作支持，目前提供的接口如下：

## http.download

* 下载http文件

#### 函数原型

::: tip API

```lua
http.download(url: <string>, outputfile: <string>, opt: <table>)
```

:::

#### 参数说明

| 参数 | 描述 |
|------|------|
| url | 必需。要下载的URL地址 |
| outputfile | 必需。输出文件路径 |
| opt | 可选。选项参数，支持以下选项：- `headers` - HTTP头信息- `timeout` - 超时时间- `useragent` - 用户代理 |

#### 返回值说明

| 类型 | 描述 |
|------|------|
| boolean | 下载成功返回 true，失败返回 false |

#### 用法说明

这个接口比较简单，就是单纯的下载文件。

```lua
import("net.http")

http.download("https://xmake.io", "/tmp/index.html")
```