SuperAPI AI 工具集

zig-http

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:基于 Zig 标准库 std.http(Zig 0.16.0)进行 HTTP 客户端与服务端开发。

主要能力:HTTP 客户端请求(GET/POST/PUT/DELETE)、自定义请求头与请求体、查询参数、multipart 文件上传、底层细粒度请求控制;HTTP 服务端搭建与路由分发、JSON 响应、读取请求体;WebSocket 客户端与服务端;TLS/HTTPS 连接;连接池管理与压缩。

使用方式:客户端流程为初始化 std.http.Client{ .allocator = allocator }、配置请求、调用 client.fetch() 或底层 API、处理状态码与响应体、最后 client.deinit()。服务端使用 std.http.Server.init 并 listen 到地址,循环 accept 后通过 req.respond 返回响应。连接池用 client.pool.enable() 启用。WebSocket 通过 req.upgradeToWebSocket 升级。

前置要求:确认 Zig 版本(zig version);HTTPS 需系统有 CA 证书。

限制:std.http 在 0.16 中为实验性,API 可能变化;Client 必须 deinit;自行提供固定 buffer 时注意响应体溢出;HTTPS 在无 CA 环境可能需配置 server.ca_bundle;fetch() 高层 API 暂不支持超时,需用底层 API 控制;默认最大并发连接数 128;目前仅支持 HTTP/1.1,HTTP/2 计划中。非 HTTP 网络编程应使用 std.net,Zig 语言基础应使用 zig-0.16 技能。本技能不收集、存储或传输任何用户数据。