快速开始

📌 平台支持

当前支持: Linux

未来计划: macOS, Windows, FreeBSD, WebAssembly (WASM) 和其他 Unix-like 系统

UVHTTP 目前针对 Linux 平台进行了优化。我们计划在未来版本中扩展对其他操作系统和平台的支持。

环境要求

• CMake 3.10+
• C99 编译器（GCC 4.9+, Clang 3.5+）
• libuv 1.x
• llhttp

安装

从源码编译

# 克隆仓库（包含子模块）
git clone --recurse-submodules https://github.com/adam-ikari/uvhttp.git
cd uvhttp

# 构建项目
make build

# 运行测试（可选）
make test

安装依赖

Ubuntu/Debian

sudo apt-get update
sudo apt-get install -y cmake build-essential

macOS（未来支持）

brew install cmake

Windows（未来支持）

使用 vcpkg 安装依赖：

vcpkg install libuv

第一个程序

创建 hello.c：

#include <uvhttp.h>
#include <stdio.h>
#include <string.h>

int hello_handler(uvhttp_request_t* request, uvhttp_response_t* response) {
    uvhttp_response_set_status(response, 200);
    uvhttp_response_set_header(response, "Content-Type", "text/plain");
    uvhttp_response_set_body(response, "Hello, World!", strlen("Hello, World!"));
    return uvhttp_response_send(response);
}

int main() {
    uv_loop_t* loop = uv_default_loop();
    uvhttp_server_t* server = NULL;
    uvhttp_server_new(loop, &server);
    uvhttp_router_t* router = NULL;
    uvhttp_router_new(&router);
    uvhttp_server_set_router(server, router);

    // 添加路由
    uvhttp_router_add_route(router, "/", hello_handler);

    // 启动服务器
    uvhttp_error_t result = uvhttp_server_listen(server, "0.0.0.0", 8080);
    if (result != UVHTTP_OK) {
        fprintf(stderr, "Failed to start server: %s\n", uvhttp_error_string(result));
        return 1;
    }

    printf("Server running at http://localhost:8080\n");
    uv_run(loop, UV_RUN_DEFAULT);

    return 0;
}

编译

gcc -o hello hello.c -I./include -L./build/dist/lib -luvhttp -luv -lpthread

运行

./hello

访问 http://localhost:8080 查看 "Hello, World!"。

项目结构

uvhttp/
├── include/           # 公共头文件
├── src/              # 源代码实现
├── docs/             # 文档
├── examples/         # 示例程序
├── test/             # 测试
└── build/            # 构建输出目录

配置选项

可通过修改 CMakeLists.txt 中的 option() 配置编译选项，然后运行 make build：

# 修改 CMakeLists.txt 中的选项后构建
make build

下一步

• API 文档 - 学习完整的 API

需要帮助？

• 查阅文档
• 打开 Issue
• 加入 GitHub 讨论