ea5436febb
- static.c: 新增 brotli_compress()，使用 libbrotlienc（质量 11，窗口 22） - static_serve_file(): 优先 Brotli，回退 Gzip，二进制文件跳过 - http.c: 解析 Accept-Encoding: br，http_request_t 新增 accept_brotli - cocoon.h: cocoon_config_t 新增 brotli_enabled（默认 true） - config.c/h: 解析 brotli_enabled JSON 字段，config_merge() 新增 has_brotli_enabled - main.c: --no-brotli 命令行选项 - server.c: 连接结构体新增 brotli_enabled - Makefile: 链接 -lbrotlienc - 单元测试: test_static.c 新增 4 个 Brotli 测试；test_config.c 新增 brotli 配置测试 - 集成测试: 新增 5 项 Brotli 测试（br 压缩、优先策略、图片不压缩） - cocoon.json: 添加 brotli_enabled 字段 - README: 更新特性描述、curl 示例、命令行参数、路线图 - 113 个单元测试全部通过，37 项集成测试全部通过
75 lines
2.0 KiB
C
75 lines
2.0 KiB
C
/**
|
||
* cocoon.h - Cocoon 公共头文件
|
||
*
|
||
* 定义错误码、配置结构体、函数声明。
|
||
*
|
||
* @author xfy
|
||
*/
|
||
|
||
#ifndef COCOON_H
|
||
#define COCOON_H
|
||
|
||
#include <stdint.h>
|
||
#include <stdbool.h>
|
||
#include <stddef.h>
|
||
|
||
#include "log.h"
|
||
|
||
#define COCOON_OK 0 /**< 成功 */
|
||
#define COCOON_ERROR -1 /**< 通用错误 */
|
||
#define COCOON_NOMEM -2 /**< 内存不足 */
|
||
#define COCOON_NOTFOUND -3 /**< 文件未找到 */
|
||
#define COCOONForbidden -4 /**< 禁止访问 */
|
||
#define COCOON_BADREQUEST -5 /**< 请求格式错误 */
|
||
|
||
/* === 服务器配置 === */
|
||
/**
|
||
* cocoon_config - 服务器配置结构体
|
||
*
|
||
* 命令行参数解析后的配置。
|
||
*/
|
||
typedef struct cocoon_config {
|
||
const char *root_dir; /**< 静态资源根目录 */
|
||
uint16_t port; /**< 监听端口 */
|
||
bool threaded; /**< 是否启用多线程调度 */
|
||
uint32_t num_workers; /**< 工作线程数（0 = 自动检测） */
|
||
uint32_t max_connections; /**< 最大并发连接数（0 = 无限制） */
|
||
uint32_t timeout_ms; /**< 连接空闲超时毫秒（0 = 默认30000） */
|
||
log_level_t log_level; /**< 日志级别 */
|
||
bool gzip_enabled; /**< 是否启用 gzip 压缩（默认 true） */
|
||
bool brotli_enabled; /**< 是否启用 brotli 压缩（默认 true） */
|
||
} cocoon_config_t;
|
||
|
||
/* === 服务器生命周期 API === */
|
||
/**
|
||
* cocoon_server_create - 创建服务器实例
|
||
*
|
||
* @param config 配置指针
|
||
* @return 服务器句柄，失败返回 NULL
|
||
*/
|
||
void *cocoon_server_create(const cocoon_config_t *config);
|
||
|
||
/**
|
||
* cocoon_server_run - 启动服务器（阻塞）
|
||
*
|
||
* @param server 服务器句柄
|
||
* @return COCOON_OK 成功，负值错误码
|
||
*/
|
||
int cocoon_server_run(void *server);
|
||
|
||
/**
|
||
* cocoon_server_stop - 优雅关闭服务器
|
||
*
|
||
* @param server 服务器句柄
|
||
*/
|
||
void cocoon_server_stop(void *server);
|
||
|
||
/**
|
||
* cocoon_server_destroy - 销毁服务器实例
|
||
*
|
||
* @param server 服务器句柄
|
||
*/
|
||
void cocoon_server_destroy(void *server);
|
||
|
||
#endif /* COCOON_H */
|